SignTool

SignTool è uno strumento da riga di comando che firma digitalmente i file, verifica le firme nei file, rimuove le firme dai file e i file timestamp. SignTool può firmare file eseguibili, script, file di catalogo e altri tipi di file con un pacchetto SIP (Subject Interface Package) registrato. Per informazioni sui motivi per cui la firma dei file è importante, vedere Introduzione alla firma del codice.

SignTool è disponibile come parte di Windows Software Development Kit (SDK). Lo strumento viene installato nella \Bin cartella del percorso di installazione di Windows SDK, ad esempio : C:\Program Files (x86)\Windows Kits\10\bin\10.0.22621.0\x64\signtool.exe.

Nota

Windows SDK, Windows Hardware Lab Kit (HLK), Windows Driver Kit (WDK) e Windows Assessment and Deployment Kit (ADK) build 20236 e versioni successive richiedono di specificare l'algoritmo digest. Il comando SignTool sign richiede rispettivamente l'opzione algoritmo digest del file (/fd) e l'opzione dell'algoritmo digest timestamp (/td) durante la firma e il timestamp.

Se /fd non viene specificato durante la firma e se /td non viene specificato durante il timestamp, il comando genera un avviso, il codice di errore 0, inizialmente. Nelle versioni successive di SignTool, l'avviso diventa un errore. È consigliabile SHA256. La convalida SHA384 e più avanzata richiede Windows 11 o Windows 10 con l'aggiornamento di novembre 2022.

Sintassi

signtool [command] [options] [file_name | ...]
signtool @response_file

Parametri

Argomento Descrizione
command Uno dei cinque comandi che specifica un'operazione da eseguire in un file: catdb, remove, signtimestamp, o verify. Per una descrizione di ogni comando, vedere la tabella successiva.
options Opzione che modifica un comando. Oltre alle opzioni globali /q e /v, ciascun comando supporta un set univoco di opzioni.
file_name Percorso di un file in cui viene eseguito il comando.
response_file Percorso di un file di risposta che contiene uno o più comandi SignTool. Per altre informazioni, vedere File di risposta.

SignTool supporta i comandi seguenti:

Comando Descrizione
catdb Aggiunge o rimuove un file di catalogo da un database di cataloghi. I database dei cataloghi vengono usati per la ricerca automatica di file di catalogo e sono identificati dal GUID. Per un elenco delle opzioni supportate dal catdb comando, vedere opzioni di comando catdb.
remove Rimuove una firma da un file. Per un elenco delle opzioni supportate dal remove comando, vedere Rimuovere le opzioni dei comandi.
sign Firma digitalmente i file. Le firme digitali proteggono i file da manomissioni e consentono agli utenti di verificare il firmatario in base a un certificato di firma. Per un elenco delle opzioni supportate dal sign comando, vedere Opzioni del comando sign.
timestamp File timestamp. Per un elenco delle opzioni supportate dal timestamp comando, vedere opzioni del comando timestamp.
verify Verifica la firma digitale dei file. Determina se il certificato di firma è stato emesso da un'autorità attendibile, se il certificato di firma è stato revocato e, facoltativamente, se il certificato di firma è valido per un criterio specifico. Per un elenco delle opzioni supportate dal verify comando, vedere Verificare le opzioni dei comandi.

Le opzioni seguenti si applicano a tutti i comandi SignTool:

Opzione globale Descrizione
/q Non visualizza alcun output se il comando viene eseguito correttamente e visualizza un output minimo se il comando ha esito negativo.
/v Visualizza un output dettagliato indipendentemente dall'esito del comando e visualizza messaggi di avviso.
/debug Visualizza le informazioni di debug.

File di risposta

Usare un file di risposta per archiviare i comandi SignTool per operazioni ripetibili o automatizzate. Specificare un argomento in ogni riga. Il primo argomento deve essere il comando , ad esempio sign o verify. Per eseguire più comandi, separarli con una riga vuota.

Ad esempio, creare un file denominato commands.txt con il contenuto seguente:

