NegotiateStream.AuthenticateAsClientAsync Yöntem

Tanım

Ad Alanı:

System.Net.Security

Bütünleştirilmiş Kod:

System.Net.Security.dll

Bütünleştirilmiş Kod:

System.dll

Bütünleştirilmiş Kod:

netstandard.dll

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

Aşırı Yüklemeler

AuthenticateAsClientAsync()	İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır.
AuthenticateAsClientAsync(NetworkCredential, String)	İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen istemci kimlik bilgilerini kullanır.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)	İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen istemci kimlik bilgilerini ve kanal bağlamasını kullanır.
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen kimlik bilgilerini ve kimlik doğrulama seçeneklerini kullanır.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen kimlik bilgilerini, kimlik doğrulama seçeneklerini ve kanal bağlamasını kullanır.

AuthenticateAsClientAsync()

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync();

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync ();

abstract member AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync () As Task

Döndürülenler

Task

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

Özel durumlar

AuthenticationException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidCredentialException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

ObjectDisposedException

Bu nesne kapatıldı.

InvalidOperationException

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

-veya-

Bu akış daha önce sunucu olarak kimlik doğrulamayı deneme amacıyla kullanılıyordu. İstemci olarak kimlik doğrulamasını yeniden denemek için akışı kullanamazsınız.

Açıklamalar

Kimlik doğrulaması istemcinin DefaultCredentialskullanır. Sunucu için Hizmet Asıl Adı (SPN) belirtilmedi. Kimliğe bürünme düzeyi , Identificationgüvenlik düzeyi ve EncryptAndSignkarşılıklı kimlik doğrulaması istenir. sınıfı, NegotiateStream karşılıklı kimlik doğrulaması için kullanılan SPN'yi oluşturur.

Kimlik doğrulaması başarılı olduğunda, tarafından NegotiateStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

Kimlik doğrulaması başarısız olursa veya InvalidCredentialExceptionalırsınızAuthenticationException. Bu durumda, kimlik doğrulamasını farklı bir kimlik bilgileriyle yeniden deneyebilirsiniz.

AuthenticateAsClientAsync(NetworkCredential, String)

İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen istemci kimlik bilgilerini kullanır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As Task

Parametreler

credential

NetworkCredential

NetworkCredential İstemcinin kimliğini oluşturmak için kullanılan.

targetName

String

Kimlik doğrulaması için sunucuyu benzersiz olarak tanımlayan Hizmet Asıl Adı (SPN).

Döndürülenler

Task

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

Özel durumlar

AuthenticationException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidCredentialException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

ObjectDisposedException

Bu nesne kapatıldı.

InvalidOperationException

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

-veya-

Bu akış daha önce sunucu olarak kimlik doğrulamayı deneme amacıyla kullanılıyordu. İstemci olarak kimlik doğrulamasını yeniden denemek için akışı kullanamazsınız.

ArgumentNullException

targetName, null değeridir.

Açıklamalar

Kimliğe bürünme düzeyi , Identificationgüvenlik düzeyi ve EncryptAndSignkarşılıklı kimlik doğrulaması istenir. sınıfı, NegotiateStream karşılıklı kimlik doğrulaması için kullanılan SPN'yi oluşturur.

Kimlik doğrulaması başarılı olduğunda, tarafından NegotiateStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

İstemciler tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen istemci kimlik bilgilerini ve kanal bağlamasını kullanır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As Task

Parametreler

credential

NetworkCredential

NetworkCredential İstemcinin kimliğini oluşturmak için kullanılan.

binding

ChannelBinding

ChannelBinding Genişletilmiş koruma için kullanılan.

targetName

String

Kimlik doğrulaması için sunucuyu benzersiz olarak tanımlayan Hizmet Asıl Adı (SPN).

Döndürülenler

Task

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

Özel durumlar

ArgumentNullException

targetName, null değeridir.

-veya-

credential, null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidCredentialException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidOperationException

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

-veya-

Bu akış daha önce sunucu olarak kimlik doğrulamayı deneme amacıyla kullanılıyordu. İstemci olarak kimlik doğrulamasını yeniden denemek için akışı kullanamazsınız.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

Kimliğe bürünme düzeyi , Identificationgüvenlik düzeyi ve EncryptAndSignkarşılıklı kimlik doğrulaması istenir. sınıfı, NegotiateStream karşılıklı kimlik doğrulaması için kullanılan SPN'yi oluşturur.

ChannelBinding parametresinde binding bu yönteme geçirilen genişletilmiş koruma için kullanılan, ilişkili SslStreamüzerindeki özelliğinden TransportContext bir uygulama tarafından alınabilir.

Kimlik doğrulaması başarılı olduğunda, tarafından NegotiateStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek için ve IsSigned özelliklerini denetlemeniz gerekir. Karşılıklı kimlik doğrulamasının IsMutuallyAuthenticated gerçekleşip gerçekleşmediğini belirlemek için özelliğini denetleyin.

Ayrıca bkz.

