Bagikan melalui

NegotiateStream.AuthenticateAsClientAsync Metode

  • Referensi

Definisi

Ruang nama:
System.Net.Security
Rakitan:
System.Net.Security.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron.

Overload

AuthenticateAsClientAsync()

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron.
AuthenticateAsClientAsync(NetworkCredential, String)

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial klien yang ditentukan.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial klien yang ditentukan dan pengikatan saluran.
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial dan opsi autentikasi yang ditentukan.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial, opsi autentikasi, dan pengikatan saluran yang ditentukan.

AuthenticateAsClientAsync()

Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron.

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

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

AuthenticationException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

InvalidCredentialException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

ObjectDisposedException

Objek ini telah ditutup.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Aliran ini digunakan sebelumnya untuk mencoba autentikasi sebagai server. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai klien.

Keterangan

Autentikasi menggunakan DefaultCredentialsklien . Tidak ada Nama Prinsipal Layanan (SPN) yang ditentukan untuk server. Tingkat peniruan Identificationadalah , tingkat keamanan adalah EncryptAndSign, dan autentikasi bersama diminta. Kelas NegotiateStream akan membangun SPN yang digunakan untuk autentikasi bersama.

Ketika autentikasi berhasil, Anda harus memeriksa IsEncrypted properti dan IsSigned untuk menentukan layanan keamanan apa yang digunakan oleh NegotiateStream. IsMutuallyAuthenticated Periksa properti untuk menentukan apakah terjadi autentikasi timbul.

Jika autentikasi gagal, Anda menerima AuthenticationException atau InvalidCredentialException. Dalam hal ini, Anda dapat mencoba kembali autentikasi dengan kredensial yang berbeda.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AuthenticateAsClient().

Berlaku untuk

AuthenticateAsClientAsync(NetworkCredential, String)

Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial klien yang ditentukan.

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

Parameter

credential
NetworkCredential

NetworkCredential yang digunakan untuk menetapkan identitas klien.

targetName
String

Nama Prinsipal Layanan (SPN) yang secara unik mengidentifikasi server untuk diautentikasi.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

AuthenticationException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

InvalidCredentialException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

ObjectDisposedException

Objek ini telah ditutup.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Aliran ini digunakan sebelumnya untuk mencoba autentikasi sebagai server. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai klien.

ArgumentNullException

targetNameadalah null.

Keterangan

Tingkat peniruan Identificationadalah , tingkat keamanan adalah EncryptAndSign, dan autentikasi bersama diminta. Kelas NegotiateStream akan membangun SPN yang digunakan untuk autentikasi bersama.

Ketika autentikasi berhasil, Anda harus memeriksa IsEncrypted properti dan IsSigned untuk menentukan layanan keamanan apa yang digunakan oleh NegotiateStream. IsMutuallyAuthenticated Periksa properti untuk menentukan apakah terjadi autentikasi timbul.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AuthenticateAsClient(NetworkCredential, String).

Berlaku untuk

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial klien yang ditentukan dan pengikatan saluran.

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

Parameter

credential
NetworkCredential

NetworkCredential yang digunakan untuk menetapkan identitas klien.

binding
ChannelBinding

ChannelBinding yang digunakan untuk perlindungan yang diperpanjang.

targetName
String

Nama Prinsipal Layanan (SPN) yang secara unik mengidentifikasi server untuk diautentikasi.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

targetNameadalah null.

-atau-

credentialadalah null.

AuthenticationException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

InvalidCredentialException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Aliran ini digunakan sebelumnya untuk mencoba autentikasi sebagai server. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai klien.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

Tingkat peniruan Identificationadalah , tingkat keamanan adalah EncryptAndSign, dan autentikasi bersama diminta. Kelas NegotiateStream akan membangun SPN yang digunakan untuk autentikasi bersama.

yang ChannelBinding digunakan untuk perlindungan diperpanjang yang diteruskan ke metode ini dalam binding parameter akan diambil oleh aplikasi dari TransportContext properti pada yang terkait SslStream.

Ketika autentikasi berhasil, Anda harus memeriksa IsEncrypted properti dan IsSigned untuk menentukan layanan keamanan apa yang digunakan oleh NegotiateStream. IsMutuallyAuthenticated Periksa properti untuk menentukan apakah terjadi autentikasi timbul.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AuthenticateAsClient(NetworkCredential, ChannelBinding, String).