sign
/n "Contoso Software"
/fd SHA256
/tr http://timestamp.digicert.com
/td SHA256
MyFile.exe

verify
/pa
/v
MyFile.exe

Eseguire i comandi specificando il file di risposta:

signtool @commands.txt

Opzioni di comando catdb

Nella tabella seguente sono elencate le opzioni che è possibile usare con il catdb comando :

Opzione catdb Descrizione
/d Specifica che il database dei cataloghi predefinito viene aggiornato. Se non si usa o /d/g, SignTool aggiorna il componente di sistema e il database del driver.
/g GUID Specifica che il database del catalogo identificato dal GUID viene aggiornato.
/r Rimuove il catalogo specificato dal database del catalogo. Se questa opzione non è specificata, SignTool aggiunge il catalogo specificato al database del catalogo.
/u Specifica che un nome univoco viene generato automaticamente per i file di catalogo aggiunti. Se necessario, i file di catalogo vengono rinominati per evitare conflitti con i nomi dei file di catalogo esistenti. Se questa opzione non è specificata, SignTool sovrascrive qualsiasi catalogo esistente con lo stesso nome del catalogo specificato.

Nota

I database di catalogo vengono usati per la ricerca automatica dei file di catalogo.

Rimuovi opzioni di comando

Nella tabella seguente sono elencate le opzioni che è possibile usare con il remove comando :

Opzione Rimuovi Descrizione
/c Rimuovere tutti i certificati, ad eccezione del certificato del firmatario dalla firma.
/q Nessun output in caso di esito positivo e minimo in caso di errore. Come sempre, SignTool restituisce 0 l'esito positivo e 1 negativo.
/s Rimuovere completamente la firma.
/u Rimuovere gli attributi non autenticati dalla firma, ad esempio firme doppie e timestamp.
/v Stampare messaggi dettagliati di esito positivo e di stato. Ciò può anche fornire informazioni leggermente più dettagliate sull'errore.

Opzioni del comando Sign

Nella tabella seguente sono elencate le opzioni che è possibile usare con il sign comando :

