Comment intégrer eSigner CKA avec les outils CI/CD pour la signature de code automatisée

Exemple de flux de travail de signature .vsix

# Le nom du flux de travail.
Nom : Artefact de signe

# Déclenchez ce workflow sur un push
activé : appuyez sur

# Créer une variable d'environnement
env :
MASTER_KEY : clé.maître
SIGNABLE_FILE_PATH : HelloWorld.dll
SIGNABLE_VSIX_FILE_PATH : SSLcom.vsix
INSTALL_DIR : C:\Users\runneradmin\eSignerCKA
MASTER_KEY_FILE : C:\Users\runneradmin\eSignerCKA\master.key

emplois:
# Définit le travail nommé « sign-file »
signe-fichier :
# Exécuter le travail sur Windows Runner
s'exécute sur : les dernières fenêtres
# Lorsque le workflow s'exécute, c'est le nom qui est enregistré
nom : Signer le fichier DLL avec eSignerCKA

étapes:
# 1) Vérifiez le code source afin que le workflow puisse y accéder.
– nom : Référentiel de paiement
utilise : actions/checkout@v3

# 2) Téléchargez et décompressez la configuration d'eSignerCKA
– nom : Télécharger et décompresser la configuration eSignerCKA
exécutez : |
Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip « https://github.com/SSLcom/eSignerCKA/releases/download/v1.0.6/SSL.COM-eSigner-CKA_1.0.6.zip »
Développez-Archive -Force eSigner_CKA_Setup.zip
Supprimer l'élément eSigner_CKA_Setup.zip
Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »

# 3) Installez eSignerCKA
– nom : Configurer eSignerCKA en mode silencieux
exécutez : |
Nouvel élément -ItemType Directory -Force -Path ${{ env.INSTALL_DIR }}
./eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”${{ env.INSTALL_DIR }}” | Hors-Nul

# 4) Définir les informations du compte SSLcom
- nom : informations de compte de configuration sur eSignerCKA
exécutez : |
${{ env.INSTALL_DIR }}/eSignerCKATool.exe config -mode "${{ secrets.MODE }}" -user "${{ secrets.USERNAME }}" -pass "${{ secrets.PASSWORD }}" - totp "${{ secrets.TOTP_SECRET }}" -key "${{ env.MASTER_KEY_FILE }}" -r

# 5) Décharger et charger le certificat dans le magasin de certificats Windows
– nom : charger le certificat dans le Windows Store
exécutez : |
Déchargement de ${{ env.INSTALL_DIR }}/eSignerCKATool.exe
chargement de ${{ env.INSTALL_DIR }}/eSignerCKATool.exe

# 6) Sélectionnez le certificat de signature de code et obtenez l'empreinte digitale pour la signature
- nom : sélectionnez le certificat dans le Windows Store
exécutez : |
$CodeSigningCert = Get-ChildItem Cert :\CurrentUser\My -CodeSigningCert | Sélectionner-Objet -Premier 1
echo "THUMBPRINT=$($CodeSigningCert.Thumbprint)" >> $env:GITHUB_ENV

# 7) Signer l'artefact avec signtool
– nom : signer un exemple de fichier avec SignTool
exécutez : |
& 'C:/Program Files (x86)/Windows Kits/10/bin/10.0.22621.0/x86/signtool.exe' signe /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 ${{ env.THUMBPRINT }} ${{ env.SIGNABLE_FILE_PATH }}

# 8) Télécharger les journaux eSignerCKA
– nom : Télécharger les journaux eSignerCKA
utilise : actions/upload-artifact@v3
si : ${{ toujours() }}
avec:
nom : eSignerCKA-Logs-DLL
chemin : C:\Users\runneradmin\AppData\Roaming\eSignerCKA\KSP

# Définit le travail nommé « sign-vsix-file »
fichier sign-vsix :
# Exécuter le travail sur Windows Runner
s'exécute sur : les dernières fenêtres
# Lorsque le workflow s'exécute, c'est le nom qui est enregistré
nom : Signer le fichier VSIX avec eSignerCKA
étapes:
# 1) Vérifiez le code source afin que le workflow puisse y accéder.
– nom : Référentiel de paiement
utilise : actions/checkout@v3

# 2) Configurez l'environnement .NET CLI pour le flux de travail à utiliser.
– nom : Configuration de Dotnet Core
exécutez : |
choco installer dotnet-runtime -y

# 3) Téléchargez et décompressez la configuration d'eSignerCKA
– nom : Télécharger et décompresser la configuration eSignerCKA
exécutez : |
Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip « https://github.com/SSLcom/eSignerCKA/releases/download/v1.0.6/SSL.COM-eSigner-CKA_1.0.6.zip »
Développez-Archive -Force eSigner_CKA_Setup.zip
Supprimer l'élément eSigner_CKA_Setup.zip
Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »

# 4) Installez eSignerCKA
– nom : Configurer eSignerCKA en mode silencieux
exécutez : |
Nouvel élément -ItemType Directory -Force -Path ${{ env.INSTALL_DIR }}
./eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”${{ env.INSTALL_DIR }}” | Hors-Nul

# 5) Définir les informations du compte SSLcom
- nom : informations de compte de configuration sur eSignerCKA
exécutez : |
${{ env.INSTALL_DIR }}/eSignerCKATool.exe config -mode "${{ secrets.MODE }}" -user "${{ secrets.USERNAME }}" -pass "${{ secrets.PASSWORD }}" - totp "${{ secrets.TOTP_SECRET }}" -key "${{ env.MASTER_KEY_FILE }}" -r

