en English
X

Select Language

Powered by Google TranslateTranslate

We hope you will find the Google translation service helpful, but we don’t promise that Google’s translation will be accurate or complete. You should not rely on Google’s translation. English is the official language of our site.

en English
X

Select Language

Powered by Google TranslateTranslate

We hope you will find the Google translation service helpful, but we don’t promise that Google’s translation will be accurate or complete. You should not rely on Google’s translation. English is the official language of our site.

Guide des commandes eSigner CodeSignTool

CodeSignTool est un utilitaire de ligne de commande Java multiplateforme sécurisé et axé sur la confidentialité pour signer à distance des objets de code Microsoft Authenticode et Java avec e-signataire Certificats de signature de code EV. Les hachages des fichiers sont envoyés à SSL.com pour signer afin que le code lui-même ne soit pas envoyé. C'est idéal lorsque des fichiers sensibles doivent être signés, mais ne doivent pas être envoyés par câble pour signature. CodeSignTool est également idéal pour les processus par lots automatisés pour les signatures à haut volume ou l'intégration dans les flux de travail de pipeline CI/CD existants.

Si vous souhaitez essayer CodeSignTool avec un compte démo et un certificat, veuillez lire Informations d'identification et certificats de démonstration eSigner pour les informations d'identification et de configuration.

Pour obtenir des instructions sur la façon de automatiser la signature de code EV à l'aide de signtool.exe ou certutil.exe S'il-vous-plaît évaluez ce mode d'emploi.

Si vous cherchez à utiliser esigner pour signer des documents à la place, veuillez reportez-vous à ce guide DocSignTool.

Installation de CodeSignTool

Pour installer la version actuelle de CodeSignTool, téléchargez et décompressez simplement le fichier correspondant à votre système d'exploitation:

Notez que le téléchargement de Windows inclut le runtime Java, mais la version Linux/macOS nécessite que le runtime Java soit installé sur votre ordinateur. La version Windows de la commande est un fichier batch (CodeSignTool.bat) et la version Linux / macOS est un script shell (CodeSignTool.sh).

Présentation de l'utilisation de CodeSignTool

Usage: CodeSignTool [-hV] [COMMAND] [PARAMETERS]

options:

  • -h, --help: Afficher le message d'aide et quitter.
  • -V, --version: Afficher les informations de version et quitter.

commandes:

  • get_credential_ids: affiche la liste des identifiants d'identification eSigner associés à un utilisateur particulier.
  • credential_info : informations de clé et de certificat de sortie liées à un identifiant d'identification.
  • sign: Objet de code de signe et d'horodatage.
  • batch_sign: Signez et horodatez plusieurs objets de code avec un seul OTP.
  • hash: pré-calculer le(s) hachage(s) pour une utilisation ultérieure avec batch_hash_sign commander.
  • batch_sign_hash : hachage(s) de signe pré-calculé avec hash commander.

Paramètres:

  • -access_token=<TOKEN>: OAuth jeton d'accès.
  • -credential_id=<CREDENTIAL_ID>: Identifiant d'identification pour la signature du certificat.
  • -input_dir_path=<PATH>: répertoire d'entrée pour les objets de code à signer, faire calculer les hachages ou sélectionner les fichiers non signés et les hachages correspondants pour la signature.
  • -input_file_path=<PATH>: Chemin de l'objet de code à signer.
  • -otp=<OTP>: valeur OAuth OTP de l'application d'authentification.
  • -output_dir_path=<PATH>: Répertoire où seront écrits les objets de code signés.
  • -password=<PASSWORD>: mot de passe du compte SSL.com.
  • -program_name=<PROGRAM_NAME>: Nom du programme (pour les installateurs MSI uniquement).
  • -totp_secret=<TOTP_SECRET>: OAuth Secret TOTP
  • -username=<USERNAME>: nom d'utilisateur du compte SSL.com
Si votre mot de passe contient des caractères spéciaux, mettez-le entre guillemets (par exemple -password="P!@^^ssword12").

