à propos de la signature

Brève description

Explique comment signer des scripts afin qu’ils soient conformes aux stratégies d’exécution PowerShell.

Description longue

Ces informations s’appliquent uniquement à PowerShell s’exécutant sur Windows.

La stratégie d’exécution restreinte n’autorise l’exécution d’aucun script. Les stratégies d’exécution AllSigned et RemoteSigned empêchent PowerShell d’exécuter des scripts qui n’ont pas de signature numérique.

Cette rubrique explique comment exécuter des scripts sélectionnés qui ne sont pas signés, même si la stratégie d’exécution est remoteSignedet comment signer des scripts pour votre propre utilisation.

Pour plus d’informations sur les stratégies d’exécution de PowerShell, consultez about_Execution_Policies.

Pour autoriser l’exécution de scripts signés

Lorsque vous démarrez PowerShell sur un ordinateur pour la première fois, la stratégie d’exécution restreinte, qui est la valeur par défaut, sera probablement en vigueur.

La politique Restreint n’autorise l’exécution d’aucun script.

Pour rechercher la stratégie d’exécution effective sur votre ordinateur, tapez :

Get-ExecutionPolicy

Pour exécuter des scripts non signés que vous écrivez sur votre ordinateur local et des scripts signés d’autres utilisateurs, démarrez PowerShell avec l’option Exécuter en tant qu’administrateur , puis utilisez la commande suivante pour remplacer la stratégie d’exécution sur l’ordinateur par RemoteSigned :

Set-ExecutionPolicy RemoteSigned

Pour plus d’informations, consultez la rubrique d’aide de l’applet de commande Set-ExecutionPolicy.

Exécution de scripts non signés à l’aide de la stratégie d’exécution RemoteSigned

Si votre stratégie d’exécution PowerShell est remoteSigned, PowerShell n’exécute pas de scripts non signés téléchargés à partir d’Internet, y compris les scripts non signés que vous recevez par e-mail et les programmes de messagerie instantanée.

Si vous essayez d’exécuter un script téléchargé, PowerShell affiche le message d’erreur suivant :

The file <file-name> cannot be loaded. The file <file-name> is not
digitally signed. The script will not execute on the system. Please see
"Get-Help about_Signing" for more details.

Avant d’exécuter le script, passez en revue le code pour vous assurer que vous l’approuvez. Les scripts ont le même effet que n’importe quel programme exécutable.

Pour exécuter un script non signé, utilisez l’applet de commande Unblock-File ou utilisez la procédure suivante.

Enregistrez le fichier de script sur votre ordinateur.
Cliquez sur Démarrer, cliquez sur Mon ordinateur, puis recherchez le fichier de script enregistré.
Cliquez avec le bouton droit sur le fichier de script et cliquez sur Propriétés.
Cliquez sur Débloquer.

Si un script téléchargé à partir d’Internet est signé numériquement, mais que vous n’avez pas encore choisi de faire confiance à son éditeur, PowerShell affiche le message suivant :

Do you want to run software from this untrusted publisher?
The file <file-name> is published by CN=<publisher-name>. This
publisher is not trusted on your system. Only run scripts
from trusted publishers.

[V] Never run  [D] Do not run  [R] Run once  [A] Always run
[?] Help (default is "D"):

Si vous faites confiance à l'éditeur, sélectionnez Exécuter une fois ou Toujours exécuter. Si vous n’approuvez pas l’éditeur, sélectionnez Ne jamais exécuter ou Ne pas exécuter. Si vous sélectionnez Ne jamais exécuter ou Toujours exécuter, PowerShell ne vous le redemandera plus pour cet éditeur.

Méthodes de signature de scripts

Vous pouvez signer les scripts que vous écrivez et les scripts que vous obtenez à partir d’autres sources. Avant de signer un script, examinez chaque commande pour vérifier qu’elle est sûre à exécuter.

Pour connaître les meilleures pratiques en matière de signature de code, consultez Code-Signing Bonnes pratiques.

Pour plus d’informations sur la façon de signer un fichier de script, consultez Set-AuthenticodeSignature.

L’applet de commande New-SelfSignedCertificate, introduite dans le module PKI dans PowerShell 3.0, crée un certificat auto-signé approprié pour les tests. Pour plus d’informations, consultez la rubrique d’aide de l’applet de commande New-SelfSignedCertificate.