Opzioni del comando sign Descrizione
/a Seleziona automaticamente il miglior certificato di firma. SignTool trova tutti i certificati validi che soddisfano tutte le condizioni specificate e seleziona quella valida per il tempo più lungo. Se questa opzione non è presente, SignTool prevede di trovare un solo certificato di firma valido.
/ac file Aggiunge un altro certificato dal file al blocco di firme.
/as Aggiunge questa firma. Se non esiste alcuna firma primaria, la firma viene invece creata come firma primaria.
/Author value Aggiunge l'attributo autenticato dell'autore. Equivalente a /sa 1.3.6.1.4.1.311.2.7.8 value.
/c CertTemplateName Specifica un'estensione Microsoft, Certificate Template Name, per il certificato di firma.
/csp CSPName Specifica il provider del servizio di crittografia (CSP) che contiene il contenitore di chiavi private.
/d Desc Specifica una descrizione del contenuto firmato nel campo nome programma dell'attributo informativo OPUS firmato (SPC_SP_OPUS_INFO_OBJID, 1.3.6.1.4.1.311.2.1.12). Un criterio di Controllo app per le aziende può fare riferimento a questo valore usando una CertOemID condizione del firmatario. Per il flusso di lavoro dei metadati del file firmato, usare SignTool dal Windows 11, versione 24H2 SDK o successiva. Il supporto per /d in un signtool precedente non implica il supporto per questo flusso di lavoro. Vedere Usare CertOemID per trovare la corrispondenza con la descrizione firmata.
/dg Percorso Genera il digest da firmare e i file PKCS7 non firmati. Il digest di output e i file PKCS7 sono < e ><.>< Per restituire un file XML aggiuntivo, usare /dxml.
/di Percorso Crea la firma inserendo il digest firmato nel file PKCS7 senza segno. Il digest firmato di input e i file PKCS7 non firmati devono essere < e><>.<>
/dlib DLL Specifica la DLL che implementa la AuthenticodeDigestSign funzione per firmare il digest. Questa opzione equivale all'uso di SignTool separatamente con le /dgopzioni , /dse /di . Questa opzione richiama tutte e tre come un'operazione atomica.
/dmdf Nome file Se usato con l'opzione /dg , passa il contenuto del file alla AuthenticodeDigestSign funzione senza modifiche.
/ds Firma solo il digest. Il file di input deve essere il digest generato dall'opzione /dg . Il file di output è File.signed<>.
/du URL Specifica un URL (Uniform Resource Locator) per la descrizione espansa del contenuto firmato.
/dxml Se utilizzata con l'opzione /dg , produce un file XML. Il file di output è Path<>\<FileName>.dig.xml.
/f SignCertFile Specifica il certificato di firma in un file. Se il file è nel formato PFX (Personal Information Exchange) ed è protetto da una password, usare l'opzione /p per specificare la password. Se il file non contiene chiavi private, usare le /csp opzioni e /kc per specificare il nome del contenitore di chiavi private e CSP.
/fd alg Specifica l'algoritmo digest file da usare per creare le firme del file. Nota: se l'opzione non viene specificata durante la /fd firma, il comando genera un errore.
/fd certHash Se si specifica la stringa "certHash", il comando usa l'algoritmo specificato nel certificato di firma. Nota: se l'opzione non viene specificata durante la /fd firma, il comando genera un errore.
/FileDescription value Aggiunge l'attributo autenticato della descrizione del file. Equivalente a /sa 1.3.6.1.4.1.311.2.7.3 value. Questa opzione è diversa da /d, che imposta la descrizione Authenticode del contenuto firmato.
/FileVersion value Aggiunge l'attributo autenticato della versione del file. Equivalente a /sa 1.3.6.1.4.1.311.2.7.2 value.
/i IssuerName Specifica il nome dell'emittente del certificato di firma. Questo valore può essere una sottostringa dell'intero nome dell'emittente.
/InternalName value Aggiunge l'attributo autenticato del nome interno. Equivalente a /sa 1.3.6.1.4.1.311.2.7.1 value.
/kc PrivKeyContainerName Specifica il nome del contenitore delle chiavi private.
/Language value Aggiunge l'attributo autenticato per la lingua. Equivalente a /sa 1.3.6.1.4.1.311.2.7.7 value.
/n SubjectName Specifica il nome del soggetto del certificato di firma. Questo valore può essere una sottostringa dell'intero nome del soggetto.
/nph Se supportato, sopprime gli hash delle pagine per i file eseguibili. Il valore predefinito è determinato dalla variabile di ambiente SIGNTOOL_PAGE_HASHES e dalla versione wintrust.dll . Questa opzione viene ignorata per i file non PE.
/OriginalFilename value Aggiunge l'attributo autenticato del nome file originale. Equivalente a /sa 1.3.6.1.4.1.311.2.7.6 value.
/p Password Specifica la password da usare all'apertura di un file PFX Usare l'opzione /f per specificare un file PFX.
/p7 Percorso Specifica di produrre un file PKCS (Public Key Cryptography Standards) #7 per ogni file di contenuto specificato. I file PKCS #7 sono denominati path\filename.p7<><
/p7ce Valore Specifica le opzioni per il contenuto PKCS #7 firmato. Impostare Valore su Embedded per incorporare il contenuto firmato nel file PKCS #7 o per DetachedSignedData produrre la parte dei dati firmati di un file PKCS #7 scollegato. Se l'opzione /p7ce non è specificata, il contenuto firmato viene incorporato per impostazione predefinita.
/p7co <OID> Specifica l'identificatore di oggetto (OID) tramite cui viene identificato il contenuto PKCS #7 firmato.
/ph Se supportato, genera gli hash delle pagine per i file eseguibili.
/Product value Aggiunge l'attributo autenticato per il nome del prodotto. Equivalente a /sa 1.3.6.1.4.1.311.2.7.4 value.
/ProductVersion value Aggiunge l'attributo autenticato della versione del prodotto. Equivalente a /sa 1.3.6.1.4.1.311.2.7.5 value.
/PublishTime value Aggiunge l'attributo autenticato in fase di pubblicazione. Equivalente a /sa 1.3.6.1.4.1.311.2.7.9 value.
/r RootSubjectName Specifica il nome del soggetto del certificato radice cui deve essere concatenato il certificato di firma. Questo valore può essere una sottostringa dell'intero nome del soggetto del certificato radice.
/sa Valore OID Aggiunge un attributo autenticato alla firma. SignTool codifica il valore come stringa UTF-8 ASN.1. Specificare questa opzione più volte per aggiungere più attributi.
/s StoreName Specifica l'archivio da aprire quando il comando cerca il certificato. Se questa opzione non è specificata, il comando apre l'archivio My .
/sha1 Hash Specifica l'hash SHA1 del certificato di firma. L'hash SHA1 viene comunemente usato quando più certificati soddisfano i criteri specificati dalle opzioni rimanenti.
/sm Specifica che il comando usa un archivio computer anziché un archivio utenti.
/SourceURL value Aggiunge l'attributo autenticato dell'URL di origine. Equivalente a /sa 1.3.6.1.4.1.311.2.7.10 value.
/t URL Specifica l'URL del server di timestamp. Se questa opzione o /tr non è specificata, il file firmato non viene contrassegnato come timestamp. Se il timestamp non riesce, il comando genera un avviso. Questa opzione non può essere usata con l'opzione /tr .
/td alg Usata con l'opzione /tr per richiedere un algoritmo digest usato dal server di timestamp RFC 3161. Nota: se /td non viene specificato durante il timestamp, il comando genera un errore.
/tr URL Specifica l'URL del server di timestamp RFC 3161. Se questa opzione o /t non è specificata, il file firmato non viene contrassegnato come timestamp. Se il timestamp non riesce, il comando genera un avviso. Questa opzione non può essere usata con l'opzione /t .
/u Utilizzo Specifica l'utilizzo chiavi avanzato (EKU) che deve essere presente nel certificato di firma. Il valore di utilizzo può essere specificato tramite OID o stringa. L'utilizzo predefinito è Code Signing o 1.3.6.1.5.5.7.3.3.
/uw Specifica l'utilizzo di Windows System Component Verification o 1.3.6.1.4.1.311.10.3.6.