# 6) Décharger et charger le certificat dans le magasin de certificats Windows
– nom : charger le certificat dans le Windows Store
exécutez : |
Déchargement de ${{ env.INSTALL_DIR }}/eSignerCKATool.exe
chargement de ${{ env.INSTALL_DIR }}/eSignerCKATool.exe

# 7) Sélectionnez le certificat de signature de code et obtenez l'empreinte digitale pour la signature
- nom : sélectionnez le certificat dans le Windows Store
exécutez : |
$CodeSigningCert = Get-ChildItem Cert :\CurrentUser\My -CodeSigningCert | Sélectionner-Objet -Premier 1
echo "THUMBPRINT=$($CodeSigningCert.Thumbprint)" >> $env:GITHUB_ENV

# 8) Installez OpenVsixSignTool dans un emplacement personnalisé (https://github.com/vcsjones/OpenOpcSignTool)
– nom : Installer OpenOpcSignTool
exécutez : |
New-Item -ItemType Directory -Force -Path C:\Users\runneradmin\Desktop\dotnet-tools
Invoke-WebRequest -OutFile OpenVsixSignTool.zip https://github.com/SSLcom/eSignerCKA/releases/download/v1.0.4/OpenVsixSignTool_1.0.0-x86.zip
Move-Item -Chemin OpenVsixSignTool.zip -Destination C:\Users\runneradmin\Desktop\dotnet-tools\OpenVsixSignTool.zip
Expand-Archive -LiteralPath C:\Users\runneradmin\Desktop\dotnet-tools\OpenVsixSignTool.zip -DestinationPath C:\Users\runneradmin\Desktop\dotnet-tools -Force

# 9) Signer l'artefact avec OpenOpcSignTool
– nom : Signer un exemple de fichier avec OpenVsixSignTool
exécutez : |
C:\Users\runneradmin\Desktop\dotnet-tools\OpenVsixSignTool –roll-forward LatestMajor sign –sha1 ${{ env.THUMBPRINT }} –timestamp http://ts.ssl.com -ta sha256 -fd sha256 « ${ { env.SIGNABLE_VSIX_FILE_PATH }} »

# 10) Télécharger les journaux eSignerCKA
– nom : Télécharger les journaux eSignerCKA
utilise : actions/upload-artifact@v3
si : ${{ toujours() }}
avec:
nom : eSignerCKA-Logs-VSIX
chemin : C:\Users\runneradmin\AppData\Roaming\eSignerCKA\KSP

Exemple de flux de travail de signature .vsix

# Déclencheurs d'intégration continue
déclencheur:
- aucun

# Regroupe les travaux en étapes. Toutes les tâches d'une étape doivent être terminées avant que l'étape suivante ne soit exécutée.
étapes:
– scène : signe
# Lorsque le workflow s'exécute, c'est le nom qui est enregistré
displayName : Fichier de signature
emplois:
- travail:
bassin:
# Exécuter le travail sur les VM Windows
vmImage: 'windows-dernier'
étapes:
# Téléchargez et décompressez la configuration eSignerCKA
– PowerShell : |
Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip "https://www.ssl.com/download/ssl-com-esigner-cka"
Développez-Archive -Force eSigner_CKA_Setup.zip
Supprimer l'élément eSigner_CKA_Setup.zip
Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »
displayName : 'Télécharger et décompresser la configuration d'eSignerCKA'

# Configurez eSignerCKA en mode silencieux et vérifiez le répertoire d'installation
– PowerShell : |
./eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”$(Build.BinariesDirectory)\Desktop\eSignerCKA” | Hors-Nul
rép $(Build.BinariesDirectory)\Desktop\eSignerCKA
Get-ChildItem -Path $(Build.BinariesDirectory)\Desktop\eSignerCKA
displayName : 'Configurer eSignerCKA en mode silencieux'

# Configurer les informations de compte sur eSignerCKA
– PowerShell : |
$(Build.BinariesDirectory)\Desktop\eSignerCKA\eSignerCKATool.exe config -mode $(MODE) -user « $(USERNAME) » -pass « $(PASSWORD) » -totp « $(TOTP_SECRET) » -key « $( Build.BinariesDirectory)\Desktop\eSignerCKA\master.key” -r
displayName : 'Informations sur le compte de configuration sur eSignerCKA'

# Décharger et charger le certificat dans le Windows Store
– PowerShell : |
Déchargement de $(Build.BinariesDirectory)\Desktop\eSignerCKA\eSignerCKATool.exe
Chargement de $(Build.BinariesDirectory)\Desktop\eSignerCKA\eSignerCKATool.exe
displayName : 'Décharger et charger le certificat dans le Windows Store'

# Sélectionnez le certificat dans le Windows Store et signez un exemple de fichier avec SignTool
– PowerShell : |
$CodeSigningCert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Sélectionner-Objet -Premier 1 ; echo $CodeSigningCert.Thumbprint > .Thumbprint
Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); echo $Empreinte du pouce
& « C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\signtool.exe » signe /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 $Thumbprint HelloWorld.dll
displayName : 'Signer un exemple de fichier avec SignTool'

# Enregistrer l'artefact afin d'utiliser le travail de signature
– tâche : PublishBuildArtifacts@1
displayName : 'Enregistrer l'artefact signé pour le téléchargement'
contributions:
chemin vers la publication : HelloWorld.dll
Nomartefact : HelloWorld.dll

– étape : sign_vsix
# Lorsque le workflow s'exécute, c'est le nom qui est enregistré
displayName : signe VSIX
emplois:
- travail:
bassin:
# Exécuter le travail sur les VM Windows
vmImage: 'windows-dernier'
étapes:
# Téléchargez et décompressez la configuration eSignerCKA
– PowerShell : |
Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip "https://www.ssl.com/download/ssl-com-esigner-cka"
Développez-Archive -Force eSigner_CKA_Setup.zip
Supprimer l'élément eSigner_CKA_Setup.zip
Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »
displayName : 'Télécharger et décompresser la configuration d'eSignerCKA'

