Add documentation for missing ssl bits

[aik-jahoda]

Summary

M:System.Net.Security.SslCertificateTrust.CreateForX509Collection(System.Security.Cryptography.X509Certificates.X509Certificate2Collection,System.Boolean)
M:System.Net.Security.SslCertificateTrust.CreateForX509Store(System.Security.Cryptography.X509Certificates.X509Store,System.Boolean)
M:System.Net.Security.SslStream.NegotiateClientCertificateAsync(System.Threading.CancellationToken)
M:System.Net.Security.SslStreamCertificateContext.Create(System.Security.Cryptography.X509Certificates.X509Certificate2,System.Security.Cryptography.X509Certificates.X509Certificate2Collection,System.Boolean,System.Net.Security.SslCertificateTrust)

part of dotnet/runtime#54857

[opbld32]

Docs Build status updates of commit 4378c4a:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
xml/System.Net.Security/SslStreamCertificateContext.xml	❌Error		Details
	❌Error		Details

xml/System.Net.Security/SslStreamCertificateContext.xml

• Line 0, Column 0: [Error-ECMA2Yaml_InternalError]

Intenal Several Error: System.Xml.XmlException: The 'exception' start tag on line 122 position 10 does not match the end tag of 'Docs'. Line 123, position 9.
   at System.Xml.XmlTextReaderImpl.Throw(Exception e)
   at System.Xml.XmlTextReaderImpl.Throw(String res, String[] args)
   at System.Xml.XmlTextReaderImpl.ThrowTagMismatch(NodeData startTag)
   at System.Xml.XmlTextReaderImpl.ParseEndElement()
   at System.Xml.XmlTextReaderImpl.ParseElementContent()
   at System.Xml.Linq.XContainer.ReadContentFrom(XmlReader r)
   at System.Xml.Linq.XDocument.Load(XmlReader reader, LoadOptions options)
   at System.Xml.Linq.XDocument.Parse(String text, LoadOptions options)
   at ECMA2Yaml.ECMALoader.LoadType(FileItem typeFile)
   at ECMA2Yaml.ECMALoader.LoadTypes(String basePath, Namespace ns)

• Line 0, Column 0: [Error-ECMA2Yaml_File_LoadFailed] Failed to load 1 files, aborting...

For more details, please refer to the build report.

If you see build warnings/errors with permission issues, it might be due to single sign-on (SSO) enabled on Microsoft's GitHub organizations. Please follow instructions here to re-authorize your GitHub account to Docs Build.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

Note: Your PR may contain errors or warnings unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[aik-jahoda]

@wfurt can you please provide description for this param?

[wfurt]

If the is set to true server will send list of trusted CAs during TLS Handshake. This is used to guide client to select appropriate client certificate.

Now, this has many caveats and we should put some big warnings about it: 1. In 6,0 it works only on Windows - we cut out macOS and Linux. 2) on Windows it depends on registry setting.

Since this increases size of the handshake message and can be viewed as info leak about system configuration, this should be off unless there is specific reason. e.g. it would be nice to have some warning like "don't use it unless you know what you are doing".

[carlossanlop]

@wfurt would you mind providing these comments as suggestions? Both for the empty <param> and for the <remarks> section below with all those caveats you mentioned.

[gewarren]

I already did that in my review.

[bartonjs]

It doesn't return a collection of certificates, it returns the trust policy thing.

[carlossanlop]

Yep, it returns an object of this file's Type. So in that case, the <returns> value should start similarl to the suggestion you provided here, right?:
https://github.com/dotnet/dotnet-api-docs/pull/7136/files#r706271785

[opbld30]

Docs Build status updates of commit 0a968a0:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Security/SslCertificateTrust.xml	✅Succeeded	View
xml/System.Net.Security/SslStream.xml	✅Succeeded	View
xml/System.Net.Security/SslStreamCertificateContext.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld31]

Docs Build status updates of commit c097ec7:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Security/SslCertificateTrust.xml	✅Succeeded	View
xml/System.Net.Security/SslStream.xml	✅Succeeded	View
xml/System.Net.Security/SslStreamCertificateContext.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld31]

Docs Build status updates of commit 0c636e3:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Security/SslCertificateTrust.xml	✅Succeeded	View
xml/System.Net.Security/SslStream.xml	✅Succeeded	View
xml/System.Net.Security/SslStreamCertificateContext.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld30]

Docs Build status updates of commit 0c636e3:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Security/SslCertificateTrust.xml	✅Succeeded	View
xml/System.Net.Security/SslStream.xml	✅Succeeded	View
xml/System.Net.Security/SslStreamCertificateContext.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld31]

Docs Build status updates of commit b805c07:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Security/SslCertificateTrust.xml	✅Succeeded	View
xml/System.Net.Security/SslStream.xml	✅Succeeded	View
xml/System.Net.Security/SslStreamCertificateContext.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel