No s'ha pogut crear un canal segur SSL/TLS

Problema

En executar un script de PowerShell que utilitza Invoke-WebRequest, pot aparèixer l’error següent:

Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel.

Això ocorre perquè l’script intenta connectar-se a un servidor mitjançant protocols segurs (TLS/SSL), però els protocols requerits (com TLS 1.2) no estan habilitats al sistema.

Solucions

Temporal
Permanent

Per solucionar ràpidament aquest problema a la sessió actual, podeu habilitar els protocols necessaris executant l’ordre següent a la vostra sessió de PowerShell:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls11 -bor ` [Net.SecurityProtocolType]::Tls12 -bor ` [Net.SecurityProtocolType]::Tls -bor ` [Net.SecurityProtocolType]::Ssl3

Tanmateix, aquesta solució és temporal i s’ha de reaplicar a cada nova sessió de PowerShell.

Per resoldre aquest problema de manera permanent i assegurar-vos que totes les aplicacions basades en .NET, inclòs PowerShell, utilitzin protocols segurs per defecte, actualitzeu el registre del sistema.

Passos per solucionar-ho:

Obriu una sessió elevada de PowerShell (Executa com a administrador).
Executeu les ordres següents per actualitzar el registre:

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319" -Name "SchUseStrongCrypto" -Value 1 -Type DWord 
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319" -Name "SystemDefaultTlsVersions" -Value 1 -Type DWord

Apliqueu també els canvis a la clau de registre del .NET Framework de 64 bits:

Set-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319" -Name "SchUseStrongCrypto" -Value 1 -Type DWord 
Set-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319" -Name "SystemDefaultTlsVersions" -Value 1 -Type DWord

Reinicieu el sistema perquè els canvis tinguin efecte.

Explicació de les claus de registre

Configuració del registre	Descripció
SchUseStrongCrypto	Força el .NET Framework a utilitzar protocols criptogràfics forts (p. ex., TLS 1.2).
SystemDefaultTlsVersions	Garanteix que les aplicacions .NET utilitzen la versió de TLS predeterminada del sistema, permetent-los adaptar-se a protocols més nous.

Si l’error persisteix

Si l’error persisteix, considereu les accions següents per assegurar connexions segures per a totes les aplicacions .NET sense requerir intervenció manual a cada sessió:

Assegureu-vos que el vostre sistema admeti TLS 1.2 i que estigui habilitat al sistema operatiu.
Actualitzeu a PowerShell Core o PowerShell 7, que utilitzen protocols de seguretat moderns per defecte.

Instal·lar les eines de monitoratge

Monitoritzar

Guies pràctiques

Resolució de problemes

No s'ha pogut crear un canal segur SSL/TLS

Problema

Solucions

Passos per solucionar-ho:

Explicació de les claus de registre

Si l’error persisteix

​Problema

​Solucions

​Passos per solucionar-ho:

​Explicació de les claus de registre

​Si l’error persisteix

Problema

Solucions

Passos per solucionar-ho:

Explicació de les claus de registre

Si l’error persisteix