Attributi dei metadati autenticati

Gli attributi dei metadati autenticati forniscono informazioni sull'identità e sulla versione dei file firmati per script e altri file che non dispongono di risorse di versione PE (Portable Executable). Gli strumenti di distribuzione e criteri possono usare questi metadati per identificare il contenuto firmato.

Le opzioni descrittive dei metadati e i relativi OID equivalenti sono:

Opzione SignTool Identificatore WinTrust OID
/InternalName szOID_SIGNED_ATTRIBUTE_INTERNAL_NAME 1.3.6.1.4.1.311.2.7.1
/FileVersion szOID_SIGNED_ATTRIBUTE_FILE_VERSION 1.3.6.1.4.1.311.2.7.2
/FileDescription szOID_SIGNED_ATTRIBUTE_FILE_DESCRIPTION 1.3.6.1.4.1.311.2.7.3
/Product szOID_SIGNED_ATTRIBUTE_PRODUCT 1.3.6.1.4.1.311.2.7.4
/ProductVersion szOID_SIGNED_ATTRIBUTE_PRODUCT_VERSION 1.3.6.1.4.1.311.2.7.5
/OriginalFilename szOID_SIGNED_ATTRIBUTE_ORIGINAL_FILENAME 1.3.6.1.4.1.311.2.7.6
/Language szOID_SIGNED_ATTRIBUTE_LANGUAGE 1.3.6.1.4.1.311.2.7.7
/Author szOID_SIGNED_ATTRIBUTE_AUTHOR 1.3.6.1.4.1.311.2.7.8
/PublishTime szOID_SIGNED_ATTRIBUTE_PUBLISH_TIME 1.3.6.1.4.1.311.2.7.9
/SourceURL szOID_SIGNED_ATTRIBUTE_SOURCE_URL 1.3.6.1.4.1.311.2.7.10