# Configurez eSignerCKA en mode silencieux et vérifiez le répertoire d'installation
– PowerShell : |
./eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”$(Build.BinariesDirectory)\Desktop\eSignerCKA” | Hors-Nul
rép $(Build.BinariesDirectory)\Desktop\eSignerCKA
Get-ChildItem -Path $(Build.BinariesDirectory)\Desktop\eSignerCKA
displayName : 'Configurer eSignerCKA en mode silencieux'

# Configurer les informations de compte sur eSignerCKA
– PowerShell : |
$(Build.BinariesDirectory)\Desktop\eSignerCKA\eSignerCKATool.exe config -mode $(MODE) -user « $(USERNAME) » -pass « $(PASSWORD) » -totp « $(TOTP_SECRET) » -key « $( Build.BinariesDirectory)\Desktop\eSignerCKA\master.key” -r
displayName : 'Informations sur le compte de configuration sur eSignerCKA'

# Décharger et charger le certificat dans le Windows Store
– PowerShell : |
Déchargement de $(Build.BinariesDirectory)\Desktop\eSignerCKA\eSignerCKATool.exe
Chargement de $(Build.BinariesDirectory)\Desktop\eSignerCKA\eSignerCKATool.exe
displayName : 'Décharger et charger le certificat dans le Windows Store'

# Installez OpenVsixSignTool dans un emplacement personnalisé (https://github.com/vcsjones/OpenOpcSignTool)
– PowerShell : |
New-Item -ItemType Répertoire -Force -Path $(Build.BinariesDirectory)\Desktop\eSignerCKA\dotnet-tools
Invoke-WebRequest -OutFile OpenVsixSignTool.zip https://github.com/SSLcom/eSignerCKA/releases/download/v1.0.4/OpenVsixSignTool_1.0.0-x86.zip
Move-Item -Chemin OpenVsixSignTool.zip -Destination $(Build.BinariesDirectory)\Desktop\eSignerCKA\dotnet-tools\OpenVsixSignTool.zip
Expand-Archive -LiteralPath $(Build.BinariesDirectory)\Desktop\eSignerCKA\dotnet-tools\OpenVsixSignTool.zip -DestinationPath $(Build.BinariesDirectory)\Desktop\eSignerCKA\dotnet-tools -Force
displayName : 'Installer OpenVsixSignTool dans un emplacement personnalisé'

# Sélectionnez le certificat dans le Windows Store et signez un exemple de fichier avec OpenOpcSignTool
– PowerShell : |
$CodeSigningCert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Sélectionner-Objet -Premier 1 ; echo $CodeSigningCert.Thumbprint > .Thumbprint
Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); echo $Empreinte du pouce
$(Build.BinariesDirectory)\Desktop\eSignerCKA\dotnet-tools\OpenVsixSignTool –roll-forward LatestMajor sign –sha1 $Thumbprint –timestamp http://ts.ssl.com -ta sha256 -fd sha256 SSLcom.vsix
displayName : 'Signer un exemple de fichier avec OpenOpcSignTool'

# Enregistrer l'artefact afin d'utiliser le travail de signature
– tâche : PublishBuildArtifacts@1
displayName : 'Enregistrer l'artefact signé pour le téléchargement'
contributions:
chemin vers la publication : SSLcom.vsix
Nom de l'artefact : SSLcom.vsix

# Coureur Windows
.windows_runners :
# Utilisé pour sélectionner les coureurs dans la liste des coureurs disponibles. Un exécuteur doit avoir toutes les balises répertoriées ici pour exécuter le travail.
tags:
– fenêtres partagées
- les fenêtres
– fenêtres-1809

# Regroupe les travaux en étapes. Toutes les tâches d'une étape doivent être terminées avant que l'étape suivante ne soit exécutée.
étapes:
- pancarte

# Ci-dessous la définition de votre travail pour signer un fichier
signe-fichier :
# Définissez à quelle étape le travail sera exécuté.
scène : signe
# Runner pour le fichier de signature sous Windows
s'étend :
– .windows_runners
avant_script :
# Créer un répertoire d'installation
– New-Item -ItemType Directory -Force -Path C:\Users\gitlab_runner\Desktop\eSignerCKA
script:
# Téléchargez et décompressez la configuration eSignerCKA
– Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip « https://www.ssl.com/download/ssl-com-esigner-cka »
– Développer-Archive -Force eSigner_CKA_Setup.zip
– Supprimer l'élément eSigner_CKA_Setup.zip
– Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »
# Configurer eSignerCKA en mode silencieux
– ./eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”C:\Users\gitlab_runner\Desktop\eSignerCKA” | Hors-Nul
# Vérifier le répertoire d'installation
– répertoire C:\Users\gitlab_runner\Desktop\eSignerCKA
# Vérifier le répertoire d'installation
– Get-ChildItem -Path C:\Users\gitlab_runner\Desktop\eSignerCKA
# Configurer les informations de compte sur eSignerCKA
– C:\Users\gitlab_runner\Desktop\eSignerCKA\eSignerCKATool.exe config -mode ${MODE} -user "${USERNAME}" -pass "${PASSWORD}" -totp "${TOTP_SECRET}" -key "C :\Users\gitlab_runner\AppData\Roaming\eSignerCKA\master.key” -r
# Décharger le certificat dans le Windows Store
– Déchargement de C:\Users\gitlab_runner\Desktop\eSignerCKA\eSignerCKATool.exe
# Charger le certificat dans le Windows Store
– Chargement de C:\Users\gitlab_runner\Desktop\eSignerCKA\eSignerCKATool.exe
# Vérifier le répertoire de données
– répertoire C:\Users\gitlab_runner\AppData\Roaming\eSignerCKA
# Vérifier le répertoire des données de configuration
– répertoire C:\Users\gitlab_runner\AppData\Roaming\eSignerCKA\Config
# Sélectionnez le certificat dans le Windows Store
– $CodeSigningCert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Sélectionner-Objet -Premier 1 ; echo $CodeSigningCert.Thumbprint > .Thumbprint
# Empreinte numérique du certificat de débogage
– Set-Variable-Name Thumbprint-Value (Get-Content .Thumbprint) ; echo $Empreinte du pouce
# Signer un exemple de fichier avec SignTool
– powershell.exe -ExecutionPolicy Bypass -Command « Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint) ; 'C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\signtool.exe sign /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 $Thumbprint HelloWorld.dll'"

