Come configurare la firma digitale degli script PowerShell

Firmare uno script PowerShell serve a due cose: dimostra chi l’ha scritto e garantisce che nessuno l’abbia modificato dopo la firma. Basta cambiare un carattere perché la firma non sia più valida. Con il criterio di esecuzione AllSigned i server eseguono solo script firmati da un editore attendibile, e uno script alterato o scaricato da Internet viene bloccato. Questa guida ottiene un certificato di firma del codice, firma con data e ora, distribuisce la fiducia con una GPO e attiva il criterio.

Prerequisiti: una CA aziendale con AD CS (consigliata) oppure un certificato di firma del codice di una CA pubblica, se gli script escono dall’azienda; permessi per creare GPO; Windows PowerShell 5.1 o PowerShell 7.

1. Ottieni il certificato di firma

Con AD CS, abilita sulla CA il modello Firma codice (o una sua copia con chiave RSA 3072 e il permesso di registrazione solo per gli amministratori degli script), poi richiedi il certificato dall’archivio personale con certmgr.msc. Il certificato va nell’archivio dell’utente che firma, non del computer. La configurazione della CA è in come impostare i servizi certificati Active Directory.

Per una prova in laboratorio basta un certificato autofirmato, che però è attendibile solo dove lo copi a mano:

New-SelfSignedCertificate -Type CodeSigningCert -Subject 'CN=Firma script - Laboratorio' `
    -CertStoreLocation Cert:\CurrentUser\My -KeyAlgorithm RSA -KeyLength 3072

2. Firma lo script

$cert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert |
    Sort-Object NotAfter -Descending | Select-Object -First 1
Set-AuthenticodeSignature -FilePath 'C:\Script\Report.ps1' -Certificate $cert `
    -HashAlgorithm SHA256 -TimestampServer 'http://timestamp.digicert.com'

Il server di marca temporale è importante: certifica che la firma è stata apposta mentre il certificato era valido, così lo script resta valido anche dopo la scadenza del certificato. Senza marca temporale, il giorno in cui il certificato scade tutti gli script firmati smettono di funzionare. Specifica SHA256 in modo esplicito: in Windows PowerShell 5.1 l’algoritmo predefinito può essere SHA1.

Per firmare tutta una cartella:

Get-ChildItem 'C:\Script' -Include *.ps1, *.psm1, *.psd1 -Recurse |
    Set-AuthenticodeSignature -Certificate $cert -HashAlgorithm SHA256 `
        -TimestampServer 'http://timestamp.digicert.com'

La firma va rifatta dopo ogni modifica: inseriscila nel processo di rilascio, per esempio dopo il commit come in come versionare i propri script con Git.

3. Rendi attendibile l’editore

Per AllSigned non basta che la catena del certificato sia valida: il certificato di firma deve trovarsi anche nell’archivio Autori attendibili (Trusted Publishers) dei computer, altrimenti al primo avvio PowerShell chiede se fidarsi. Esporta il certificato senza chiave privata (file .cer) e distribuiscilo con una GPO: Configurazione computer > Criteri > Impostazioni di Windows > Impostazioni di sicurezza > Criteri chiave pubblica > Autori attendibili, Importa. Se usi un certificato autofirmato, importalo anche in Autorità di certificazione radice attendibili.

4. Imposta il criterio di esecuzione

Criterio Cosa esegue
RemoteSigned script locali senza firma; quelli scaricati (con il contrassegno di Internet) solo se firmati
AllSigned solo script firmati da un editore attendibile, anche quelli scritti in locale

Imposta il criterio con una GPO: Configurazione computer > Modelli amministrativi > Componenti di Windows > Windows PowerShell > Attiva l’esecuzione di script, opzione Consenti solo script firmati. Parti dai server di amministrazione e dai server più esposti, non da tutti insieme. Ricorda che il criterio di esecuzione non è un confine di sicurezza (chi ha accesso può avviare PowerShell con -ExecutionPolicy Bypass): serve a evitare esecuzioni accidentali e modifiche non autorizzate, da affiancare a il logging di PowerShell.

5. Gestisci le attività pianificate

Le attività che lanciano script con -ExecutionPolicy Bypass continuano a funzionare anche con AllSigned, perché il parametro scavalca il criterio. Toglilo dalle attività una volta firmati gli script, così anche loro verificano la firma.

Verifica finale: Get-AuthenticodeSignature 'C:\Script\Report.ps1' restituisce Status : Valid con il certificato aziendale e TimeStamperCertificate valorizzato; su un server con criterio AllSigned (Get-ExecutionPolicy -List mostra MachinePolicy AllSigned) lo script firmato parte senza domande, mentre la stessa copia modificata di un solo carattere viene bloccata con l’errore “non è firmato digitalmente” o “hash non valido”.

Approfondisci

Guide correlate

Script PowerShell pronti all'uso

Per capire i concetti

Privacy Policy Cookie Policy