Imposizione di una versione TLS minima nel SDK per .NET

La versione 4 (V4) di SDK per .NET è disponibile in anteprima! Per visualizzare le informazioni su questa nuova versione in anteprima, consulta la Guida per gli sviluppatori AWS SDK per .NET (anteprima della versione 4).

Tieni presente che la versione 4 dell'SDK è in anteprima, pertanto il suo contenuto è soggetto a modifiche.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

La versione 4 (V4) di SDK per .NET è disponibile in anteprima! Per visualizzare le informazioni su questa nuova versione in anteprima, consulta la Guida per gli sviluppatori AWS SDK per .NET (anteprima della versione 4).

Tieni presente che la versione 4 dell'SDK è in anteprima, pertanto il suo contenuto è soggetto a modifiche.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Per aumentare la sicurezza durante la comunicazione con AWS i servizi, è necessario configurarli SDK per .NET per utilizzare TLS 1.2 o versioni successive.

AWS SDK per .NET utilizza il runtime di.NET sottostante per determinare il protocollo di sicurezza da utilizzare. Per impostazione predefinita, le versioni correnti di.NET utilizzano il protocollo configurato più recente supportato dal sistema operativo. L'applicazione può ignorare questo comportamento SDK, ma non è consigliabile farlo.

.NET Core

Per impostazione predefinita, .NET Core utilizza il protocollo configurato più recente supportato dal sistema operativo. AWS SDK per .NET non fornisce un meccanismo per sovrascrivere questo.

Se si utilizza una versione di.NET Core precedente alla 2.1, si consiglia vivamente di aggiornare la versione di .NET Core.

Vedere quanto segue per informazioni specifiche di ciascun sistema operativo.

Windows

Le distribuzioni moderne di Windows hanno il supporto TLS 1.2 abilitato per impostazione predefinita. Se utilizzi Windows 7 SP1 o Windows Server 2008 R2 SP1, devi assicurarti che il supporto TLS 1.2 sia abilitato nel registro, come descritto in https://learn.microsoft.com/en-us/windows- server/security/tls/tls -registry-settings #tls -12. Se si esegue una distribuzione precedente, è necessario aggiornare il sistema operativo. Per informazioni sul supporto TLS 1.3 in Windows, consulta la documentazione Microsoft più recente per le versioni client o server minime richieste.

macOS

Se si esegue.NET Core 2.1 o versioni successive, TLS 1.2 è abilitato per impostazione predefinita. TLS 1.2 è supportato da OS X Mavericks 10.9 o versioni successive. .NET Core versione 2.1 e successive richiedono versioni più recenti di macOS, come descritto in? https://learn.microsoft.com/en-us/ dotnet/core/install/windows tabs=net80&pivots=os-macos.

Se si utilizza.NET Core 1.0, .NET Core utilizza OpenSSL su macOS, una dipendenza che deve essere installata separatamente. OpenSSL ha aggiunto il supporto per TLS 1.2 nella versione 1.0.1 e ha aggiunto il supporto per TLS 1.3 nella versione 1.1.1.

Linux

.NET Core su Linux richiede OpenSSL, che viene fornito in bundle con molte distribuzioni Linux, ma può anche essere installato separatamente. OpenSSL ha aggiunto il supporto per TLS 1.2 nella versione 1.0.1 e ha aggiunto il supporto per TLS 1.3 nella versione 1.1.1. Se stai usando una versione moderna di.NET Core (2.1 o successiva) e hai installato un gestore di pacchetti, è probabile che sia stata installata una versione più moderna di OpenSSL.

Per essere sicuro, è possibile eseguire openssl version in un terminale e verificare che la versione sia successiva alla 1.0.1.

.NET Framework

Se si esegue una versione moderna di.NET Framework (4.7 o versione successiva) e una versione moderna di Windows (almeno Windows 8 per i client, Windows Server 2012 o versione successiva per i server), TLS 1.2 è abilitato e utilizzato per impostazione predefinita.

Se utilizzi un runtime di.NET Framework che non utilizza le impostazioni del sistema operativo (.NET Framework da 3.5 a 4.5.2), AWS SDK per .NET tenterà di aggiungere il supporto per TLS 1.1 e TLS 1.2 ai protocolli supportati. Se si utilizza .NET Framework 3.5, l'operazione avrà esito positivo solo se è installata la patch appropriata, come segue:

Se l'applicazione è in esecuzione su un nuovo.NET Framework su Windows 7 SP1 o Windows Server 2008 R2 SP1, è necessario assicurarsi che il supporto TLS 1.2 sia abilitato nel registro, come descritto in https://learn.microsoft.com/en-us/windows- server/security/tls/tls -registry-settings #tls -12. Le versioni più recenti di Windows lo hanno abilitato per impostazione predefinita.

Per le best practice dettagliate per l'utilizzo di TLS con.NET Framework, consulta l'articolo di Microsoft all'indirizzo https://learn.microsoft.com/en-us/dotnet/framework/network-programming/tls.

AWS Strumenti per PowerShell

AWS Strumenti per PowerShellusa AWS SDK per .NET per tutte le chiamate ai AWS servizi. Il comportamento dell'ambiente dipende dalla versione di Windows PowerShell in esecuzione, come segue.

Da Windows PowerShell 2.0 a 5.x

Da Windows PowerShell 2.0 a 5.x vengono eseguiti su.NET Framework. È possibile verificare quale runtime .NET (2.0 o 4.0) viene utilizzato PowerShell utilizzando il comando seguente.

$PSVersionTable.CLRVersion

Windows PowerShell 6.0

Windows PowerShell 6.0 e versioni successive funzionano su.NET Core. È possibile verificare quale versione di .NET Core viene utilizzata eseguendo il comando seguente.

[System.Reflection.Assembly]::GetEntryAssembly().GetCustomAttributes([System.Runtime.Versioning.TargetFrameworkAttribute], $true).FrameworkName

Segui le istruzioni fornite in precedenza relative alla AWS SDK per .NET versione pertinente di.NET Core.

Xamarin

Per Xamarin, consulta le istruzioni in -layer-security. https://learn.microsoft.com/en-us/ xamarin/cross-platform/app-fundamentals/transport In sintesi:

Per Android

Per iOS

Per macOS

Unità

È necessario utilizzare Unity 2018.2 o versioni successive e utilizzare il runtime di scripting equivalente .NET 4.x. Puoi impostarlo in Project Settings, Configuration, Player, come descritto in https://docs.unity3d.com/2019.1/Documentation/Manual/ScriptingRuntimeUpgrade.html. Il runtime di scripting equivalente.NET 4.x abilita il supporto TLS 1.2 a tutte le piattaforme Unity che eseguono Mono o CPP. IL2

Browser (per Blazor) WebAssembly

WebAssembly viene eseguito nel browser anziché sul server e utilizza il browser per gestire il traffico HTTP. Pertanto, il supporto TLS è determinato dal supporto del browser.

Blazor WebAssembly, in anteprima per ASP.NET Core 3.1, è supportato solo nei browser che supportano WebAssembly, come descritto in -platforms. https://learn.microsoft.com/en-us/ aspnet/core/blazor/supported Tutti i browser tradizionali supportavano TLS 1.2 prima del supporto. WebAssembly Se questo è il caso del browser, se l'app viene eseguita, può comunicare tramite TLS 1.2.

Consulta la documentazione del tuo browser per ulteriori informazioni e verifiche.