# Ci-dessous la définition de votre travail pour signer un fichier
signe-vsix :
# Définissez à quelle étape le travail sera exécuté.
scène : signe
# Runner pour le fichier de signature sous Windows
s'étend :
– .windows_runners
avant_script :
# Créer un répertoire d'installation
– New-Item -ItemType Directory -Force -Path C:\Users\gitlab_runner\Desktop\eSignerCKA
script:
# Téléchargez et décompressez la configuration eSignerCKA
– Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip « https://www.ssl.com/download/ssl-com-esigner-cka »
– Développer-Archive -Force eSigner_CKA_Setup.zip
– Supprimer l'élément eSigner_CKA_Setup.zip
– Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »
# Configurer eSignerCKA en mode silencieux
– ./eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”C:\Users\gitlab_runner\Desktop\eSignerCKA” | Hors-Nul
# Vérifier le répertoire d'installation
– répertoire C:\Users\gitlab_runner\Desktop\eSignerCKA
# Vérifier le répertoire d'installation
– Get-ChildItem -Path C:\Users\gitlab_runner\Desktop\eSignerCKA
# Configurer les informations de compte sur eSignerCKA
– C:\Users\gitlab_runner\Desktop\eSignerCKA\eSignerCKATool.exe config -mode ${MODE} -user "${USERNAME}" -pass "${PASSWORD}" -totp "${TOTP_SECRET}" -key "C :\Users\gitlab_runner\AppData\Roaming\eSignerCKA\master.key” -r
# Décharger le certificat dans le Windows Store
– Déchargement de C:\Users\gitlab_runner\Desktop\eSignerCKA\eSignerCKATool.exe
# Charger le certificat dans le Windows Store
– Chargement de C:\Users\gitlab_runner\Desktop\eSignerCKA\eSignerCKATool.exe
# Vérifier le répertoire de données
– répertoire C:\Users\gitlab_runner\AppData\Roaming\eSignerCKA
# Vérifier le répertoire des données de configuration
– répertoire C:\Users\gitlab_runner\AppData\Roaming\eSignerCKA\Config
# Sélectionnez le certificat dans le Windows Store
– $CodeSigningCert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Sélectionner-Objet -Premier 1 ; echo $CodeSigningCert.Thumbprint > .Thumbprint
# Empreinte numérique du certificat de débogage
– Set-Variable-Name Thumbprint-Value (Get-Content .Thumbprint) ; echo $Empreinte du pouce
# Installer Dotnet Runtime 7.0
– choco install dotnet-runtime -y
# Installez OpenVsixSignTool dans un emplacement personnalisé
– New-Item -ItemType Directory -Force -Path C:\Users\gitlab_runner\Desktop\dotnet-tools
– Invoke-WebRequest -OutFile OpenVsixSignTool.zip https://github.com/SSLcom/eSignerCKA/releases/download/v1.0.4/OpenVsixSignTool_1.0.0-x86.zip
– Move-Item -Path OpenVsixSignTool.zip -Destination C:\Users\gitlab_runner\Desktop\dotnet-tools\OpenVsixSignTool.zip
– Expand-Archive -LiteralPath C:\Users\gitlab_runner\Desktop\dotnet-tools\OpenVsixSignTool.zip -DestinationPath C:\Users\gitlab_runner\Desktop\dotnet-tools -Force
# Signer un exemple de fichier avec OpenVsixSignTool
– powershell.exe -ExecutionPolicy Bypass -Command 'Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); C:\Users\gitlab_runner\Desktop\dotnet-tools\OpenVsixSignTool –roll-forward LatestMajor sign –sha1 $Thumbprint –timestamp http://ts.ssl.com -ta sha256 -fd sha256 « SSLcom.vsix »'

Exemple de flux de travail de signature de DLL de code .vsix

# L'architecture CPU sur laquelle exécuter le travail
arc : amd64

# Langue par défaut dans laquelle exécuter les tests
langue: csharp

# La distribution Ubuntu à utiliser
dist : bionique

# Le système d'exploitation sur lequel exécuter le travail
os: fenêtres

# Spécifie l'ordre des étapes de construction. Toutes les tâches d'une étape doivent être terminées avant que l'étape suivante ne soit exécutée.
étapes:
- pancarte

