GitLab-integratiehandleiding

Om GitLab te gebruiken voor het codeondertekeningsproces, moet je een runner instellen met Signtool, ECSigningKSP en een GitLab-account. Hieronder de vereisten:

  1. Zelf-gehoste runner, met ECSigning KSP en Signtool geïnstalleerd en geconfigureerd. Deze runner moet beheerdersrechten hebben.
  2. Een GitLab-account.

Om ECSigningKSP en Signtool in te stellen, gaat u naar sectie 11.2. Volg daarna de onderstaande stappen:

  1. Maak een GitLab-account aan. Navigeer naar 'Nieuw leeg project maken'.

  2. Scroll naar beneden naar Instellingen -> CI/CD en navigeer naar de runner. Vouw deze uit.

    Loper
  3. Installeer GitLab Runner op uw apparaat met behulp van de linkDeze link is voor Windows. U kunt hier kijken link om te zien welke stappen u moet volgen om het op uw specifieke apparaat te installeren.
  4. Je kunt het volgen documentatie om uw hardloper in te stellen en te registreren op uw apparaat.

Om een ​​loper te registreren onder Windows:

  1. Voer het volgende commando uit:

    .exe register
  2. Voer de URL van uw GitLab-instantie in (ook wel de URL van de GitLab CI-coördinator genoemd). Bijvoorbeeld: https://gitlab.com
  3. Voer het token in dat je hebt gekregen om de runner te registreren. Je kunt dit doen via Instellingen -> CI/CD -> Uitvouwen -> Projectrunners. Onder de projectrunners vind je het token.
  4. Voer een beschrijving in voor de runner. Je kunt deze waarde later wijzigen in de GitLab-gebruikersinterface. Voorbeeld: Apparaat
  5. Voer de tags die aan de hardloper zijn gekoppeld, gescheiden door komma's. U kunt deze waarde later wijzigen in de GitLab-gebruikersinterface. Voorbeeld: WindowsRunner
  6. Voer eventuele onderhoudsnotities voor de hardloper in.
  7. Lever de runner-uitvoerderWij gebruiken dit bij Shell.

Zodra de runner is geïnstalleerd en geconfigureerd, navigeer je naar de services op je apparaat, scrol je naar beneden naar GitLab Runner en log je in als beheerder. Geef hier je beheerderswachtwoord op.

Eigenschappen van de loper

Zodra dit is gebeurd, ga je naar je project. Mogelijk moet je het .ym-bestand hernoemen naar .gitlab-ci.yml.

Deze pijplijn bestaat uit drie secties.

  1. Tags

    De tags die u hebt opgegeven tijdens het instellen van de hardloper

  2. Variabelen

    • EC_Client_Auth:Komt overeen met het pad van uw SSL-authenticatiecertificaat, dat kan worden aangemaakt via CodeSignSecure.
    • EC_Client_Pass: Komt overeen met het wachtwoord voor uw certificaat, dat u hebt opgegeven bij het aanmaken van het certificaat.

  3. Script

    • Geef de opdracht signtool om een ​​bestand te ondertekenen.
    • Hieronder vindt u een voorbeeld van een script waarmee u code kunt ondertekenen. 
      • job1: tags: - shell-variabelen: EC_Client_Auth: C:\Users\riley\Documents\EncryptionConsulting\Test_demo.pfx EC_Client_Pass: c74c5b7db312 script: - signtool sign /csp "Encryption Consulting Key Storage provider" /kc Test_aryan90 /fd SHA256 /f "C:\Users\riley\Desktop\gitlab\Test_aryan90.pem" /tr http://timestamp.digicert.com /td SHA256 "C:\Users\riley\Desktop\agent.exe"
Script

Als u op Bouwen -> Taken klikt, ziet u dat de ondertekening succesvol is.

Job

U moet de opdracht aanpassen aan uw variabelen.

  • kc: vervang evcodesiging met uw sleutelnaam
  • F: vervang locatie door de locatie van uw .pem-bestand om codesigning uit te voeren. U kunt dit verkrijgen door KSP te ondertekenen. Ga vanaf de opdrachtprompt naar de directory met SigningKSP. Gebruik de opdracht ECGetCert.ece om het PEM-bestand van uw certificaat op te halen.
  • tr http://timestamp.digicert.com: tijdstempelserver
  • td SHA256: locatie van het bestand dat u wilt laten ondertekenen.