SslStream.AuthenticateAsClient Метод

Определение

Пространство имен:

System.Net.Security

Сборки:

netstandard.dll, System.Net.Security.dll

Проверка подлинности клиентской стороны подключения к клиентскому серверу.

Перегрузки

Имя	Описание
AuthenticateAsClient(SslClientAuthenticationOptions)	Проверяет подлинность сервера и при необходимости клиента в подключении к клиентскому серверу.
AuthenticateAsClient(String)	Вызывается клиентами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Вызывается клиентами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу. Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол SSL по умолчанию по умолчанию.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Вызывается клиентами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу. Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол SSL.

AuthenticateAsClient(SslClientAuthenticationOptions)

Исходный код:

SslStream.cs

Проверяет подлинность сервера и при необходимости клиента в подключении к клиентскому серверу.

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);

public void AuthenticateAsClient(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);

member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit

Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Параметры

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Контейнер свойств для SSL-подключения.

Исключения

ArgumentNullException

sslClientAuthenticationOptions равно null.

AuthenticationException

Сбой проверки подлинности и оставил этот объект в неиспользуемом состоянии.

InvalidOperationException

Проверка подлинности уже произошла.

–или–

Проверка подлинности сервера, используемая SslStream ранее.

–или–

Проверка подлинности уже выполняется.

ObjectDisposedException

Этот объект был закрыт.

Комментарии

Начиная с .NET Framework 4.7 этот метод проходит проверку подлинности, Noneчто позволяет операционной системе выбирать лучший протокол для использования и блокировать протоколы, которые не защищены. В .NET Framework 4.6 (и .NET Framework 4.5 с установленными последними исправлениями безопасности) допустимые версии протоколов TLS/SSL : 1.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows). В проверке подлинности сертификаты клиента не используются. Список отзыва сертификатов не проверяется во время проверки подлинности. Указанное значение targetHost должно соответствовать имени сертификата сервера.

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.

AuthenticateAsClient(String)

Исходный код:

SslStream.cs

Вызывается клиентами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);

public virtual void AuthenticateAsClient(string targetHost);

abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String)

Параметры

targetHost

String

Имя сервера, который использует этот SslStreamпараметр.

Исключения

ArgumentNullException

targetHost равно null.

AuthenticationException

Сбой проверки подлинности и оставил этот объект в неиспользуемом состоянии.

InvalidOperationException

Проверка подлинности уже произошла.

–или–

Проверка подлинности сервера, используемая SslStream ранее.

–или–

Проверка подлинности уже выполняется.

ObjectDisposedException

Этот объект был закрыт.

Комментарии

Начиная с .NET Framework 4.7 этот метод проходит проверку подлинности, Noneчто позволяет операционной системе выбирать лучший протокол для использования и блокировать протоколы, которые не защищены. В .NET Framework 4.6 (и .NET Framework 4.5 с установленными последними исправлениями безопасности) допустимые версии протоколов TLS/SSL : 1.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows). В проверке подлинности сертификаты клиента не используются. Список отзыва сертификатов не проверяется во время проверки подлинности. Указанное значение targetHost должно соответствовать имени сертификата сервера.

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Исходный код:

SslStream.cs

Вызывается клиентами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу. Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол SSL по умолчанию по умолчанию.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

Параметры

targetHost

String

Имя сервера, который будет делиться этим SslStream.

clientCertificates

X509CertificateCollection

Объект X509CertificateCollection , содержащий сертификаты клиента.

checkCertificateRevocation

Boolean

Значение Boolean , указывающее, проверяется ли список отзыва сертификата во время проверки подлинности.

Комментарии

Начиная с .NET Framework 4.7 этот метод проходит проверку подлинности, Noneчто позволяет операционной системе выбирать лучший протокол для использования и блокировать протоколы, которые не защищены. В .NET Framework 4.6 (и .NET Framework 4.5 с установленными последними исправлениями безопасности) допустимые версии протоколов TLS/SSL : 1.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows).

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.

Замечание

Сертификаты клиента не поддерживаются в протоколе SSL версии 2.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Исходный код:

SslStream.cs

Вызывается клиентами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу. Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол SSL.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Параметры

targetHost

String

Имя сервера, который будет делиться этим SslStream.

clientCertificates

X509CertificateCollection

Объект X509CertificateCollection , содержащий сертификаты клиента.

enabledSslProtocols

SslProtocols

Значение SslProtocols , представляющее протоколы, используемые для проверки подлинности.

checkCertificateRevocation

Boolean

Значение Boolean , указывающее, проверяется ли список отзыва сертификата во время проверки подлинности.

Комментарии

Начиная с .NET Framework 4.7 этот метод проходит проверку подлинности, Noneчто позволяет операционной системе выбирать лучший протокол для использования и блокировать протоколы, которые не защищены. В .NET Framework 4.6 (и .NET Framework 4.5 с установленными последними исправлениями безопасности) допустимые версии протоколов TLS/SSL : 1.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows).

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.

Замечание

Сертификаты клиента не поддерживаются в протоколе SSL версии 2.