emplois:
consistent à
– scène : signe
# Le nom du travail
nom : fichier de signature
# Le système d'exploitation sur lequel exécuter le travail
os: fenêtres
# Utiliser la langue générique par défaut
langue : c
# Avant le script à exécuter avant de construire le projet
avant_script :
# Créer un répertoire d'installation
– powershell.exe -ExecutionPolicy Bypass -Command 'New-Item -ItemType Directory -Force -Path C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom'
# Script pour construire le projet
script:
# Téléchargez et décompressez la configuration eSignerCKA
– powershell.exe -ExecutionPolicy Bypass -Command 'Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip "https://www.ssl.com/download/ssl-com-esigner-cka"'
– powershell.exe -ExecutionPolicy Bypass -Command 'Expand-Archive -Force eSigner_CKA_Setup.zip'
– powershell.exe -ExecutionPolicy Bypass -Command 'Remove-Item eSigner_CKA_Setup.zip'
– powershell.exe -ExecutionPolicy Bypass -Command 'Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »'
# Configurer eSignerCKA en mode silencieux
– powershell.exe -ExecutionPolicy Bypass -Command './eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom” | Hors-Nul'
# Vérifier le répertoire d'installation
– powershell.exe -ExecutionPolicy Bypass -Command 'dir C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom'
# Configurer les informations de compte sur eSignerCKA
– powershell.exe -ExecutionPolicy Bypass -Command 'C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\eSignerCKATool.exe config -mode ${MODE} -user "${USERNAME}" -pass "${ MOT DE PASSE}" -totp "${TOTP_SECRET}" -key "C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\master.key" -r'
# Décharger le certificat dans le Windows Store
– powershell.exe -ExecutionPolicy Bypass -Command 'C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\eSignerCKATool.exe décharger'
# Charger le certificat dans le Windows Store
– powershell.exe -ExecutionPolicy Bypass -Command 'C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\eSignerCKATool.exe charger'
# Sélectionnez le certificat dans le Windows Store
– powershell.exe -ExecutionPolicy Bypass -Command '$CodeSigningCert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Select-Object -Premier 1 ; echo $CodeSigningCert.Empreinte > .Empreinte'
# Empreinte numérique du certificat de débogage
– powershell.exe -ExecutionPolicy Bypass -Command 'Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); echo $Empreinte'
# Signer un exemple de fichier avec SignTool
– powershell.exe -ExecutionPolicy Bypass -Command "Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); 'C:\Program Files (x86)\Windows Kits\10\bin\x86\signtool.exe sign /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 $Thumbprint HelloWorld.dll' ”

– scène : signe
# Le nom du travail
nom : signe-vsix
# Le système d'exploitation sur lequel exécuter le travail
os: fenêtres
# Utiliser la langue générique par défaut
langue : c
# Avant le script à exécuter avant de construire le projet
avant_script :
# Créer un répertoire d'installation
– powershell.exe -ExecutionPolicy Bypass -Command 'New-Item -ItemType Directory -Force -Path C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom'
# Script pour construire le projet
script:
# Téléchargez et décompressez la configuration eSignerCKA
– powershell.exe -ExecutionPolicy Bypass -Command 'Invoke-WebRequest -OutFile eSigner_CKA_Setup.zip "https://www.ssl.com/download/ssl-com-esigner-cka"'
– powershell.exe -ExecutionPolicy Bypass -Command 'Expand-Archive -Force eSigner_CKA_Setup.zip'
– powershell.exe -ExecutionPolicy Bypass -Command 'Remove-Item eSigner_CKA_Setup.zip'
– powershell.exe -ExecutionPolicy Bypass -Command 'Move-Item -Destination « eSigner_CKA_Installer.exe » -Chemin « eSigner_CKA_*\*.exe »'
# Configurer eSignerCKA en mode silencieux
– powershell.exe -ExecutionPolicy Bypass -Command './eSigner_CKA_Installer.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom” | Hors-Nul'
# Vérifier le répertoire d'installation
– powershell.exe -ExecutionPolicy Bypass -Command 'dir C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom'
# Configurer les informations de compte sur eSignerCKA
– powershell.exe -ExecutionPolicy Bypass -Command 'C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\eSignerCKATool.exe config -mode ${MODE} -user "${USERNAME}" -pass "${ MOT DE PASSE}" -totp "${TOTP_SECRET}" -key "C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\master.key" -r'
# Décharger le certificat dans le Windows Store
– powershell.exe -ExecutionPolicy Bypass -Command 'C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\eSignerCKATool.exe décharger'
# Charger le certificat dans le Windows Store
– powershell.exe -ExecutionPolicy Bypass -Command 'C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\SSLcom\eSignerCKATool.exe charger'
# Sélectionnez le certificat dans le Windows Store
– powershell.exe -ExecutionPolicy Bypass -Command '$CodeSigningCert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Select-Object -Premier 1 ; echo $CodeSigningCert.Empreinte > .Empreinte'
# Empreinte numérique du certificat de débogage
– powershell.exe -ExecutionPolicy Bypass -Command 'Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); echo $Empreinte'
# Installez OpenVsixSignTool dans un emplacement personnalisé (https://github.com/vcsjones/OpenOpcSignTool)
– powershell.exe -ExecutionPolicy Bypass -Command 'New-Item -ItemType Directory -Force -Path C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\dotnet-tools'
powershell.exe -ExecutionPolicy Bypass -Command 'Invoke-WebRequest -OutFile OpenVsixSignTool.zip https://github.com/SSLcom/eSignerCKA/releases/download/v1.0.4/OpenVsixSignTool_1.0.0-x86.zip'
powershell.exe -ExecutionPolicy Bypass -Command 'Move-Item -Path OpenVsixSignTool.zip -Destination C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\dotnet-tools\OpenVsixSignTool.zip'
powershell.exe -ExecutionPolicy Bypass -Command 'Expand-Archive -LiteralPath C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\dotnet-tools\OpenVsixSignTool.zip -DestinationPath C:\Users\travis\build\mbayrak-sslcom \eSignerCKA\dotnet-tools -Force'
# Signer un exemple de fichier avec OpenVsixSignTool
– powershell.exe -ExecutionPolicy Bypass -Command « Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint) ; C:\Users\travis\build\mbayrak-sslcom\eSignerCKA\dotnet-tools\OpenVsixSignTool –roll-forward LatestMajor sign –sha1 $Thumbprint –timestamp http://ts.ssl.com -ta sha256 -fd sha256 SSLcom.vsix »

