daohualiuxiang
/
dotnet
mirror of https://github.com/microsoft/dotnet.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Added ServicePointManager.SecurityProtocol change for 4.7 (#417) 

* Added ServicePointManager.SecurityProtocol change for 4.7

* Corrected some typos
pull/419/head
Ron Petrusha 2017-06-05 08:35:21 -07:00 committed by GitHub
parent 461bd77f5d
commit e4b7be309b
1 changed files with 33 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
Documentation/compatibility/servicepointmanager.securityprotocol-defaults-to-securityprotocoltype.systemdefault.md 100644
View File

@ -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 <xref:System.Net.ServicePointManager.SecurityProtocol?displayProperty=fullName> property is <xref:System.Net.SecurityProtocolType.SystemDefault?displayProperty=fullName>. 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 <xref:System.Net.ServicePointManager.SecurityProtocol?displayProperty=fullName> 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 <xref:System.Net.ServicePointManager.SecurityProtocol?displayProperty=fullName> property.
### Affected APIs
- `P:System.Net.ServicePointManager.SecurityProtocol`
### Category
Networking
<!-- breaking change id: 184 -->