From e4b7be309bcd09657788123b9c3cff870276bd38 Mon Sep 17 00:00:00 2001 From: Ron Petrusha Date: Mon, 5 Jun 2017 08:35:21 -0700 Subject: [PATCH] Added ServicePointManager.SecurityProtocol change for 4.7 (#417) * Added ServicePointManager.SecurityProtocol change for 4.7 * Corrected some typos --- ...s-to-securityprotocoltype.systemdefault.md | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 Documentation/compatibility/servicepointmanager.securityprotocol-defaults-to-securityprotocoltype.systemdefault.md diff --git a/Documentation/compatibility/servicepointmanager.securityprotocol-defaults-to-securityprotocoltype.systemdefault.md b/Documentation/compatibility/servicepointmanager.securityprotocol-defaults-to-securityprotocoltype.systemdefault.md new file mode 100644 index 0000000..a386637 --- /dev/null +++ b/Documentation/compatibility/servicepointmanager.securityprotocol-defaults-to-securityprotocoltype.systemdefault.md @@ -0,0 +1,33 @@ +## Default value of ServicePointManager.SecurityProtocol is SecurityProtocolType.System.Default + +### Scope +Minor + +### Version Introduced +4.7 + +### Source Analyzer Status +NotPlanned + +### Change Description +Starting with apps that target the .NET Framework 4.7, the default value of the property is . This change allows .NET Framework networking APIs based on SslStream (such as FTP, HTTPS, and SMTP) to inherit the default security protocols from the operating system instead of using hard-coded values defined by the .NET Framework. The default varies by operating system and any custom configuration performed by the system administrator. For information on the default SChannel protocol in each version of the Windows operating system, see [Protocols in TLS/SSL (Schannel SSP)](https://msdn.microsoft.com/library/windows/desktop/mt808159.aspx). + +For applications that target an earlier version of the .NET Framework, the default value of the property depends on the version of the .NET Framework targeted. See [Retargeting Changes in the .NET Framework 4.6](docs.microsoft.com/dotnet/framework/migration-guide/retargeting) for more information. + +- [X] Quirked +- [ ] Build-time break + +### Recommended Action +This change affects applications that target the .NET Framework 4.7 or later versions. + +If you prefer to use a defined protocol rather than relying on the system default, you can explicitly set the value of the property. + +### Affected APIs +- `P:System.Net.ServicePointManager.SecurityProtocol` + +### Category +Networking + + + +