Bagikan melalui

NegotiateStream.AuthenticateAsServerAsync Metode

  • Referensi

Definisi

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

Menangani sisi server autentikasi untuk koneksi server klien sebagai operasi asinkron.

Overload

AuthenticateAsServerAsync()

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

Dipanggil oleh server untuk mengautentikasi klien, dan secara opsional server, dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan kebijakan perlindungan yang diperluas yang ditentukan.
AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

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

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

AuthenticateAsServerAsync()

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync();
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync ();
abstract member AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync () 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.

NotSupportedException

Windows 95 dan Windows 98 tidak didukung.

Keterangan

Autentikasi menggunakan server DefaultCredentials. Tidak ada Nama Prinsipal Layanan (SPN) yang ditentukan untuk server. Tingkat peniruan adalah Identification, dan tingkat keamanannya adalah EncryptAndSign.

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 AuthenticateAsServer().

Berlaku untuk

AuthenticateAsServerAsync(ExtendedProtectionPolicy)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);
abstract member AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (policy As ExtendedProtectionPolicy) As Task

Parameter

policy
ExtendedProtectionPolicy

ExtendedProtectionPolicy yang digunakan untuk perlindungan yang diperpanjang.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentException

CustomChannelBinding dan CustomServiceNames pada kebijakan perlindungan yang diperpanjang yang diteruskan dalam policy parameter adalah 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.

ObjectDisposedException

Objek ini telah ditutup.

PlatformNotSupportedException

Parameter policy diatur ke Always pada platform yang tidak mendukung perlindungan yang diperpanjang.

NotSupportedException

Windows 95 dan Windows 98 tidak didukung.

Keterangan

Autentikasi menggunakan server DefaultCredentials. Tidak ada Nama Prinsipal Layanan (SPN) yang ditentukan untuk server. Tingkat peniruan adalah Identification, dan tingkat keamanannya adalah EncryptAndSign.

policy Jika parameter adalah null, maka kebijakan perlindungan yang diperluas digunakan yang telah PolicyEnforcement diatur ke Never.

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 AuthenticateAsServer(ExtendedProtectionPolicy).

Lihat juga

Berlaku untuk

AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Task

Parameter

credential
NetworkCredential

NetworkCredential yang digunakan untuk membuat identitas server.

requiredProtectionLevel
ProtectionLevel

Salah ProtectionLevel satu nilai, menunjukkan layanan keamanan untuk aliran.

requiredImpersonationLevel
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

credentialadalah null.

ArgumentOutOfRangeException

requiredImpersonationLevel harus Identification, , Impersonationatau Delegation,

AuthenticationException

Autentikasi gagal. Anda bisa menggunakan obyek ini untuk mencoba melakukan r-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 klien. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai server.

NotSupportedException

Windows 95 dan Windows 98 tidak didukung.

Keterangan

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 AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel).

Berlaku untuk

AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Task

Parameter

credential
NetworkCredential

NetworkCredential yang digunakan untuk menetapkan identitas klien.

policy
ExtendedProtectionPolicy

ExtendedProtectionPolicy yang digunakan untuk perlindungan yang diperpanjang.

requiredProtectionLevel
ProtectionLevel

Salah ProtectionLevel satu nilai, menunjukkan layanan keamanan untuk aliran.

requiredImpersonationLevel
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

ArgumentException

CustomChannelBinding dan CustomServiceNames pada kebijakan perlindungan yang diperpanjang yang diteruskan dalam policy parameter adalah null.

ArgumentNullException

credentialadalah null.

ArgumentOutOfRangeException

requiredImpersonationLevel harus Identification, , Impersonationatau Delegation,

AuthenticationException

Autentikasi gagal. Anda bisa menggunakan obyek ini untuk mencoba melakukan r-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 klien. Anda tidak dapat menggunakan aliran untuk mencoba kembali autentikasi sebagai server.

ObjectDisposedException

Objek ini telah ditutup.

PlatformNotSupportedException

Parameter policy diatur ke Always pada platform yang tidak mendukung perlindungan yang diperpanjang.

NotSupportedException

Windows 95 dan Windows 98 tidak didukung.

Keterangan

policy Jika parameternya adalah null, maka kebijakan perlindungan yang diperluas digunakan yang telah PolicyEnforcement diatur ke Never.

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 timbal balik.

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 AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel).

Lihat juga

Berlaku untuk