Navigation
Le service de signature de code à distance propose plusieurs clients, fournisseurs système, interfaces de développement et méthodes d’intégration automatisées.
Si vous ne savez pas quelle méthode choisir, commencez par identifier votre scénario d’utilisation ci-dessous.
Comment choisir une méthode d’intégration
| Scénario d’utilisation | Méthode recommandée |
|---|---|
| Utiliser l’outil en ligne de commande officiel pour signer directement des fichiers EXE, DLL, MSI, etc. | Outil client |
| Installer le client de signature de code via Homebrew sur macOS | Outil client |
| Les outils Windows tels que Microsoft SignTool, Visual Studio ou MSBuild doivent utiliser directement la clé privée distante | Windows Provider |
| Nécessité de compatibilité avec les applications Windows CryptoAPI / CSP classiques | Windows Provider |
Utiliser jarsigner pour signer des fichiers JAR Java | Intégration Java |
| Automatiser la signature de code dans GitHub Actions | CI/CD et outils de build |
| Automatiser la signature d’applications Windows avec Electron Builder | CI/CD et outils de build |
| Utiliser Advanced Installer pour construire et signer le package d’installation | CI/CD et outils de build |
| Développer soi-même un client ou appeler directement le service de signature à distance | Intégration API |
| Consulter le nombre de signatures, le serveur d’horodatage et d’autres informations publiques | Matériel de référence |
Outils client
Destiné aux utilisateurs qui souhaitent utiliser directement le client officiel sslTrus pour la signature de code.
Il comprend principalement :
- SignTool CLI : signer directement des fichiers via la ligne de commande.
- Consultation du quota de signature : consulter le nombre de signatures restantes et le nombre total de signatures du certificat.
- Mise à jour du client : rechercher et installer la dernière version.
- Homebrew : installer le client CLI ou le client de bureau sur macOS.
Windows Provider
Destiné à Microsoft SignTool, Visual Studio, MSBuild, aux outils de création de packages d’installation ainsi qu’aux autres logiciels prenant en charge l’API Windows Cryptography.
Deux fournisseurs sont proposés :
- KSP (Key Storage Provider) : basé sur Windows CNG, adapté aux flux de signature Windows modernes.
- CSP (Cryptographic Service Provider) : basé sur l’API CryptoAPI traditionnelle, adapté aux applications nécessitant une compatibilité CSP.
La clé privée de signature reste toujours conservée dans le HSM cloud ; le fournisseur local est chargé d’envoyer la demande de signature au service de signature de code à distance.
Intégration Java
Destiné aux scénarios de signature de code Java.
Grâce au fournisseur Java proposé par sslTrus, vous pouvez utiliser l’outil standard jarsigner pour effectuer la signature de code à distance sur des fichiers JAR.
CI/CD et outils de build
Destiné aux scénarios où la signature de code doit être intégrée aux processus automatisés de build, de publication ou de packaging.
Actuellement inclus :
- GitHub Actions
- Electron Builder
- Advanced Installer
Les méthodes d’intégration d’autres outils CI/CD ou de build seront également fournies sur cette page.
Voir CI/CD et outils de build →
Intégration API
Destiné aux développeurs qui doivent développer eux-mêmes un client de signature de code ou intégrer la capacité de signature à distance dans des systèmes existants.
L’API de signature de code à distance prend en charge :
- La soumission du condensé à signer et l’obtention du résultat de signature.
- La remontée de l’état final du traitement de signature côté client.
L’appelant est responsable d’effectuer localement le calcul du condensé du fichier, le traitement de la structure de signature ainsi que l’écriture du résultat final de signature.
Documents de référence
Vous trouverez ici des informations de référence communes adaptées à différents modes d’intégration, notamment :
- Explication du calcul du nombre de signatures : explique comment le nombre de signatures est calculé dans des scénarios tels que CLI, KSP, CSP, Jarsigner, Electron et les packages d’installation.
- Serveurs d’horodatage : présente Authenticode, RFC 3161 ainsi que les services d’horodatage de signature de code couramment utilisés.