• ChannelBinding
• Genişletilmiş Koruma ile Tümleşik Windows Kimlik Doğrulaması

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

İstemci tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen kimlik bilgilerini ve kimlik doğrulama seçeneklerini kullanır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Parametreler

credential

NetworkCredential

NetworkCredential İstemcinin kimliğini oluşturmak için kullanılan.

targetName

String

Kimlik doğrulaması için sunucuyu benzersiz olarak tanımlayan Hizmet Asıl Adı (SPN).

requiredProtectionLevel

ProtectionLevel

ProtectionLevel Akış için güvenlik hizmetlerini gösteren değerlerden biri.

allowedImpersonationLevel

TokenImpersonationLevel

Sunucunun kaynaklara TokenImpersonationLevel erişmek için istemcinin kimlik bilgilerini nasıl kullanabileceğini gösteren değerlerden biri.

Döndürülenler

Task

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

Özel durumlar

ArgumentOutOfRangeException

allowedImpersonationLevel geçerli bir değer değil.

ArgumentNullException

targetName null değeridir.

AuthenticationException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidCredentialException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

ObjectDisposedException

Bu nesne kapatıldı.

InvalidOperationException

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

-veya-

Bu akış daha önce sunucu olarak kimlik doğrulamayı deneme amacıyla kullanılıyordu. İstemci olarak kimlik doğrulamasını yeniden denemek için akışı kullanamazsınız.

Açıklamalar

requiredProtectionLevel Kimliği doğrulanmış akış kullanılarak iletilen veriler için güvenlik hizmetleri istemek için parametresini kullanın. Örneğin, verilerin şifrelenip imzalanmış olması için değeri belirtin EncryptAndSign . Başarılı kimlik doğrulaması, istenenin ProtectionLevel verildiğini garanti etmez. tarafından NegotiateStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek için ve IsSigned özelliklerini denetlemeniz gerekir.

Kimlik doğrulaması başarısız olursa veya InvalidCredentialExceptionalırsınızAuthenticationException. Bu durumda, kimlik doğrulamasını farklı bir kimlik bilgileriyle yeniden deneyebilirsiniz.

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

İstemci tarafından istemcinin ve isteğe bağlı olarak sunucunun kimliğini doğrulamak için istemci-sunucu bağlantısında zaman uyumsuz bir işlem olarak çağrılır. Kimlik doğrulama işlemi belirtilen kimlik bilgilerini, kimlik doğrulama seçeneklerini ve kanal bağlamasını kullanır.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Parametreler

credential

NetworkCredential

NetworkCredential İstemcinin kimliğini oluşturmak için kullanılan.

binding

ChannelBinding

ChannelBinding Genişletilmiş koruma için kullanılan.

targetName

String

Kimlik doğrulaması için sunucuyu benzersiz olarak tanımlayan Hizmet Asıl Adı (SPN).

requiredProtectionLevel

ProtectionLevel

ProtectionLevel Akış için güvenlik hizmetlerini gösteren değerlerden biri.

allowedImpersonationLevel

TokenImpersonationLevel

Sunucunun kaynaklara TokenImpersonationLevel erişmek için istemcinin kimlik bilgilerini nasıl kullanabileceğini gösteren değerlerden biri.

Döndürülenler

Task

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

Özel durumlar

ArgumentNullException

targetName, null değeridir.

-veya-

credential, null değeridir.

ArgumentOutOfRangeException

allowedImpersonationLevel geçerli bir değer değil.

AuthenticationException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidCredentialException

Kimlik doğrulaması başarısız oldu. Kimlik doğrulamasını yeniden denemek için bu nesneyi kullanabilirsiniz.

InvalidOperationException

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

-veya-

Bu akış daha önce sunucu olarak kimlik doğrulamayı deneme amacıyla kullanılıyordu. İstemci olarak kimlik doğrulamasını yeniden denemek için akışı kullanamazsınız.

ObjectDisposedException

Bu nesne kapatıldı.

Açıklamalar

requiredProtectionLevel Kimliği doğrulanmış akış kullanılarak iletilen veriler için güvenlik hizmetleri istemek için parametresini kullanın. Örneğin, verilerin şifrelenip imzalanmış olması için değeri belirtin EncryptAndSign . Başarılı kimlik doğrulaması, istenenin ProtectionLevel verildiğini garanti etmez. tarafından NegotiateStreamhangi güvenlik hizmetlerinin IsEncrypted kullanıldığını belirlemek için ve IsSigned özelliklerini denetlemeniz gerekir.

ChannelBinding parametresinde binding bu yönteme geçirilen genişletilmiş koruma için kullanılan, ilişkili SslStreamüzerindeki özelliğinden TransportContext bir uygulama tarafından alınabilir.

Kimlik doğrulaması başarısız olursa veya InvalidCredentialExceptionalırsınızAuthenticationException. Bu durumda, kimlik doğrulamasını farklı bir kimlik bilgileriyle yeniden deneyebilirsiniz.

Ayrıca bkz.

• ChannelBinding
• Genişletilmiş Koruma ile Tümleşik Windows Kimlik Doğrulaması