Firmare le informazioni di riferimento dell'interfaccia della riga di comando per i pacchetti VSIX

Articolo
07/26/2024

sign - Strumento Dotnet usato per firmare file e contenitori usando certificati PFX, CER o P7B su disco o da Gestione certificati Windows (WCM), Provider di servizi di crittografia (CSP) o Azure Key Vault.

Importante

L'interfaccia della riga di comando di Sign supporta SHA-256solo , SHA-384e SHA-512 come algoritmi di impronta digitale validi. È possibile usare PowerShell per ottenere le impronte digitali usando: Get-FileHash -Algorithm SHA256 <path to .cer file> | Format-Table -AutoSize

Riepilogo

sign code certificate-store [<PATH(s)>]
    [-cf|--certificate-file <PATH>]
    [-p|--password <PASSWORD>]
    [-cfp|--certificate-fingerprint <SHA>]
    [-csp|--crypto-service-provider <CSPNAME>]
    [-k|--key-container <HASHALGORITHM>]
    [-km|--use-machine-key-container]
    [-d|--description <DESCRIPTION>]
    [-u|--descriptionUrl <URL>]
    [-fd|--file-digest <DIGEST>]
    [-t|--timestamp-url <URL>]
    [-tr|--timestamp-rfc3161 <URL>]
    [-td|--timestamp-digest <DIGEST>]
    [-o|--output <PATH>]
    [-b|--base-directory <wORKINGDIRECTORY>]
    [-f|--force]
    [-m|--max-concurrency <MAXCONCURRENCY>]
    [-fl|--filelist <FILELISTPATH>]

sign code certificate-store -h|--help

Descrizione

Sign CLI è uno strumento Dotnet che firma in modo ricorsivo file e contenitori con un certificato e privato. Il certificato e la chiave privata possono essere ottenuti da un file (PFX, P7B, CER) o da un certificato installato in un archivio certificati fornendo un'impronta SHA-256digitale , SHA-384o SHA-512 . È possibile accedere alle chiavi USB usando un provider di servizi di crittografia (CSP) implementato dal produttore e accessibile dall'archivio certificati.

Installazione

Installare l'interfaccia della riga di comando di Sign globalmente usando dotnet tool install sign --version <version> --global, dove <version> è la versione più recente disponibile in Sign (nuget.org).

Installazione offline dell'interfaccia della riga di comando di Firma

Per gli ambienti isolati è possibile scaricare un pacchetto NuGet dell'interfaccia della riga di comando sign e installarlo usando:

dotnet tool install --global --add-source <path-to-folder> <tool-name> --version <version>

Argomenti

VSIX-paths(s)

Specifica i percorsi del pacchetto VSIX da firmare.

Opzioni

-cf|--certificate-file <PATH>

File PFX, P7B o CER contenente un certificato e potenzialmente una chiave privata.
-p|--password <PASSWORD>

Password facoltativa per il file di certificato.
-cfp|--certificate-fingerprint <SHA>

Impronta digitale SHA-256, SHA-384 o SHA-512 usata per identificare un certificato prima della firma.
-csp|--crypto-service-provider <CSP NAME>

Provider del servizio di crittografia contenente una chiave privata.
-k|--key-container <CONTAINER NAME>]

Nome del contenitore di chiavi private.
-km|--use-machine-key-container]

Usare un contenitore di chiavi private a livello di computer anziché il contenitore a livello di utente predefinito.
-d|--description <DESCRIPTION>

Descrizione del certificato di firma.
-u|--descriptionUrl <URL>

Url della descrizione del certificato di firma.
-fd | --file-digest <DIGEST>

Algoritmo digest con cui eseguire l'hashing del file.
-t|--timestamp-url <URL>

URL del server timestamp RFC 3161. [impostazione predefinita: http://timestamp.acs.microsoft.com/]
-tr | --timestamp-rfc3161 <URL>

Specifica l'URL del server di timestamp RFC 3161.
-td|--timestamp-digest <DIGEST>

Usato con -tr l'opzione per richiedere un algoritmo digest usato dal server timestamp RFC 3161.
-o|--output <PATH>

File di output o cartella se vengono specificati più file. Se omesso, l'input viene sovrascritto.
-b|--base-directory <PATH>

Directory di base per i file di cui eseguire l'override della directory di lavoro.
--f|--force

Sovrascrive una firma, se presente.
-m|--max-concurrency <MAXCONCURRENCY>

Concorrenza massima (il valore predefinito è 4)
-fl | --filelist <PATH>

Percorso del file contenente i percorsi dei file da firmare o escludere dalla firma all'interno del contenitore.
-?|-h|--help

Stampa una descrizione di come usare il comando .

Esempi

Firmare contoso.vsix con un certificato importato nell'archivio certificati utente :

sign contoso.vsix -cfp 24D589...FB9523B36E -d "Constoso VSIX Signature" -u "http://www.contoso.com"

Firmare contoso.vsix con certificato cert.pfx (non protetto da password) usando un'impronta digitale SHA-512:

sign contoso.vsix -cfp A87A6F...894559B981 -cfpa sha512 -cf D:\certificates\cert.pfx -d "Constoso VSIX Signature" -u "http://www.contoso.com"

Firmare contoso.vsix con il certificato cert.pfx (protetto da password):

sign contoso.vsix -s 24D58920B2D24D00A7DF07FB9523B36E -cf cert.pfx -p <password> -d "Constoso VSIX Signature" -u "http://www.contoso.com"

Firmare più pacchetti VSIX: contoso.vsix e tutti i file vsix nella directory specificata con il certificato cert.pfx (non protetto da password):
```
sign *.vsix -s 24D58920B2D24D00A7DF07FB9523B36E -cf cert.pfx -d "Constoso VSIX Signature" -u "http://www.contoso.com"
```

Firmare contoso.vsix con un certificato archiviato in un'unità USB sicura.

sign contoso.vsix -s 24D58920B2D24D00A7DF07FB9523B36E -csp "Microsoft Software Key Storage Provider" -k "NuGetSigning 0B2D249223B36D00A7DF07FB95E24D58" -d "Constoso VSIX Signature" -u "http://www.contoso.com"

Firmare contoso.vsix con un certificato archiviato in un'unità USB sicura e accedere dall'archivio certificati del computer (opzione km).
```
sign contoso.vsix -s 24D58920B2D24D00A7DF07FB9523B36E -csp "Microsoft Software Key Storage Provider" -k "NuGetSigning 0B2D249223B36D00A7DF07FB95E24D58" -km -d "Constoso VSIX Signature" -u "http://www.contoso.com"
```
Nota

Quando -k l'opzione non viene specificata, lo strumento controlla tutti i contenitori nel provider di servizi di configurazione fornito per ottenere un certificato di impronta digitale SHA corrispondente.

Firmare contoso.vsix con un certificato archiviato in un'unità USB sicura specificando l'algoritmo digest del file (-fd), il server timestamp (-t) e un percorso di output personalizzato (-o) per il file VSIX firmato.

sign contoso.vsix -s 24D58920B2D24D00A7DF07FB9523B36E -csp "Microsoft Software Key Storage Provider" -k "NuGetSigning 0B2D249223B36D00A7DF07FB95E24D58" -d "Constoso VSIX Signature" -u "http://www.contoso.com" -t "http://timestamp.acs.microsoft.com/" -fd sha256 -o "ContosoSigned.vsix"

Condividi tramite