SslStream.AuthenticateAsServerAsync Yöntem

Tanım

Ad Alanı:

System.Net.Security

Bütünleştirilmiş Kod:

System.Net.Security.dll

Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için sunucular tarafından çağrılır.

Aşırı Yüklemeler

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)	Belirtilen sertifikaları, gereksinimleri ve güvenlik protokollerini zaman uyumsuz bir işlem olarak kullanarak sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini doğrulamak için sunucular tarafından çağrılır.
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)	Belirtilen sertifikaları, gereksinimleri ve güvenlik protokollerini zaman uyumsuz bir işlem olarak kullanarak sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini doğrulamak için sunucular tarafından çağrılır.
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)	Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için sunucular tarafından çağrılır. Kimlik doğrulama işlemi, özellik paketinde sslClientAuthenticationOptions belirtilen bilgileri kullanır.
AuthenticateAsServerAsync(X509Certificate)	Belirtilen sertifikayı zaman uyumsuz bir işlem olarak kullanarak sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini doğrulamak için sunucular tarafından çağrılır.
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)	Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için sunucular tarafından çağrılır. Kimlik doğrulama işlemi tarafından optionsCallbackdöndürülen bilgileri kullanır.

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

Kaynak:

SslStream.cs

Belirtilen sertifikaları, gereksinimleri ve güvenlik protokollerini zaman uyumsuz bir işlem olarak kullanarak sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini doğrulamak için sunucular tarafından çağrılır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parametreler

serverCertificate

X509Certificate

Sunucunun kimliğini doğrulamak için kullanılan X509Certificate.

clientCertificateRequired

Boolean

Boolean İstemciden kimlik doğrulaması için sertifika istenip istenmediğini belirten bir değer. Bunun yalnızca bir istek olduğunu unutmayın; sertifika sağlanmazsa, sunucu yine de bağlantı isteğini kabul eder.

enabledSslProtocols

SslProtocols

SslProtocols Kimlik doğrulaması için kullanılan protokolleri temsil eden değer.

checkCertificateRevocation

Boolean

Boolean Kimlik doğrulaması sırasında sertifika iptal listesinin denetlenip denetlenmeyeceğini belirten bir değer.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

serverCertificate, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan istemci kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

.NET Framework 4.7'den başlayarak, bu yöntem işletim sisteminin kullanılacak en iyi protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak Nonekimlik doğrulaması yapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme eklerinin yüklü olduğu 4.5 .NET Framework), izin verilen TLS/SSL protokol sürümleri 1.2, 1.1 ve 1.0'dır (Windows Kayıt Defteri'ni düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız sürece).

Kimlik doğrulaması başarısız olursa bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)özel durumlara bakın.

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Kaynak:

SslStream.cs

Belirtilen sertifikaları, gereksinimleri ve güvenlik protokollerini zaman uyumsuz bir işlem olarak kullanarak sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini doğrulamak için sunucular tarafından çağrılır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

Parametreler

serverCertificate

X509Certificate

Sunucunun kimliğini doğrulamak için kullanılan X509Certificate.

clientCertificateRequired

Boolean

Boolean İstemciden kimlik doğrulaması için sertifika istenip istenmediğini belirten bir değer. Bunun yalnızca bir istek olduğunu unutmayın; sertifika sağlanmazsa, sunucu yine de bağlantı isteğini kabul eder.

checkCertificateRevocation

Boolean

Boolean Kimlik doğrulaması sırasında sertifika iptal listesinin denetlenip denetlenmeyeceğini belirten bir değer.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

serverCertificate, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan istemci kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