Commandes CodeSignTool

get_credential_ids

Sortir la liste des identifiants d'identification eSigner associés à un utilisateur particulier. Paramètres -username et -password sont obligatoires.

Usage: CodeSignTool [-hV] get_credential_ids -username=<USERNAME> -password=<PASSWORD>

Mise en situation :

CodeSignTool get_credential_ids -username=john.doe@example.com -password="P0z9@lxo41"
Credential ID(s):
- fe537ace-e132-52a9-c2e7-egcd2ac3f1e6

Saisie CodeSignTool get_credential_ids sans les paramètres requis affichera les informations d'utilisation de la commande.

informations_identifiants

Sortez les informations de clé et de certificat liées à un identifiant d'identification. Paramètres -credential_id, -usernameet -password sont obligatoires.

Usage: CodeSignTool [-hV] credential_info -credential_id=<CREDENTIAL_ID> -username=<USERNAME> -password=<PASSWORD>

Mise en situation :

CodeSignTool credential_info -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" Informations sur le sujet du certificat EVCS : - DN du sujet : OID.1.3.6.1.4.1.311.60.2.1.3 1.3.6.1.4.1.311.60.2.1.2=États-Unis, OID.2.5.4.15=Nevada, OID.20081614243=Organisation privée, CN=SSL Corp, SERIALNUMBER=NV26, O=SSL Corp, L=Houston, ST=Texas, C=US - Expiration du certificat : Lun 21 février 21:37:2024 EST 3 - DN de l'émetteur : CN=SSL.com EV Code Signing Intermediate CA RSA RXNUMX, O=SSL Corp, L=Houston, ST=Texas , C=US

Saisie CodeSignTool credential_info sans les paramètres requis affichera les informations d'utilisation de la commande.

signer

Objet de code de signe et d'horodatage. Paramètres -username, -passwordet -input_file_path sont obligatoires. -credential_id est requis uniquement pour les utilisateurs possédant plusieurs certificats de signature de code eSigner. -output_dir_path, -program_nameet -totp_secret sont optionnels.

Usage: CodeSignTool sign [-hV] [-credential_id=<CREDENTIAL_ID>] -username=<USERNAME> -password=<PASSWORD> -input_file_path=<PATH> [-output_dir_path=<PATH>] [-program_name=<PROGRAM_NAME>] [-totp_secret=<TOTP_SECRET>]

Paramètres facultatifs:

  • If -credential_id est omis et l'utilisateur n'a qu'un seul certificat de signature de code eSigner, CodeSignTool le sera par défaut. Si l'utilisateur possède plusieurs certificats de signature de code, ce paramètre est obligatoire.
  • If -output_dir_path est omis, le fichier spécifié dans -input_file_path sera écrasé par le fichier signé. CodeSignTool invitera l'utilisateur avant d'écraser le fichier.
  • If -program_name est présent lors de la signature d'un programme d'installation MSI, la valeur sera affichée dans la boîte de dialogue de confirmation en tant que nom du programme.
  • If -totp_secret est présent, CodeSignTool calculera un OTP basé sur le temps pour la signature, permettant une utilisation automatisée de l'outil. Si ce paramètre n'est pas présent, l'utilisateur sera invité à entrer manuellement OTP.
Pour plus d'informations sur l'inscription d'un certificat de signature de code EV dans eSigner et la configuration de l'authentification à deux facteurs, veuillez lire Signature de code EV à distance avec eSigner. Pour plus d'informations sur la valeur secrète TOTP, veuillez consulter Automatisez la signature de code eSigner EV.

Exemples:

Entrée OTP manuelle:

CodeSignTool sign -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" -output_dir_path=signed -input_file_path=test.exe Entrez l'OTP - Appuyez sur Entrée pour continuer : 884646 Code signé avec succès : C:\Users\John Doe\Desktop\CodeSignTool-v1.0-windows\signed\test.exe

Génération OTP automatisée:

