GitLab-integrationsguide

Att använda Gitlab för kodsigneringsprocessen kräver att du konfigurerar en runner som har Signtool, ECSigningKSP och ett GitLab-konto. Här är förkunskapskraven:

  1. Självhostad Runner, som har ECSigning KSP, Signtool installerat och konfigurerat. Denna runner bör ha administratörsbehörighet.
  2. Ett GitLab-konto.

För att konfigurera ECSigningKSP och Signtool, gå till avsnitt 11.2. Följ sedan stegen nedan:

  1. Skapa ett GitLab-konto. GÃ¥ till att skapa ett nytt tomt projekt.

  2. Scrolla ner till inställningar -> CI/CD och navigera till runnern. Expandera den.

    Löpare
  3. Installera GitLab runner på din enhet med hjälp av länkDen här länken är för Windows. Du kan titta på den här länk för att se stegen för att installera det på din specifika enhet.
  4. Du kan följa dokumentation för att ställa in din löpare och registrera den enligt din enhet.

För att registrera en löpare i Windows:

  1. Kör följande kommando:

    .exe-register
  2. Ange din GitLab-instans-URL (även känd som GitLab CI-koordinator-URL). Exempel: https://gitlab.com
  3. Ange den token du fick för att registrera löparen. Du kommer åt den från inställningar -> CI/CD -> Expandera -> Projektlöpare. Under projektlöparna hittar du token.
  4. Ange en beskrivning för löparen. Du kan ändra detta värde senare i GitLabs användargränssnitt. Exempel: Enhet
  5. Ange taggar associerade med löparen, separerade med kommatecken. Du kan ändra detta värde senare i GitLabs användargränssnitt. Exempel: WindowsRunner
  6. Ange eventuell valfri underhållsanteckning för löparen.
  7. Ge löpande exekutorVi kör detta på Shell.

När löparen är installerad och konfigurerad, navigera till tjänster på din enhet, scrolla ner till GitLab Runner och logga in som administratör. Ange administratörslösenordet här.

Löparegenskaper

När detta är klart, gå till ditt projekt. Du kan behöva byta namn på .ym-filen. Byt namn på den till .gitlab-ci.yml.

Det finns tre sektioner i denna pipeline.

  1. Taggar

    Taggarna du angav när du konfigurerade löparen

  2. variabler

    • EC_Client_AuthMotsvarar sökvägen till ditt SSL-autentiseringscertifikat, vilket kan skapas frÃ¥n CodeSignSecure.
    • EC_Client_PassMotsvarar lösenordet för ditt certifikat, vilket du angav när certifikatet skapades.

  3. Script

    • Ange kommandot signtool för att signera en fil.
    • Ett exempelskript för att utföra kodsignering ges nedan. 
      • job1: taggar: - shellvariabler: EC_Client_Auth: C:\Användare\riley\Dokument\EncryptionConsulting\Test_demo.pfx EC_Client_Pass: c74c5b7db312 script: - signtool signera /csp "Krypteringskonsulttjänst för nyckellagring" /kc Test_aryan90 /fd SHA256 /f "C:\Användare\riley\Desktop\gitlab\Test_aryan90.pem" /tr http://timestamp.digicert.com /td SHA256 "C:\Användare\riley\Desktop\agent.exe"
Script

Om du klickar på Bygg -> Jobb ser du att det har signerats.

Jobb

Du måste modifiera kommandot enligt dina variabler.

  • kcersätt evcodesiging med ditt nyckelnamn
  • fErsätt platsen med platsen för din .pem-fil för att utföra samdesign. Du kan fÃ¥ detta genom att signera KSP. FrÃ¥n kommandotolken, nÃ¥ katalogen med SigningKSP. Använd kommandot ECGetCert.ece för att hämta ditt certifikats PEM-fil.
  • tr http://timestamp.digicert.comtidsstämplingsserver
  • td SHA256: platsen för filen du vill signera.