LLI Wiki — My Digital Knowledge Base

PowerShell : forcer TLS 1.2 (erreur « unexpected error occurred on a send »)

Vérifier et forcer TLS 1.2 dans PowerShell et .NET, contrôler le registre SCHANNEL/WinHTTP et ignorer les certificats en test.

Sur les anciens systèmes Windows, Invoke-WebRequest et les cmdlets similaires peuvent échouer avec « The underlying connection was closed: An unexpected error occurred on a send », car PowerShell ne négocie pas TLS 1.2 par défaut. Cette page montre comment vérifier et forcer le protocole, rendre TLS 1.2 par défaut et, en dernier recours, ignorer la validation des certificats.

Lister les protocoles pris en charge

# Get the BaseType of Net.SecurityProtocolType
PS> [Net.SecurityProtocolType]

IsPublic IsSerial Name                               BaseType
-------- -------- ----                               --------
True     True     SecurityProtocolType               System.Enum

# Get the PowerShell supported TLS versions
PS> [enum]::GetNames([Net.SecurityProtocolType])

SystemDefault
Ssl3
Tls
Tls11
Tls12

Afficher le protocole actuellement utilisé :

[Net.ServicePointManager]::SecurityProtocol

Correctif rapide pour la session en cours

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Invoke-WebRequest -Uri https://example.com/

Les autres protocoles se forcent de la même façon :

# Force PowerShell to use TLS 1.1
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls11

# Force PowerShell to use TLS 1.0
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls

TLS 1.3 ne peut pas être défini ainsi sur ces versions : la valeur Tls13 n'existe pas dans l'énumération et l'affectation échoue avec une erreur qui liste les valeurs valides (SystemDefault, Ssl3, Tls, Tls11, Tls12).

Rendre TLS 1.2 par défaut pour les applications .NET

La valeur SchUseStrongCrypto fait utiliser par défaut des protocoles forts aux applications .NET Framework 4.x. Importer ce contenu .reg (la seconde clé couvre les applications 32 bits sur un système 64 bits) :

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
"SchUseStrongCrypto"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319]
"SchUseStrongCrypto"=dword:00000001

L'outil IIS Crypto permet aussi d'activer et désactiver protocoles et suites de chiffrement sur les serveurs Windows. Windows Management Framework 5.1 peut être installé depuis la page de téléchargement Microsoft sur les systèmes qui ont besoin d'un PowerShell plus récent.

Vérifier que TLS 1.2 est activé

Dans le registre SCHANNEL :

Sur Windows Server 2008 R2, Windows Server 2012 et Windows 7, vérifier aussi que TLS 1.2 est le protocole sécurisé par défaut de WinHTTP :

Ignorer la validation des certificats

Lorsqu'un point d'accès distant utilise un certificat qui ne peut pas être validé, exécuter ce fragment avant les appels distants :

add-type @"
    using System.Net;
    using System.Security.Cryptography.X509Certificates;
    public class TrustAllCertsPolicy : ICertificatePolicy {
        public bool CheckValidationResult(
            ServicePoint srvPoint, X509Certificate certificate,
            WebRequest request, int certificateProblem) {
            return true;
        }
    }
"@
[System.Net.ServicePointManager]::CertificatePolicy = New-Object TrustAllCertsPolicy

Remarques

Mastodon LLIMastodon SocialFosstodon