Exemple de workflow de signature de DLL de code .NET

Préparer les composants du workflow

1. Créez un dossier .circleci sur votre éditeur. Incluez les flux de travail avec le dossier et créez un fichier yml en tant que config.yml sous le dossier.
2. Définissez la version de CircleCI. Le champ de version est destiné à être utilisé afin d'émettre des avertissements en cas d'obsolescence ou de modifications avec rupture.

   Version: 2.1

3. Les orbs sont des packages réutilisables de configuration CircleCI que vous pouvez partager entre plusieurs projets, vous permettant de créer des commandes, des tâches et des exécuteurs encapsulés et paramétrés pouvant être utilisés sur plusieurs projets. Pour utiliser l'outil signtool, cela doit être Windows.

   orbes :

      gagner : cercleci/windows@5.0.0

4. Invoquez des tâches via des workflows. Les workflows orchestrent un ensemble de tâches à exécuter. 

   flux de travail :

      # Le nom du flux de travail.

      signe-fichier :

         # Dans le workflow, vous définissez les tâches que vous souhaitez exécuter.

            emplois:

               – fichier de signature

5. Définissez une tâche à appeler ultérieurement dans un workflow.

   emplois:

      signe-fichier :

6. Spécifiez l'environnement d'exécution. Nous devons utiliser l'exécuteur Windows car signtool est nécessaire.

   exécuteur:

      nom : win/server-2019

      taille moyenne

      variante : vs 2019

7. Placez le répertoire de travail pour le travail 

   répertoire_de_travail : /home/circleci/project

8. Ajouter des étapes au travail Voir : https://circleci.com/docs/2.0/configuration-reference/#steps  

   étapes:

9. Extrayez le code source afin que le workflow puisse y accéder.

   - vérifier

10. Téléchargez et décompressez la configuration eSignerCKA

    - Cours:

          nom : Téléchargez et décompressez la configuration eSignerCKA

          commande : |

             Invoke-WebRequest -OutFile eSigner_CKA_1.0.3.zip "https://www.ssl.com/download/ssl-com-esigner-cka-1-0-3"

             Développez-Archive -Force eSigner_CKA_1.0.3.zip

             Supprimer l'élément eSigner_CKA_1.0.3.zip

             Move-Item -Destination « eSigner_CKA_1.0.3.exe » -Chemin « eSigner_CKA_1.0.3SSL.COM eSigner CKA_1.0.3.exe »

11. Installer eSignerCKA

    - Cours:

          nom : Configurer eSignerCKA en mode silencieux

          commande : |

                mkdir -p "/home/circleci/project/eSignerCKA"

                ./eSigner_CKA_1.0.3.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”/home/circleci/project/eSignerCKA” | Hors-Nul

12. Définir les informations de compte SSLcom sur eSignerCKA

    - Cours:

          name : Config Account Information on eSignerCKA

          commande : |

                /home/circleci/project/eSignerCKA/eSignerCKATool.exe config -mode $env:MODE -user "$env:USERNAME" -pass "$env:PASSWORD" -totp "$env:TOTP_SECRET" -key "/home/circleci /project/eSignerCKA/master.key” -r

13. Décharger et charger le certificat dans le magasin de certificats Windows

    - Cours:

          name : Charger le certificat dans le Windows Store

          commande : |

                /home/circleci/project/eSignerCKA/eSignerCKATool.exe décharger

                /home/circleci/project/eSignerCKA/eSignerCKATool.exe charger

14. Sélectionnez le certificat de signature de code et obtenez l'empreinte numérique pour la signature et l'artefact de signature avec l'outil de signature

    - Cours:

          nom : sélectionnez le certificat dans le Windows Store et signez le fichier d'exemple avec SignTool

          commande : |

                $CodeSigningCert = Get-ChildItem Cert:CurrentUserMy -CodeSigningCert | Sélectionner un objet -Premier 1

                & 'C:Program Files (x86)Windows Kits10App Certification Kitsigntool.exe' sign /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 « $($CodeSigningCert.Thumbprint) » « HelloWorld. dll"

Exemple de workflow de signature de DLL de code .NET

Préparer les composants du workflow

1. Créez un dossier .github/workflows sur votre éditeur. Incluez les flux de travail avec le dossier et créez un fichier sign.yml sous le dossier.
2. Nommez votre projet et le type de flux de travail impliqué 

   Nom : artefact de signe

3. Déclencher ce workflow sur un push 

   activé : appuyez sur

4. Créer une variable d'environnement

   env :

    MASTER_KEY : clé.maître

    SIGNABLE_FILE_PATH : HelloWorld.dll

    INSTALL_DIR : C:UtilisateursrunneradmineSignerCKA

    MASTER_KEY_FILE : C:UsersrunneradmineSignerCKAmaster.key

5. Définir les jobs sur votre éditeur

   emplois:

    signe-fichier :

6. Exécuter le travail sur Windows Runners'exécute sur : les dernières fenêtres

7. Créez un nom. Lorsque le workflow s'exécute, c'est le nom qui est consigné.

   nom : Signer le fichier DLL avec eSignerCKA

Décrire les étapes du travail de signature

1. Extrayez le code source afin que le workflow puisse y accéder.

   – nom : Référentiel de paiement

      utilise : actions/checkout@v3

