about_Signing

Description courte

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 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 , qui est la valeur par défaut, est susceptible d’être appliquée.

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

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 à partir d’autres utilisateurs, démarrez PowerShell avec l’option Exécuter en tant qu’Administration istrator, puis utilisez la commande suivante pour modifier 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 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 instantanée 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 Unblock-File de commande ou utilisez la procédure suivante.

  1. Enregistrez le fichier de script sur votre ordinateur.
  2. Cliquez sur Démarrer, sur Mon ordinateur et recherchez le fichier de script enregistré.
  3. Cliquez avec le bouton droit sur le fichier de script, puis cliquez sur Propriétés.
  4. 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 ne faites pas confiance à 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 connaître 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 les tests. Pour plus d’informations, consultez la rubrique d’aide de l’applet de New-SelfSignedCertificate commande.

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 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ûr. 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 de commande 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 New-SelfSignedCertificate commande.

$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 MakeCert.exede création de certificats . 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 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.ps1signe un 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

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 Add-Signature.ps1 fichier de script, 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 Certificate Manager Certmgr.exe pour exporter votre clé de signature et votre certificat dans un .pfx fichier. 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 :

  1. Démarrez le Gestionnaire de certificats.
  2. Sélectionnez le certificat émis par la racine du certificat local PowerShell.
  3. Cliquez sur Exporter pour démarrer l’Assistant Exportation de certificat.
  4. Sélectionnez Oui, exporter la clé privée, puis cliquez sur Suivant.
  5. Sélectionnez Activer une protection forte.
  6. Tapez un mot de passe, puis tapez-le à nouveau pour confirmer.
  7. Tapez un nom de fichier qui a l’extension de nom de .pfx fichier.
  8. Cliquez sur Terminer.

Pour réimporter le certificat :

  1. Démarrez le Gestionnaire de certificats.
  2. Cliquez sur Importer pour démarrer l’Assistant Importation de certificat.
  3. Ouvrez l’emplacement du .pfx fichier que vous avez créé pendant le processus d’exportation.
  4. 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 affecté pendant le processus d’exportation.
  5. Sélectionnez le magasin de certificats Personnel.
  6. 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