CodeSignTool sign -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" -totp_secret=ii5gVvZ9G+WkxB3FauAnoL/z14AXSMistcE0jZMWWNSjQDlql2kt2D6Z+l8= -output_dir_path=signed -input_file_path=test.exe
Code signed successfully: C:\Users\John Doe\Desktop\CodeSignTool-v1.0-windows\signed\test.exe

Saisie CodeSignTool sign sans les paramètres requis affichera les informations d'utilisation de la commande.

Si vous obtenez le message d'erreur, Error: invalid otp lors de la tentative de signature d'un fichier, cela peut être dû à un ou plusieurs de ces problèmes:

  • Le code QR que vous avez scanné dans votre application d'authentification ne correspond pas au nom d'utilisateur, au mot de passe et / ou à l'ID d'identification de votre commande. Cela peut arriver si:
    • Vous avez plusieurs comptes configurés pour 2FA sur votre appareil et vous avez choisi le mauvais.
    • Vous essayez d'utiliser vos identifiants de connexion pour un certificat partagé, mais a scanné un code QR partagé par un coéquipier à partir de son compte.
  • L'OTP que vous avez entré a déjà expiré.
  • Votre commande comprend un secret TOTP non valide.
Certains utilisateurs d'eSigner ont signalé des problèmes de signatures non valides lors de la signature des programmes d'installation MSI créés avec Microsoft Visual Studio. Pour contourner ce problème, nous vous suggérons de créer vos fichiers MSI avec Ensemble d'outils WiX. Pour la commodité des utilisateurs de Visual Studio, un Extension WiX Toolset VS est disponible.

signe_lot

Signez et horodatez jusqu'à 100 fichiers de code avec un seul OTP. Paramètres -username, -passwordet -input_dir_path sont obligatoires. -credential_id est requis uniquement pour les utilisateurs possédant plusieurs certificats de signature de code eSigner. -output_dir_path, -program_nameet -totp_secret sont optionnels.

Usage: CodeSignTool [-hV] batch_sign [-credential_id=<CREDENTIAL_ID>] -username=<USERNAME> -password=<PASSWORD> -input_dir_path=<PATH> [-output_dir_path=<PATH>] [-program_name=<PROGRAM_NAME>] [-totp_secret=<TOTP_SECRET>]

Paramètres facultatifs:

  • If -credential_id est omis et l'utilisateur n'a qu'un seul certificat de signature de code eSigner, CodeSignTool le sera par défaut. Si l'utilisateur possède plusieurs certificats de signature de code, ce paramètre est obligatoire.
  • If -output_dir_path est omis, les fichiers spécifiés dans -input_dir_path seront écrasés par les fichiers signés. CodeSignTool demandera à l'utilisateur avant d'écraser le fichier.
  • If -program_name est présent lors de la signature d'un programme d'installation MSI, la valeur sera affichée dans la boîte de dialogue de confirmation en tant que nom du programme.
  • If -totp_secret est présent, CodeSignTool calculera un OTP basé sur le temps pour la signature, permettant une utilisation automatisée de l'outil. Si ce paramètre n'est pas présent, l'utilisateur sera invité à entrer manuellement OTP.

Mise en situation :

CodeSignTool batch_sign -username=john.doe@example.com -password="P0z9@lxo41" -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -input_dir_path=input -output_dir_path=455145put Entrez l'OTP XNUMX -XNUMX Commande de signature de lot exécutée avec succès. Répertoire de sortie des fichiers signés : sortie

Saisie CodeSignTool batch_sign sans les paramètres requis affichera les informations d'utilisation de la commande.

hachage

Pré-calculer le(s) hachage(s) pour une utilisation ultérieure avec batch_hash_sign commander. Paramètre -input_dir_path est nécessaire. -program_name est facultatif

Usage: CodeSignTool [-hV] hash -input_dir_path=<PATH> [-program_name=<PROGRAM_NAME>]

Paramètres facultatifs:

  • If -program_name est présent lors de la signature d'un programme d'installation MSI, la valeur sera affichée dans la boîte de dialogue de confirmation en tant que nom du programme.

