Najlepsze rozwiązania dotyczące protokołu Transport Layer Security (TLS) w programie .NET Framework

Program .NET Framework obsługuje używanie protokołu Transport Layer Security (TLS) do zabezpieczania komunikacji sieciowej.

Co to jest protokół Transport Layer Security (TLS)?

Protokół Transport Layer Security (TLS) to najnowsza wersja standardu przeznaczona do ochrony prywatności informacji przekazywanych przez Internet. Protokół TLS 1.3 jest standardem, który zapewnia ulepszenia zabezpieczeń w porównaniu z poprzednimi wersjami. W tym artykule przedstawiono zalecenia dotyczące zabezpieczania aplikacji .NET Framework korzystających z protokołu TLS.

Kto może skorzystać z tego dokumentu?

• Bezpośrednio przy użyciu API System.Net (na przykład System.Net.Http.HttpClient i System.Net.Security.SslStream).
• Bezpośrednie użycie klientów i usług WCF w przestrzeni nazw System.ServiceModel.

Obsługa protokołu TLS w programie .NET Framework

Ponieważ program .NET Framework jest zależny od Schannel systemu Windows, które wersje można negocjować, a która wersja będzie używana, zależy od systemu operacyjnego.

Oto zaktualizowana przykładowa tabela przedstawiająca najbardziej obsługiwaną wersję protokołu TLS dla różnych kombinacji wersji systemu operacyjnego i wersji docelowych programu .NET Framework:

Aby uzyskać więcej informacji, zobacz Obsługa wersji protokołu TLS w usłudze Schannel.

Zalecenia

• Dla TLS 1.3 należy korzystać z .NET Framework 4.8 lub nowszej. Sprawdź sekcję Audit your code (Przeprowadź inspekcję kodu ), jak zweryfikować plik target framework.
• Nie należy jawnie określać wersji protokołu TLS, tj. nie używaj przeciążeń metody SslStream, które akceptują parametr SslProtocols.
  • Dzięki temu kod pozwoli systemowi operacyjnemu zdecydować o wersji protokołu TLS.
  • Jeśli musisz ustawić wartość ServicePointManager.SecurityProtocol, ustaw ją na SecurityProtocolType.SystemDefault. Będzie również używać domyślnego systemu operacyjnego.
  • Jeśli musisz użyć przeciążeń SslStream metody, które przyjmują jawny SslProtocols parametr, należy przekazać SslProtocols.SystemDefault jako argument. Będzie również używać domyślnego systemu operacyjnego.
• Wykonaj dokładną inspekcję kodu, aby sprawdzić, czy nie określasz jawnie wersji protokołu TLS lub SSL.

Gdy aplikacja umożliwia systemowi operacyjnemu wybranie wersji protokołu TLS:

• Automatycznie korzysta z nowych protokołów TLS dodanych w przyszłości.
• System operacyjny blokuje protokoły, które nie są wykrywane jako bezpieczne (na przykład SSL3 i TLS 1.0).

W tym artykule wyjaśniono, jak włączyć najsilniejsze zabezpieczenia dostępne dla wersji programu .NET Framework przeznaczonej dla aplikacji i jej działania. Gdy aplikacja jawnie ustawia protokół zabezpieczeń i wersję, rezygnuje z innej alternatywy i rezygnuje z domyślnego zachowania programu .NET Framework i systemu operacyjnego. Jeśli chcesz, aby aplikacja mogła negocjować połączenie TLS 1.3, jawne ustawienie na niższą wersję protokołu TLS uniemożliwia połączenie TLS 1.3.

Jeśli nie możesz jawnie określić wersji protokołu, zdecydowanie zalecamy określenie protokołu TLS 1.2 lub TLS 1.3 (czyli currently considered secure). Aby uzyskać wskazówki dotyczące identyfikowania i usuwania zależności protokołu TLS 1.0, pobierz oficjalny dokument Rozwiązywanie problemów z protokołem TLS 1.0.