Pour ajouter une signature numérique à un script, vous devez le signer avec un certificat de signature de code. Deux types de certificats conviennent à la signature d’un fichier de script :

Certificats créés par une autorité de certification : pour des frais, une autorité de certification publique vérifie votre identité et vous donne un certificat de signature de code. Lorsque vous achetez votre certificat auprès d’une autorité de certification fiable, vous pouvez partager votre script avec des utilisateurs sur d’autres ordinateurs exécutant Windows, car ces autres ordinateurs approuvent l’autorité de certification.
Certificats que vous créez : vous pouvez créer un certificat auto-signé pour lequel votre ordinateur est l’autorité qui crée le certificat. Ce certificat est gratuit et vous permet d’écrire, de signer et d’exécuter des scripts sur votre ordinateur. Toutefois, un script signé par un certificat auto-signé ne s’exécutera pas sur d’autres ordinateurs.

En règle générale, vous n’utiliserez un certificat auto-signé que pour signer les scripts que vous écrivez pour votre propre usage et pour signer les scripts que vous obtenez d’autres sources dont vous avez vérifié qu’ils sont sûrs. Il n’est pas approprié pour les scripts qui seront partagés, même au sein d’une entreprise.

Si vous créez un certificat auto-signé, veillez à activer une protection forte de clé privée sur votre certificat. Cela empêche les programmes malveillants de signer des scripts en votre nom. Les instructions sont incluses à la fin de cette rubrique.

Créer un certificat auto-signé

Pour créer un certificat auto-signé, utilisez la cmdlet New-SelfSignedCertificate dans le module PKI. Ce module est introduit dans PowerShell 3.0. Pour plus d’informations, consultez la rubrique d’aide de l’applet de commande New-SelfSignedCertificate.

$params = @{
    Subject = 'CN=PowerShell Code Signing Cert'
    Type = 'CodeSigning'
    CertStoreLocation = 'Cert:\CurrentUser\My'
    HashAlgorithm = 'sha256'
}
$cert = New-SelfSignedCertificate @params

Utilisation de Makecert.exe

Pour créer un certificat auto-signé dans les versions antérieures de Windows, utilisez l’outil de création de certificats MakeCert.exe. Cet outil est inclus dans le Kit de développement logiciel (SDK) Microsoft .NET (versions 1.1 et ultérieures) et dans le Kit de développement logiciel (SDK) Microsoft Windows.

Pour plus d’informations sur la syntaxe et les descriptions des paramètres de l’outil MakeCert.exe, consultez de l'outil de création de certificat (MakeCert.exe).

Pour utiliser l'outil MakeCert.exe pour créer un certificat, exécutez les commandes suivantes dans une fenêtre d’Invite de Commandes SDK.

Remarque

La première commande crée une autorité de certification locale pour votre ordinateur. La deuxième commande génère un certificat personnel à partir de l’autorité de certification. Vous pouvez copier ou taper les commandes exactement comme elles apparaissent. Aucune substitution n’est nécessaire, même si vous pouvez modifier le nom du certificat.

makecert -n "CN=PowerShell Local Certificate Root" -a sha256 `
-eku 1.3.6.1.5.5.7.3.3 -r -sv root.pvk root.cer `
-ss Root -sr localMachine

