À propos de la signature

Article
06/21/2023

Description courte

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

Description longue

La stratégie d’exécution restreinte n’autorise pas l’exécution de scripts. 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 RemoteSigned et 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 (valeur par défaut) est susceptible d’être appliquée.

La stratégie restreinte n’autorise pas l’exécution de scripts.

Pour trouver 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 modifier la stratégie d’exécution sur l’ordinateur en RemoteSigned :

Set-ExecutionPolicy RemoteSigned

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

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 via des programmes de messagerie électronique et 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, sur Mon ordinateur, puis recherchez le fichier de script enregistré.
Cliquez avec le bouton droit sur le fichier de script, puis 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 d’approuver 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 approuvez 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 invite pas à nouveau 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 obtenir les meilleures pratiques relatives à la signature de code, consultez les meilleures pratiques de signature de code.

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

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

Pour ajouter une signature numérique à un script, vous devez la 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écute pas sur d’autres ordinateurs.

En règle générale, vous utilisez un certificat auto-signé uniquement pour signer des scripts que vous écrivez pour votre propre utilisation et pour signer des scripts que vous obtenez à partir d’autres sources que vous avez vérifiées pour être 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 l’applet New-SelfSignedCertificate de commande dans le module PKI. Ce module est introduit dans PowerShell 3.0 et est inclus dans Windows 8 et Windows Server 2012. Pour plus d’informations, consultez la rubrique d’aide de l’applet de New-SelfSignedCertificate commande.

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

Pour plus d’informations sur la syntaxe et les descriptions des paramètres de l’outil MakeCert.exe, consultez 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.

Remarque : 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 sha1 `
-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 sha1 `
-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 que personne 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 qui ressemble à 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, signe Add-Signature.ps1un script. Toutefois, si vous utilisez la stratégie d’exécution AllSigned , vous devez signer le Add-Signature.ps1 script avant de l’exécuter.

Important

Le script doit être enregistré à l’aide de l’encodage ASCII ou UTF8NoBOM. Vous pouvez signer un fichier de script qui utilise un encodage différent. Mais le script ne parvient pas à s’exécuter ou le module contenant le script ne parvient pas à importer.

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

## Signs a file
param([string] $file=$(throw "Please specify a filename."))
$cert = @(Get-ChildItem cert:\CurrentUser\My -codesigning)[0]
Set-AuthenticodeSignature $file $cert

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

$cert = @(Get-ChildItem cert:\CurrentUser\My -codesigning)[0]
Set-AuthenticodeSignature add-signature.ps1 $cert

Une fois le script signé, vous pouvez l’exécuter sur l’ordinateur local. Toutefois, le script ne s’exécute pas sur les ordinateurs sur lesquels 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 n’importe quel script non signé. Passez en revue le code pour déterminer si vous pouvez approuver le script.

Activer une protection forte de clé privée pour votre certificat

Si vous disposez d’un certificat privé 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 certificate Manager Certmgr.exe pour exporter votre certificat de signature vers un .pfx fichier. Le Gestionnaire de certificats est inclus dans le Kit de développement logiciel (SDK) Microsoft .NET, le Microsoft Windows SDK et dans Internet Explorer.

Pour exporter le certificat :

Démarrez le Gestionnaire de certificats.
Sélectionnez le certificat émis par la racine du certificat local PowerShell.
Cliquez sur Exporter pour démarrer l’Assistant 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 Finish.

Pour réimporter le certificat :

Démarrez le Gestionnaire de certificats.
Cliquez sur Importer pour démarrer l’Assistant Importation de certificat.
Ouvrez l’emplacement du fichier .pfx que vous avez créé pendant le processus d’exportation.
Dans la page Mot de passe, sélectionnez « Activer la protection forte par clé privée », puis entrez le mot de passe que vous avez attribué pendant le processus d’exportation.
Sélectionnez le magasin de certificats personnels.
Cliquez sur Finish.

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.