Program WCF obsługuje protokół TLS 1.2 jako domyślny w programie .NET Framework 4.7. Począwszy od programu .NET Framework 4.7.1, domyślnie program WCF jest w wersji skonfigurowanej przez system operacyjny. Jeśli aplikacja jest jawnie skonfigurowana za pomocą SslProtocols.None, program WCF używa domyślnego ustawienia systemu operacyjnego podczas korzystania z transportu NetTcp.

Pytania dotyczące tego dokumentu można zadać w GitHub Issue Transport Layer Security (TLS) Best Practices with the .NET Framework.

Inspekcja kodu i wprowadzanie zmian w kodzie

W przypadku aplikacji ASP.NET sprawdź <system.web><httpRuntime targetFramework> element web.config , aby sprawdzić, czy używasz docelowej wersji programu .NET Framework.

Aby zapoznać się z formularzami systemu Windows i innymi aplikacjami, zobacz How to: Target a Version of the .NET Framework (Instrukcje: określanie wersji docelowej wersji programu .NET Framework).

Skorzystaj z poniższych sekcji, aby sprawdzić, czy nie używasz określonej wersji protokołu TLS ani SSL.

Jawne ustawianie protokołu zabezpieczeń

Jeśli musisz jawnie ustawić protokół zabezpieczeń zamiast zezwalać na wybranie protokołu zabezpieczeń platformy .NET lub systemu operacyjnego, wybierz następujące protokoły:

• W przypadku programu .NET Framework 3.5: TLS 1.2
• W przypadku programu .NET Framework 4.6.2 lub nowszego: TLS 1.3

Jeśli nie możesz znaleźć wskazanych protokołów w wyliczeniu, możesz dodać je w pliku rozszerzenia. Sprawdź poniżej:

SslProtocolExtensions.cs

namespace System.Security.Authentication
{
    public static class SslProtocolsExtensions
    {
        // For .NET Framework 3.5
        public const SslProtocols Tls12 = (SslProtocols)3072;
        // For .NET Framework 4.6.2 and later
        public const SslProtocols Tls13 = (SslProtocols)12288;
    }
}

SecurityProtocolExtensions.cs

using System.Security.Authentication;

namespace System.Net
{
    public static class SecurityProtocolTypeExtensions
    {
        // For .NET Framework 3.5
        public const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;
        // For .NET Framework 4.6.2 and later
        public const SecurityProtocolType Tls13 = (SecurityProtocolType)SslProtocolsExtensions.Tls13;
    }
}

Aby uzyskać więcej informacji, zobacz Support for TLS System Default Versions included in .NET Framework 3.5 on Windows 8.1 and Windows Server 2012 R2 (Obsługa domyślnych wersji systemu TLS w programie .NET Framework 3.5 w systemach Windows 8.1 i Windows Server 2012 R2).

W przypadku interfejsów API System.Net (HttpClient, SslStream)

W poniższych sekcjach pokazano, jak skonfigurować aplikację tak, aby korzystała z "obecnie uważanych za bezpieczne wersje" protokołu TLS (tj. TLS 1.2 i TLS 1.3), jeśli jest przeznaczona dla platformy .NET Framework 4.7 lub nowszej.

Dla HttpClient i HttpWebRequest

ServicePointManager używa domyślnego protokołu zabezpieczeń skonfigurowanego w systemie operacyjnym. Aby uzyskać domyślny wybór systemu operacyjnego, jeśli to możliwe, nie ustawiaj wartości dla ServicePointManager.SecurityProtocol właściwości , która domyślnie ma wartość SecurityProtocolType.SystemDefault.

Ponieważ ustawienie SecurityProtocolType.SystemDefault powoduje, że ServicePointManager używa domyślnego protokołu zabezpieczeń skonfigurowanego przez system operacyjny, aplikacja może działać inaczej, w zależności od systemu operacyjnego, na którym jest uruchomiona. Na przykład system Windows 10 używa protokołu TLS 1.2, podczas gdy system Windows 11 używa protokołu TLS 1.3.