2. Téléchargez et décompressez la configuration eSignerCKA

   – nom : Télécharger et décompresser la configuration eSignerCKA

     exécutez : |

         Invoke-WebRequest -OutFile eSigner_CKA_1.0.3.zip "https://www.ssl.com/download/ssl-com-esigner-cka-1-0-3"

         Développez-Archive -Force eSigner_CKA_1.0.3.zip

         Supprimer l'élément eSigner_CKA_1.0.3.zip

         Move-Item -Destination « eSigner_CKA_1.0.3.exe » -Chemin « eSigner_CKA_1.0.3SSL.COM eSigner CKA_1.0.3.exe »
3. Installer eSignerCKA

   – nom : Configurer eSignerCKA en mode silencieux

     exécutez : |

         Nouvel élément -ItemType Directory -Force -Path ${{ env.INSTALL_DIR }}

         ./eSigner_CKA_1.0.3.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”${{ env.INSTALL_DIR }}” | Hors-Nul

4. Définir les informations de compte SSL.com sur eSignerCKA

   - nom : informations de compte de configuration sur eSignerCKA

     exécutez : |

         ${{ env.INSTALL_DIR }}/eSignerCKATool.exe config -mode "${{ secrets.MODE }}" -user "${{ secrets.USERNAME }}"

        -pass "${{ secrets.PASSWORD }}" -totp "${{ secrets.TOTP_SECRET }}" -key "${{ env.MASTER_KEY_FILE }}" -r

5. Décharger et charger le certificat dans le magasin de certificats Windows

   – nom : charger le certificat dans le Windows Store

     exécutez : |

         Déchargement de ${{ env.INSTALL_DIR }}/eSignerCKATool.exe

         chargement de ${{ env.INSTALL_DIR }}/eSignerCKATool.exe
6. Sélectionnez le certificat de signature de code et obtenez une empreinte numérique pour la signature

   - nom : sélectionnez le certificat dans le Windows Store

     exécutez : |

         $CodeSigningCert = Get-ChildItem Cert:CurrentUserMy -CodeSigningCert | Sélectionner un objet -Premier 1

         echo "THUMBPRINT=$($CodeSigningCert.Thumbprint)" >> $env:GITHUB_ENV
7. Artefact de signe avec signtool

   – nom : signer un exemple de fichier avec SignTool

     exécutez : |

         & 'C:/Program Files (x86)/Windows Kits/10/bin/10.0.17763.0/x86/signtool.exe' signe /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 ${{ env.THUMBPRINT }} ${{ env.SIGNABLE_FILE_PATH }}

Exemple de workflow de signature de DLL de code .NET

Définir les composants du workflow

1. Ccréer un fichier yml en tant que .gitlab-ci.yml sous le dossier.
2. Permet de sélectionner des coureurs dans la liste des coureurs disponibles. Un exécuteur doit avoir toutes les balises répertoriées ici pour exécuter la tâche.

   .windows_runners :

         tags:

               – fenêtres partagées

               - les fenêtres

               – fenêtres-1809

3. Regroupe les tâches en étapes. Tous les travaux d'une étape doivent être terminés avant l'exécution de l'étape suivante.

   étapes:

         - pancarte

4. Vous trouverez ci-dessous la définition de votre travail pour signer le fichier. Définissez à quelle étape le travail sera exécuté.

   signe-fichier :

        scène : signe

5. Le nom d'un ou plusieurs travaux dont héritera la configuration.

   s'étend :

        – .windows_runners
6. Écrivez le script pour signer le fichier.

   script:

   # Téléchargez et décompressez la configuration eSignerCKA

      – powershell.exe -ExecutionPolicy Bypass -Command 'Invoke-WebRequest -OutFile eSigner_CKA_1.0.3.zip "https://www.ssl.com/download/ssl-com-esigner-cka-1-0-3"'

      – powershell.exe -ExecutionPolicy Bypass -Command 'Expand-Archive -Force eSigner_CKA_1.0.3.zip'

      – powershell.exe -ExecutionPolicy Bypass -Command 'Remove-Item eSigner_CKA_1.0.3.zip'

      – powershell.exe -ExecutionPolicy Bypass -Command 'Move-Item -Destination « eSigner_CKA_1.0.3.exe » -Chemin « eSigner_CKA_1.0.3SSL.COM eSigner CKA_1.0.3.exe »'

   
   

   # Configurer eSignerCKA en mode silencieux

   – powershell.exe -ExecutionPolicy Bypass -Command './eSigner_CKA_1.0.3.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”C:Usersgitlab_runnerDesktopeSignerCKA”'

   
   

   # Vérifier le répertoire d'installation

   – powershell.exe -ExecutionPolicy Bypass -Command 'dir C:Usersgitlab_runnerDesktopeSignerCKA'

   
   

   # Configurer les informations de compte sur eSignerCKA

   – powershell.exe -ExecutionPolicy Bypass -Command 'C:Usersgitlab_runnerDesktopeSignerCKAeSignerCKATool.exe config -mode ${MODE}

        -user "${USERNAME}" -pass "${PASSWORD}" -totp "${TOTP_SECRET}" -key "C:Usersgitlab_runnerAppDataRoamingeSignerCKAmaster.key" -r'

   
   

   # Décharger le certificat dans le Windows Store

   – powershell.exe -ExecutionPolicy Bypass -Command 'C:Usersgitlab_runnerDesktopeSignerCKAeSignerCKATool.exe décharger'

   
   

   # Charger le certificat dans le Windows Store

   – powershell.exe -ExecutionPolicy Bypass -Command 'C:Usersgitlab_runnerDesktopeSignerCKAeSignerCKATool.exe charger'

   
   

      # Vérifier le répertoire de données

      – powershell.exe -ExecutionPolicy Bypass -Command 'dir C:Usersgitlab_runnerAppDataRoamingeSignerCKA'

   
   

      # Vérifier le répertoire des données de configuration

      – powershell.exe -ExecutionPolicy Bypass -Command 'dir C:Usersgitlab_runnerAppDataRoamingeSignerCKAConfig'

   
   

   # Sélectionnez le certificat dans le Windows Store

   – powershell.exe -ExecutionPolicy Bypass -Command '$CodeSigningCert = Get-ChildItem Cert:CurrentUserMy -CodeSigningCert | Sélectionner-Objet -Premier 1 ; echo $CodeSigningCert.Thumbprint > .Thumbprint'

   # Empreinte numérique du certificat de débogage

   – powershell.exe -ExecutionPolicy Bypass -Command 'Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); echo $Empreinte'

   
   

   # Signer un exemple de fichier avec SignTool

   – powershell.exe -ExecutionPolicy Bypass -Command "Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint);

        'C:Program Files (x86)Windows Kits10bin10.0.17763.0x86signtool.exe sign /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 $Thumbprint HelloWorld.dll'"

