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 :
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client\DisabledByDefaultdoit exister avec la valeur0.HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client\Enableddoit exister avec la valeur1.
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 :
- La mise à jour Microsoft KB3140245 est installée.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp\DefaultSecureProtocolscontient0x00000A00ou0x00000800.- Sur une machine 64 bits, vérifier la même valeur sous
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp\DefaultSecureProtocols.
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
- Faire confiance à tous les certificats désactive un contrôle de sécurité : à réserver aux tests, jamais aux scripts de production.
- Pour aller plus loin : Force PowerShell to use TLS 1.2 et How to enable TLS 1.2 as the default security protocol on Windows servers.