Dla protokołu SslStream

SslStream domyślnie jest używany protokół zabezpieczeń i wersja wybrana przez system operacyjny. Aby w miarę możliwości uzyskać najlepszy wybór domyślnego systemu operacyjnego, nie używaj przeciążeń metody SslStream, które przyjmują parametr SslProtocols w sposób jawny. W przeciwnym razie przekaż SslProtocols.None. Zalecamy, aby nie używać Default; ustawienie SslProtocols.Default wymusza użycie protokołu SSL 3.0 /TLS 1.0 i uniemożliwia użycie protokołu TLS 1.2.

Nie ustawiaj wartości dla SecurityProtocol właściwości (dla sieci HTTP).

Nie używaj przeciążeń metody SslStream przyjmujących jawny parametr SslProtocols (dla sieci gniazd TCP). Podczas dostosowania docelowej platformy aplikacji do .NET Framework w wersji 4.7 lub nowszej będziesz przestrzegać rekomendacji dotyczących najlepszych praktyk.

W przypadku aplikacji WCF

W poniższych sekcjach pokazano, jak skonfigurować aplikację do używania "obecnie uważanych za bezpieczne wersje" protokołu TLS (tj. TLS 1.2 i TLS 1.3).

Konfigurowanie zabezpieczeń za pomocą przełączników AppContext

Przełączniki AppContext opisane w tej sekcji są istotne, jeśli aplikacja jest skierowana na .NET Framework 4.6.2 lub nowszą wersję i działa na tej platformie. Czy to domyślnie, czy też przez ich jawne ustawienie, przełączniki powinny być ustawione jako false, o ile to możliwe. Jeżeli zamierzasz skonfigurować zabezpieczenia za pomocą jednego lub obu przełączników, nie określaj wartości protokołu zabezpieczeń w swoim kodzie; takie działanie spowoduje zastąpienie ustawień przełączników.

Konfigurowanie protokołów Schannel w rejestrze systemu Windows

Rejestru można użyć do precyzyjnej kontroli nad protokołami negocjowanych przez klienta lub aplikację serwera. Sieć aplikacji przechodzi przez usługę Schannel (czyli inną nazwę bezpiecznego kanału). Konfigurując Schannel, można skonfigurować zachowanie aplikacji.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols Zacznij od klucza rejestru. W tym kluczu można utworzyć wszystkie podklucze w zestawie TLS 1.2, TLS 1.3. W każdym z tych podklucza można tworzyć podklucze Client i/lub Server. W obszarze Client i Server można utworzyć wartości DWORD, DisabledByDefault (0 lub 1) i Enabled (0 lub 1).

Aby uzyskać więcej informacji, zobacz: Ustawienia rejestru TLS — Schannel

Flaga SCH_USE_STRONG_CRYPTO

Po włączeniu (domyślnie, lub przez przełącznik), program .NET Framework używa flagi , gdy twoja aplikacja nawiązuje połączenie TLS z serwerem. Program .NET Framework przekazuje flagę do Schannel, aby wyłączyła znane słabe algorytmy kryptograficzne, zestawy szyfrowania i wersje protokołu TLS/SSL, które mogą być inaczej włączone w celu lepszej kompatybilności. Aby uzyskać więcej informacji, zobacz:

• Bezpieczny kanał
• struktura SCHANNEL_CRED

Flaga SCH_USE_STRONG_CRYPTO jest również przekazywana do Schannel dla połączeń klienta (wychodzących), gdy jawnie używasz wyliczonych wartości Tls11 lub Tls12 z SecurityProtocolType lub SslProtocols. Flaga SCH_USE_STRONG_CRYPTO jest używana tylko w przypadku połączeń, w których aplikacja pełni rolę klienta. Słabe protokoły i algorytmy można wyłączyć, gdy aplikacje pełnią rolę serwera, konfigurując ustawienia rejestru całego Schannel komputera.