Mise en situation :

CodeSignTool hash -input_dir_path=input La commande de hachage a été exécutée avec succès. Fichiers de hachage créés à : input

Saisie CodeSignTool hash sans les paramètres requis affichera les informations d'utilisation de la commande.

batch_sign_hash

Signez le(s) hachage(s) pré-calculé(s) avec hash commander. Paramètres -access_token, input_dir_path, -otpet output_dir_path sont obligatoires. -credential_id est requis uniquement pour les utilisateurs possédant plusieurs certificats de signature de code eSigner.

Usage: CodeSignTool [-hV] batch_sign_hash -access_token=<ACCESS_TOKEN> [-credential_id=<CREDENTIAL_ID>] -input_dir_path=<PATH> -output_dir_path=<PATH> -otp=<OTP>

Paramètres facultatifs:

  • If -credential_id est omis et l'utilisateur n'a qu'un seul certificat de signature de code eSigner, CodeSignTool le sera par défaut. Si l'utilisateur possède plusieurs certificats de signature de code, ce paramètre est obligatoire.

Mise en situation :

CodeSignTool batch_sign_hash -access_token=eyJraWQiOiJmUE1yYUdlbXVMWGUtcG9JWUtLem1CMEYwYXlFczktUEpiN29lTWFlY2I0IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJTU
0wuY29tIEF1dGhlbnRpY2F0aW9uIFNlcnZpY2UiLCJleHAiOjE2MTQ4OTcxNDIsImlhdCI6MTYxNDg5MzU0MiwianRpIjoiZmI2OTZlNDUtMTIzOS00ZGE4LW
I1MmYtODNkZDE2MTY3ZTM3IiwidXNlciI6eyJ1c2VyX2lkIjoxMzIyODU4LCJ1c2VyX2VtYWlsIjoiYWFyb24uZS5ydXNzZWxsQGdtYWlsLmNvbSIsInNzbF9
hY2NvdW50X2lkIjo0NzQzMDJ9LCJjbGllbnQiOnsiaWQiOiJmUE1yYUdlbXVMWGUtcG9JWUtLem1CMEYwYXlFczktUEpiN29lTWFlY2I0In19.fCKDs1igjsI
UDG2sUN_2OTb90Jw1nKNPHcD1MyEUR6sHCv_aJmcvcaFRne_eKLHzeQ9WtT5y3Fb2ppc50kMnjPG6JgX5gnFMptMn-ySsI277CtKbkSn3u-WSDSovn51jPm82
4wTeJmuXEzdv9clRjTwp6VoM9eqHCIaDAd3MP2xpMaa35cZbDaaAFKQ7jxWo9dUuTZY7DsKK0p1LloUEnmNxtNimQ3GDwkj_M600WB1zYrhDL9_3oZKaXcUx9
qzHcBCLzGgeaZ0xdpZtADxmXDUCcmkZi20yQ53bxqVL2w00sJ73efKB7JGeGWVehO-ZlGs3PUQwooox1JgEgcsA -credential_id=fe537ace-e132-52a9
-c2e7-egcd2ac3f1e6 -input_dir_path=input -output_dir_path=output -otp=142392
Batch sign hash command executed successfully. Output directory for signed files: output

Saisie CodeSignTool batch_sign_hash sans les paramètres requis affichera les informations d'utilisation de la commande.

Vidéo : signature de code Cloud EV avec eSigner et CodeSignTool

Merci d'avoir choisi SSL.com! Si vous avez des questions, veuillez nous contacter par e-mail à Support@SSL.com, appel 1-877-SSL-SECURE, ou cliquez simplement sur le lien de discussion en bas à droite de cette page. Vous pouvez également trouver des réponses à de nombreuses questions d'assistance courantes dans notre knowledgebase.

Partager sur twitter
Twitter
Partager sur facebook
Facebook
Partager sur linkedin
LinkedIn
Partager sur reddit
Reddit
Partager sur email
Email