.NET Framework 4.7'den başlayarak, bu yöntem işletim sisteminin kullanılacak en iyi protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak Nonekimlik doğrulaması yapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme eklerinin yüklü olduğu 4.5 .NET Framework), izin verilen TLS/SSL protokol sürümleri 1.2, 1.1 ve 1.0'dır (Windows Kayıt Defteri'ni düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız sürece).

Kimlik doğrulaması başarısız olursa bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsServer(X509Certificate, Boolean, Boolean)özel durumlara bakın.

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

Kaynak:

SslStream.cs

Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için sunucular tarafından çağrılır. Kimlik doğrulama işlemi, özellik paketinde sslClientAuthenticationOptions belirtilen bilgileri kullanır.

public:
 System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sslServerAuthenticationOptions

SslServerAuthenticationOptions

SSL bağlantısı için özellik paketi.

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

oluşturucuda ServerCertificateSelectionCallbackSslStream veya veya ServerCertificateContextServerCertificate şeklindedir null ve LocalCertificateSelectionCallback ayarlanmaz.

ArgumentNullException

sslServerAuthenticationOptions, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan istemci kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Kimlik doğrulaması başarısız olursa bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsServer(SslServerAuthenticationOptions)özel durumlara bakın.

AuthenticateAsServerAsync(X509Certificate)

Kaynak:

SslStream.cs

Belirtilen sertifikayı zaman uyumsuz bir işlem olarak kullanarak sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini doğrulamak için sunucular tarafından çağrılır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Parametreler

serverCertificate

X509Certificate

Sunucunun kimliğini doğrulamak için kullanılan sertifika.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

serverCertificate, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan istemci kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

PlatformNotSupportedException

AuthenticateAsServerAsync Yöntemi Windows 95, Windows 98 veya Windows Millennium'da desteklenmez.

Açıklamalar

.NET Framework 4.7'den başlayarak, bu yöntem işletim sisteminin kullanılacak en iyi protokolü seçmesini ve güvenli olmayan protokolleri engellemesini sağlayan kullanarak Nonekimlik doğrulaması yapar. .NET Framework 4.6'da (ve en son güvenlik düzeltme eklerinin yüklü olduğu 4.5 .NET Framework), izin verilen TLS/SSL protokol sürümleri 1.2, 1.1 ve 1.0'dır (Windows Kayıt Defteri'ni düzenleyerek güçlü şifrelemeyi devre dışı bırakmadığınız sürece).

Bu yöntem kullanarak Defaultkimlik doğrulaması yapar. Kimlik doğrulaması sırasında sertifika iptal listesi denetlenmiyor. İstemcinin kimlik doğrulaması için bir sertifika sağlaması gerekmez.

Kimlik doğrulaması başarısız olursa bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan AuthenticateAsServer(X509Certificate)özel durumlara bakın.

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Kaynak:

SslStream.cs

Sunucunun ve isteğe bağlı olarak istemci-sunucu bağlantısındaki istemcinin kimliğini zaman uyumsuz bir işlem olarak doğrulamak için sunucular tarafından çağrılır. Kimlik doğrulama işlemi tarafından optionsCallbackdöndürülen bilgileri kullanır.

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

optionsCallback

ServerOptionsSelectionCallback

Geri çağırma temsilcisi.

state

Object

Geri çağırma çağrıldığında geçirilir optionsCallback durum nesnesi.

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

oluşturucuda ServerCertificateSelectionCallbackSslStream veya veya ServerCertificateContextServerCertificate şeklindedir null ve LocalCertificateSelectionCallback ayarlanmaz.

AuthenticationException

Kimlik doğrulaması başarısız oldu ve bu nesneyi kullanılamaz durumda bıraktı.

InvalidOperationException

Kimlik doğrulaması zaten gerçekleşti.

-veya-

Bunu SslStream kullanan istemci kimlik doğrulaması daha önce denendi.

-veya-

Kimlik doğrulaması zaten devam ediyor.

ObjectDisposedException

Bu nesne kapatıldı.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Kimlik doğrulaması başarısız olursa bir AuthenticationExceptionalırsınız ve bu SslStream artık kullanılamaz. Bu nesneyi kapatmanız ve çöp toplayıcı tarafından toplanabilmesi için ona yapılan tüm başvuruları kaldırmanız gerekir.