Le opzioni dei metadati denominate sono disponibili a partire da Windows 11, versione 24H2 SDK (build 10.0.26100.0; Pacchetto sdk build tools versione 10.0.26100.1), il primo SDK rilasciato per includere queste opzioni.

Anche se /d precede queste opzioni di metadati denominate, usare la versione dell'SDK specificata in precedenza per il flusso di lavoro dei metadati del file firmato, incluso quando si usa /d. Le versioni precedenti di SignTool che riconoscono /d non forniscono il supporto dei metadati dei file firmati descritti qui.

Per le procedure, vedere Usare SignTool per firmare un filee Firmare script e file non PE con SignTool.

Opzioni del comando Timestamp

Nella tabella seguente sono elencate le opzioni che è possibile usare con il timestamp comando :

Opzione Timestamp Descrizione
/p7 Aggiunge un timestamp ai file PKCS #7.
/t URL Specifica l'URL del server di timestamp. È necessario che il file a cui viene aggiunto il timestamp sia stato precedentemente firmato. È richiesta l'opzione /t o /tr.
/td alg Usata con l'opzione /tr per richiedere un algoritmo digest usato dal server di timestamp RFC 3161. Nota: se /td non viene specificato durante il timestamp, il comando genera un avviso.
/tp index Aggiunge un timestamp alla firma in corrispondenza di indice.
/tr URL Specifica l'URL del server di timestamp RFC 3161. È necessario che il file a cui viene aggiunto il timestamp sia stato precedentemente firmato. È richiesta l'opzione /tr o /t.

Verificare le opzioni di comando

Nella tabella seguente sono elencate le opzioni che è possibile usare con il verify comando :

Opzione Verify Descrizione
/a Specifica che tutti i metodi possono essere usati per verificare il file. Prima di tutto, SignTool cerca nei database di catalogo di determinare se il file è connesso a un catalogo. Se il file non è connesso in alcun catalogo, SignTool tenta di verificare la firma incorporata del file. È consigliabile usare questa opzione per verificare i file che potrebbero o non essere connessi a un catalogo. Esempi di file che potrebbero o non essere firmati includono file o driver di Windows.
/ad Trova il catalogo usando il database dei cataloghi predefinito.
/all Verifica tutte le firme in un file con più firme.
/as Trova il catalogo usando il database dei cataloghi (driver) dei componenti del sistema.
/ag CatDBGUID Trova il catalogo nel database di catalogo identificato dal GUID.
/c CatFile Specifica il file di catalogo in base al nome.
/d Stampa la descrizione e l'URL della descrizione. Windows Vista e versioni precedenti: questa opzione non è supportata.
/ds Indice Verifica la firma in una determinata posizione.
/hash{SHA1|SHA256} Specifica un algoritmo hash facoltativo da usare quando si cerca un file in un catalogo.
/kp Esegue la verifica usando i criteri di firma del driver in modalità kernel x64.
/ms Usa semantica di verifica multipla. Questo comportamento è l'impostazione predefinita di una chiamata WinVerifyTrust .
/o Versione Verifica il file in base alla versione del sistema operativo. Il parametro version è nel formato <PlatformID>:<VerMajor.><VerMinor>.<BuildNumber>. È consigliabile usare l'opzione /o . Se /o non è specificato, SignTool potrebbe restituire risultati imprevisti. Ad esempio, se non si include /o, i cataloghi di sistema che convalidano correttamente in un sistema operativo precedente potrebbero non essere convalidati correttamente in un sistema operativo più recente.
/p7 Verifica i file PKCS #7. Non viene usato alcun criterio esistente per la convalida PKCS #7. SignTool controlla la firma e compila una catena per il certificato di firma.
/pa Specifica che viene utilizzato il criterio di verifica dell'autenticazione predefinito. Se l'opzione /pa non è specificata, SignTool usa i criteri di verifica del driver di Windows. Questa opzione non può essere usata con le catdb opzioni.
/pg PolicyGUID Specifica i criteri di verifica in base al GUID. Il GUID corrisponde al ActionID del criterio di verifica. Questa opzione non può essere usata con le catdb opzioni.
/ph Stampare e verificare i valori hash della pagina. Windows Vista e versioni precedenti: questa opzione non è supportata.
/r RootSubjectName Specifica il nome del soggetto del certificato radice cui deve essere concatenato il certificato di firma. Questo valore può essere una sottostringa dell'intero nome del soggetto del certificato radice.
/tw Specifica che il comando genera un avviso se la firma non è contrassegnata come timestamp.