makecert -pe -n "CN=PowerShell User" -ss MY -a sha256 `
-eku 1.3.6.1.5.5.7.3.3 -iv root.pvk -ic root.cer

L’outil MakeCert.exe vous invite à entrer un mot de passe de clé privée. Le mot de passe garantit qu’aucun utilisateur ne peut utiliser ou accéder au certificat sans votre consentement. Créez et entrez un mot de passe que vous pouvez mémoriser. Vous utiliserez ce mot de passe ultérieurement pour récupérer le certificat.

Pour vérifier que le certificat a été généré correctement, utilisez la commande suivante pour obtenir le certificat dans le magasin de certificats sur l’ordinateur. Vous ne trouverez pas de fichier de certificat dans le répertoire du système de fichiers.

À l’invite PowerShell, tapez :

Get-ChildItem cert:\CurrentUser\my -codesigning

Cette commande utilise le fournisseur de certificats PowerShell pour afficher des informations sur le certificat.

Si le certificat a été créé, la sortie affiche l’empreinte numérique qui identifie le certificat dans un affichage semblable à ce qui suit :

Directory: Microsoft.PowerShell.Security\Certificate::CurrentUser\My

Thumbprint                                Subject
----------                                -------
4D4917CB140714BA5B81B96E0B18AAF2C4564FDF  CN=PowerShell User ]

Signer un script

Après avoir créé un certificat auto-signé, vous pouvez signer des scripts. Si vous utilisez la stratégie d’exécution AllSigned, la signature d’un script vous permet d’exécuter le script sur votre ordinateur.

L’exemple de script suivant, Add-Signature.ps1, effectue la signature d’un script. Toutefois, si vous utilisez la stratégie d’exécution AllSigned, vous devez signer le script Add-Signature.ps1 avant de l’exécuter.

Important

Avant PowerShell 7.2, le script doit être enregistré à l’aide de l’encodage ASCII ou UTF8NoBOM. PowerShell 7.2 et versions ultérieures prend en charge les scripts signés pour n’importe quel format d’encodage.

Pour utiliser ce script, copiez le texte suivant dans un fichier texte et nommez-le Add-Signature.ps1.

## Signs a file
[cmdletbinding()]
param(
    [Parameter(Mandatory=$true)]
    [string] $File
)

$cert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert |
    Select-Object -First 1

Set-AuthenticodeSignature -FilePath $File -Certificate $cert

Pour signer le fichier de script Add-Signature.ps1, tapez les commandes suivantes à l’invite de commandes PowerShell :

$cert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert |
    Select-Object -First 1

Set-AuthenticodeSignature add-signature.ps1 $cert

Après avoir signé le script, vous pouvez l’exécuter sur l’ordinateur local. Toutefois, le script ne s’exécutera pas sur les ordinateurs où la stratégie d’exécution de PowerShell nécessite une signature numérique d’une autorité approuvée. Si vous essayez, PowerShell affiche le message d’erreur suivant :

The file C:\remote_file.ps1 cannot be loaded. The signature of the
certificate cannot be verified.
At line:1 char:15
+ .\ remote_file.ps1 <<<<

Si PowerShell affiche ce message lorsque vous exécutez un script que vous n’avez pas écrit, traitez le fichier comme vous le feriez pour un script non signé. Passez en revue le code pour déterminer si vous pouvez approuver le script.

Activer une protection forte pour votre clé privée

Si vous disposez d’une clé privée et d’un certificat sur votre ordinateur, des programmes malveillants peuvent être en mesure de signer des scripts en votre nom, ce qui autorise PowerShell à les exécuter.

Pour empêcher la signature automatisée en votre nom, utilisez le gestionnaire de certificats Certmgr.exe pour exporter votre clé de signature et votre certificat dans un fichier .pfx. Le Gestionnaire de certificats est inclus dans le Kit de développement logiciel (SDK) Microsoft .NET, le Kit de développement logiciel (SDK) Microsoft Windows et dans Internet Explorer.

Pour exporter le certificat :

Démarrez le Gestionnaire de certificats.
Sélectionnez le certificat émis par la racine des certificats locaux de PowerShell.
Cliquez sur Exporter pour démarrer l’assistant d’exportation de certificat.
Sélectionnez Oui, exportez la clé privée, puis cliquez sur suivant.
Sélectionnez Activer une protection forte.
Tapez un mot de passe, puis tapez-le à nouveau pour confirmer.
Tapez un nom de fichier qui a l’extension de nom de fichier .pfx.
Cliquez sur Terminer.

Pour réimporter le certificat :

Démarrez le Gestionnaire de certificats.
Cliquez sur Import pour démarrer l’Assistant d'importation de certificats.
Ouvrez l’emplacement du fichier .pfx que vous avez créé pendant le processus d’exportation.
Dans la page Mot de passe, sélectionnez Activer une protection forte par clé privée, puis entrez le mot de passe que vous avez affecté pendant le processus d’exportation.
Sélectionnez le magasin de certificats Personnel.
Cliquez sur Terminer.

Empêcher l’expiration de la signature

La signature numérique dans un script est valide jusqu’à ce que le certificat de signature expire ou tant qu’un serveur d’horodatage peut vérifier que le script a été signé pendant que le certificat de signature était valide.

Étant donné que la plupart des certificats de signature sont valides pendant un an uniquement, l’utilisation d’un serveur d’horodatage garantit que les utilisateurs peuvent utiliser votre script pendant de nombreuses années à venir.

Voir aussi

Last updated on 2023-10-23