Exemple de workflow de signature de DLL de code .NET

Définir les composants du workflow

1. Créez un fichier yml en tant que .travis.yml sous le dossier racine.
2. Placez l'architecture du processeur sur laquelle exécuter le travail.

   arc : amd64

3. Langue par défaut pour exécuter les travaux sur Travis CI
   

   langue: csharp

4. Le système d'exploitation sur lequel exécuter la tâche
   

   os: fenêtres

5. Spécifiez l'ordre des étapes. Tous les travaux d'une étape doivent être terminés avant l'exécution de l'étape suivante.
   

   étapes:

     - pancarte

6. Définir l'étape de construction
   

   emplois:

     consistent à

        – scène : signe

7. Le nom du travail

   nom : fichier de signature

8. Le système d'exploitation sur lequel exécuter la tâche

   os: fenêtres

9. Langue actuelle pour exécuter des travaux sur Travis CI

   langue : c

10. Écrire le script Avant à exécuter avant de créer le projet

    avant_script :

        – powershell.exe -ExecutionPolicy Bypass -Command 'New-Item -ItemType Directory -Force -Path C:Userstravisbuildesigner-échantilloneSignerCKASSLcom'

11. Écrivez le script pour construire le projet.

    script:

    # Téléchargez et décompressez la configuration eSignerCKA

    – powershell.exe -ExecutionPolicy Bypass -Command 'Invoke-WebRequest -OutFile eSigner_CKA_1.0.3.zip "https://www.ssl.com/download/ssl-com-esigner-cka-1-0-3"'

    – powershell.exe -ExecutionPolicy Bypass -Command 'Expand-Archive -Force eSigner_CKA_1.0.3.zip'

    – powershell.exe -ExecutionPolicy Bypass -Command 'Remove-Item eSigner_CKA_1.0.3.zip'

    – powershell.exe -ExecutionPolicy Bypass -Command 'Move-Item -Destination « eSigner_CKA_1.0.3.exe » -Chemin « eSigner_CKA_1.0.3SSL.COM eSigner CKA_1.0.3.exe »'

    
    

    # Configurer eSignerCKA en mode silencieux

    – powershell.exe -ExecutionPolicy Bypass -Command './eSigner_CKA_1.0.3.exe /CURRENTUSER /VERYSILENT /SUPPRESSMSGBOXES /DIR=”C:Userstravisbuildesigner-échantilloneSignerCKASSLcom” | Hors-Nul'

    
    

    # Vérifier le répertoire d'installation

    – powershell.exe -ExecutionPolicy Bypass -Command 'dir C: Userstravisbuildesigner-échantilloneSignerCKASSLcom'

    
    

    # Configurer les informations de compte sur eSignerCKA

    – powershell.exe -ExecutionPolicy Bypass -Command 'C: Userstravisbuildesigner-échantilloneSignerCKASSLcomeSignerCKATool.exe config -mode ${MODE} -user « ${USERNAME} »

       -pass "${PASSWORD}" -totp "${TOTP_SECRET}" -key "C:Userstravisbuildesigner-échantilloneSignerCKASSLcommaster.key” -r'

    
    

    # Décharger le certificat dans le Windows Store

    – powershell.exe -ExecutionPolicy Bypass -Command 'C: Userstravisbuildesigner-échantillonDéchargement de eSignerCKASSLcomeSignerCKATool.exe'

    
    

    # Charger le certificat dans le Windows Store

    – powershell.exe -ExecutionPolicy Bypass -Command 'C: Userstravisbuildesigner-échantillonChargement d'eSignerCKASSLcomeSignerCKATool.exe'

    
    

    # Sélectionnez le certificat dans le Windows Store

    – powershell.exe -ExecutionPolicy Bypass -Command '$CodeSigningCert = Get-ChildItem Cert:CurrentUserMy -CodeSigningCert | Sélectionner-Objet -Premier 1 ; echo $CodeSigningCert.Thumbprint > .Thumbprint'

    
    

    # Empreinte numérique du certificat de débogage

    – powershell.exe -ExecutionPolicy Bypass -Command 'Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint); echo $Empreinte'

    
    

    # Signer un exemple de fichier avec SignTool

    – powershell.exe -ExecutionPolicy Bypass -Command « Set-Variable -Name Thumbprint -Value (Get-Content .Thumbprint) ; 'C:Program Files (x86)Windows Kits10binx64signtool.exe sign /debug /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 $Thumbprint HelloWorld.dll'"