Il comando SignTool verify determina se il certificato di firma è stato rilasciato da un'autorità attendibile, se il certificato di firma è stato revocato e, facoltativamente, se il certificato di firma è valido per un criterio specifico.

Il comando SignTool verify restituisce lo stato della firma incorporata, a meno che non venga specificata un'opzione per eseguire ricerche in un catalogo, ad esempio /a, /ad/as, /ag, o /c.

Valore restituito

SignTool restituisce uno dei codici di uscita seguenti quando termina:

Codice di uscita Descrizione
0 Esecuzione completata correttamente.
1 Esecuzione non riuscita.
2 Esecuzione completata con avvisi.

Esempi

Il comando seguente aggiunge il file di catalogo MyCatalogFileName.cat al database del componente di sistema e del driver. Se /u necessario, l'opzione genera un nome univoco per impedire la sostituzione di un file di catalogo esistente denominato MyCatalogFileName.cat.

signtool catdb /v /u MyCatalogFileName.cat

Il comando seguente firma automaticamente un file usando il certificato migliore.

signtool sign /a /fd SHA256 MyFile.exe 

Il comando seguente appone una firma digitale a un file usando un certificato archiviato in un file PFX protetto da password.

signtool sign /f MyCert.pfx /p MyPassword /fd SHA256 MyFile.exe 

Il comando seguente firma digitalmente e timestamp un file. Il certificato usato per firmare il file è memorizzato in un file PFX.

signtool sign /f MyCert.pfx /t http://timestamp.digicert.com /fd SHA256 MyFile.exe 

Il comando seguente firma un file usando un certificato contenuto nell'archivio My con nome soggetto My Company Certificate.

signtool sign /n "My Company Certificate" /fd SHA256 MyFile.exe 

Il comando seguente firma uno script di PowerShell e aggiunge metadati autenticati usando le opzioni descrittive dei metadati.

signtool sign /a /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 /InternalName "Contoso.Deploy" /FileVersion "2.1.0" /FileDescription "Contoso deployment script" /Product "Contoso Tools" /ProductVersion "2.1" /OriginalFilename "Deploy.ps1" Deploy.ps1

Il comando seguente usa /sa per aggiungere lo stesso attributo del nome file originale dall'OID.

signtool sign /a /fd SHA256 /sa 1.3.6.1.4.1.311.2.7.6 "Deploy.ps1" Deploy.ps1

Il comando seguente firma un controllo ActiveX e fornisce informazioni visualizzate in un browser quando all'utente viene richiesto di installare il controllo.

signtool sign /f MyCert.pfx /d: "MyControl" /du http://www.example.com/MyControl/info.html /fd SHA256 MyControl.exe 

Il comando seguente contrassegna un file già firmato digitalmente.

signtool timestamp /t http://timestamp.digicert.com MyFile.exe

Il comando seguente contrassegna un file usando un server timestamp RFC 3161.

signtool timestamp /tr http://timestamp.digicert.com /td SHA256 MyFile.exe

Il comando seguente verifica che un file sia stato firmato.

signtool verify MyFile.exe

Il comando seguente verifica un file di sistema che può essere firmato in un catalogo.

signtool verify /a SystemFile.dll

Il comando seguente verifica un file di sistema firmato in un catalogo denominato MyCatalog.cat.

signtool verify /c MyCatalog.cat SystemFile.dll

Il comando seguente rimuove completamente la firma da un file.

signtool remove /s MyFile.exe

Vedi anche