FAQ: How do I enable TLS 1.2 for ArcGIS Runtime SDK for .NET?
Question
How do I enable TLS 1.2 for ArcGIS Runtime SDK for .NET?
Answer
Esri is committed to building and providing strong security for ArcGIS and helping our customers by using the latest security protocols. We strive to implement the highest industry standards, including TLS for data integrity and network security.
To meet these standards, Esri is making software updates across ArcGIS to support TLS 1.2. As part of improving ArcGIS Online security, Esri is requiring TLS 1.2 connections for ArcGIS Online services. Action is required to ensure continued access to these services.
Note: See the Product Life Cycle pages on the Esri Support site for the support status of each released version of ArcGIS Runtime SDK for .NET.
ArcGIS Runtime SDK for .NET v100.0 - 100.4
TLS 1.2 compatible. Application project configuration and/or code changes may be required, see platform-specific notes below.
- WPF: Update applications to target Microsoft .NET Framework 4.7 or later versions. See Transport Layer Security (TLS) best practices with the .NET Framework.
- Xamarin.Android: See: HttpClient Stack and SSL/TLS Implementation Selector for Android
- Xamarin.iOS: See: HttpClient and SSL/TLS implementation selector for iOS/macOS
ArcGIS Runtime SDK for .NET v100.2.1 and prior versions
Ensure that the application targets .NET framework version 4.6 or later (version 4.7.2 is currently recommended).
Android: TLS 1.2 is not available on Android API 19 when using the Android HttpClient implementation.
The recommended options when choosing Android app project options are:
- HttpClient implementation option: Android
- SSL/TLS implementation option: Native TLS 1.2+
- Minimum Android version option: Android 5.0 (API Level 21 - Lollipop).
The Xamarin.Android HttpClient configuration is under Project Options > Android Options, Advanced Options button.
For more information, see: HttpClient Stack and SSL/TLS Implementation Selector for Android
ArcGIS Runtime SDK for .NET 10.2.7
Application project configuration and/or code changes may be required or TLS 1.2 may not be supported by the platform API, see platform-specific notes below.
- WPF: Update applications to target Microsoft .NET Framework 4.7 or later versions. See Transport Layer Security (TLS) best practices with the .NET Framework
- Windows Store 8.1: TLS 1.2 is not supported.
- Windows Phone 8.1: TLS 1.2 is not supported.
Note: See the Esri Support TLS Page for instructions on how to use TLS 1.2 with other Esri products.
Related Information
- Esri Support TLS Page
- Transport Layer Security (TLS) best practices with the .NET Framework
- Microsoft Download Center: Microsoft .NET Framework 4.7 (Web Installer)
Last Published: 4/8/2021
Article ID: 000019417
Software: ArcGIS Runtime SDK for .NET 100.9, 100.8, 100.7, 100.6, 100.5, 100.4, 100.3, 100.2.1, 100.2.0, 100.10, 100.1.0, 100.0.0, 10.2.7, 10.2.6, 10.2.5, 10.2.4