Lihat juga

Berlaku untuk

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial dan opsi autentikasi yang ditentukan.

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

Parameter

credential
NetworkCredential

NetworkCredential yang digunakan untuk menetapkan identitas klien.

targetName
String

Nama Perwakilan Layanan (SPN) yang secara unik mengidentifikasi server untuk diautentikasi.

requiredProtectionLevel
ProtectionLevel

Salah ProtectionLevel satu nilai, menunjukkan layanan keamanan untuk aliran.

allowedImpersonationLevel
TokenImpersonationLevel

Salah TokenImpersonationLevel satu nilai, menunjukkan bagaimana server dapat menggunakan kredensial klien untuk mengakses sumber daya.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentOutOfRangeException

allowedImpersonationLevel bukan nilai yang valid.

ArgumentNullException

targetName adalah null.

AuthenticationException

Autentikasi gagal. Anda bisa menggunakan objek ini untuk mencoba kembali otentikasi.

InvalidCredentialException

Autentikasi gagal. Anda dapat menggunakan objek ini untuk mencoba kembali autentikasi.

ObjectDisposedException

Objek ini telah ditutup.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Aliran ini digunakan sebelumnya untuk mencoba autentikasi sebagai server. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai klien.

Keterangan

requiredProtectionLevel Gunakan parameter untuk meminta layanan keamanan untuk data yang dikirimkan menggunakan aliran yang diautentikasi. Misalnya, agar data dienkripsi dan ditandatangani, tentukan nilainya EncryptAndSign . Autentikasi yang berhasil tidak menjamin bahwa yang diminta ProtectionLevel telah diberikan. Anda harus memeriksa IsEncrypted properti dan IsSigned untuk menentukan layanan keamanan apa yang digunakan oleh NegotiateStream.

Jika autentikasi gagal, Anda menerima AuthenticationException atau InvalidCredentialException. Dalam hal ini, Anda dapat mencoba kembali autentikasi dengan kredensial yang berbeda.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel).

Berlaku untuk

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

Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs
Sumber:
NegotiateStream.cs

Dipanggil oleh klien untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kredensial, opsi autentikasi, dan pengikatan saluran yang ditentukan.

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

Parameter

credential
NetworkCredential

NetworkCredential yang digunakan untuk menetapkan identitas klien.

binding
ChannelBinding

ChannelBinding yang digunakan untuk perlindungan yang diperpanjang.

targetName
String

Nama Perwakilan Layanan (SPN) yang secara unik mengidentifikasi server untuk diautentikasi.

requiredProtectionLevel
ProtectionLevel

Salah ProtectionLevel satu nilai, menunjukkan layanan keamanan untuk aliran.

allowedImpersonationLevel
TokenImpersonationLevel

Salah TokenImpersonationLevel satu nilai, menunjukkan bagaimana server dapat menggunakan kredensial klien untuk mengakses sumber daya.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

targetNameadalah null.

-atau-

credentialadalah null.

ArgumentOutOfRangeException

allowedImpersonationLevel bukan nilai yang valid.

AuthenticationException

Autentikasi gagal. Anda dapat menggunakan objek ini untuk mencoba kembali autentikasi.

InvalidCredentialException

Autentikasi gagal. Anda dapat menggunakan objek ini untuk mencoba kembali autentikasi.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Aliran ini digunakan sebelumnya untuk mencoba autentikasi sebagai server. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai klien.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

requiredProtectionLevel Gunakan parameter untuk meminta layanan keamanan untuk data yang dikirimkan menggunakan aliran yang diautentikasi. Misalnya, agar data dienkripsi dan ditandatangani, tentukan nilainya EncryptAndSign . Autentikasi yang berhasil tidak menjamin bahwa yang diminta ProtectionLevel telah diberikan. Anda harus memeriksa IsEncrypted properti dan IsSigned untuk menentukan layanan keamanan apa yang digunakan oleh NegotiateStream.

yang ChannelBinding digunakan untuk perlindungan yang diperluas yang diteruskan ke metode ini dalam binding parameter akan diambil oleh aplikasi dari TransportContext properti pada yang terkait SslStream.

Jika autentikasi gagal, Anda menerima AuthenticationException atau InvalidCredentialException. Dalam hal ini, Anda dapat mencoba kembali autentikasi dengan kredensial yang berbeda.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel).

Lihat juga

Berlaku untuk