SslStream.AuthenticateAsServerAsync Metode

Definisi

Ruang nama:

System.Net.Security

Rakitan:

System.Net.Security.dll

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

Overload

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat, persyaratan, dan protokol keamanan yang ditentukan sebagai operasi asinkron.
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat, persyaratan, dan protokol keamanan yang ditentukan sebagai operasi asinkron.
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan informasi yang ditentukan dalam sslClientAuthenticationOptions tas properti.
AuthenticateAsServerAsync(X509Certificate)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat yang ditentukan sebagai operasi asinkron.
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan informasi yang dikembalikan oleh optionsCallback.

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

Sumber:

SslStream.cs

Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat, persyaratan, dan protokol keamanan yang ditentukan sebagai operasi asinkron.

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

Parameter

serverCertificate

X509Certificate

X509Certificate digunakan untuk mengautentikasi server.

clientCertificateRequired

Boolean

Boolean Nilai yang menentukan apakah klien dimintai sertifikat untuk autentikasi. Perhatikan bahwa ini hanya permintaan -- jika tidak ada sertifikat yang disediakan, server masih menerima permintaan koneksi.

enabledSslProtocols

SslProtocols

Nilai SslProtocols yang mewakili protokol yang digunakan untuk autentikasi.

checkCertificateRevocation

Boolean

Boolean Nilai yang menentukan apakah daftar pencabutan sertifikat diperiksa selama autentikasi.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi klien yang menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

Dimulai dengan .NET Framework 4.7, metode ini mengautentikasi menggunakan None, yang memungkinkan sistem operasi untuk memilih protokol terbaik untuk digunakan, dan untuk memblokir protokol yang tidak aman. Dalam .NET Framework 4.6 (dan .NET Framework 4.5 dengan patch keamanan terbaru yang diinstal), versi protokol TLS/SSL yang diizinkan adalah 1.2, 1.1, dan 1.0 (kecuali Anda menonaktifkan kriptografi yang kuat dengan mengedit Windows Registry).

Jika autentikasi gagal, Anda menerima AuthenticationException, dan ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi ke objek tersebut sehingga dapat dikumpulkan oleh pengumpul sampah.

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(X509Certificate, Boolean, SslProtocols, Boolean).

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Sumber:

SslStream.cs

Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat, persyaratan, dan protokol keamanan yang ditentukan sebagai operasi asinkron.

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

Parameter

serverCertificate

X509Certificate

X509Certificate digunakan untuk mengautentikasi server.

clientCertificateRequired

Boolean

Boolean Nilai yang menentukan apakah klien dimintai sertifikat untuk autentikasi. Perhatikan bahwa ini hanya permintaan -- jika tidak ada sertifikat yang disediakan, server masih menerima permintaan koneksi.

checkCertificateRevocation

Boolean

Boolean Nilai yang menentukan apakah daftar pencabutan sertifikat diperiksa selama autentikasi.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi klien yang menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

Dimulai dengan .NET Framework 4.7, metode ini mengautentikasi menggunakan None, yang memungkinkan sistem operasi untuk memilih protokol terbaik untuk digunakan, dan untuk memblokir protokol yang tidak aman. Dalam .NET Framework 4.6 (dan .NET Framework 4.5 dengan patch keamanan terbaru yang diinstal), versi protokol TLS/SSL yang diizinkan adalah 1.2, 1.1, dan 1.0 (kecuali Anda menonaktifkan kriptografi yang kuat dengan mengedit Windows Registry).

Jika autentikasi gagal, Anda menerima AuthenticationException, dan ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi ke objek tersebut sehingga dapat dikumpulkan oleh pengumpul sampah.

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(X509Certificate, Boolean, Boolean).

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

Sumber:

SslStream.cs

Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan informasi yang ditentukan dalam sslClientAuthenticationOptions tas properti.

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

Parameter

sslServerAuthenticationOptions

SslServerAuthenticationOptions

Tas properti untuk koneksi SSL.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Baik ServerCertificateSelectionCallback atau atau ServerCertificateContextServerCertificate dan nullLocalCertificateSelectionCallback tidak diatur dalam SslStream konstruktor.

ArgumentNullException

sslServerAuthenticationOptionsadalah null.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi klien yang menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Jika autentikasi gagal, Anda menerima AuthenticationException, dan ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi ke objek tersebut sehingga dapat dikumpulkan oleh pengumpul sampah.

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

AuthenticateAsServerAsync(X509Certificate)

Sumber:

SslStream.cs

Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat yang ditentukan sebagai operasi asinkron.

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

Parameter

serverCertificate

X509Certificate

Sertifikat yang digunakan untuk mengautentikasi server.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi klien yang menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

PlatformNotSupportedException

Metode AuthenticateAsServerAsync ini tidak didukung pada Windows 95, Windows 98, atau Windows Millennium.

Keterangan

Dimulai dengan .NET Framework 4.7, metode ini mengautentikasi menggunakan None, yang memungkinkan sistem operasi untuk memilih protokol terbaik untuk digunakan, dan untuk memblokir protokol yang tidak aman. Dalam .NET Framework 4.6 (dan .NET Framework 4.5 dengan patch keamanan terbaru yang diinstal), versi protokol TLS/SSL yang diizinkan adalah 1.2, 1.1, dan 1.0 (kecuali Anda menonaktifkan kriptografi yang kuat dengan mengedit Windows Registry).

Metode ini mengautentikasi menggunakan Default. Daftar pencabutan sertifikat tidak diperiksa selama autentikasi. Klien tidak diharuskan menyediakan sertifikat untuk autentikasi.

Jika autentikasi gagal, Anda menerima AuthenticationException, dan ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi untuk itu sehingga dapat dikumpulkan oleh pengumpul sampah.

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

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Sumber:

SslStream.cs

Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien sebagai operasi asinkron. Proses autentikasi menggunakan informasi yang dikembalikan oleh optionsCallback.

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

Parameter

optionsCallback

ServerOptionsSelectionCallback

Delegasi panggilan balik.

state

Object

Objek status yang akan diteruskan saat optionsCallback panggilan balik dipanggil.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Baik ServerCertificateSelectionCallback atau atau ServerCertificateContextServerCertificate dan nullLocalCertificateSelectionCallback tidak diatur dalam SslStream konstruktor.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi klien menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sudah berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Jika autentikasi gagal, Anda menerima AuthenticationException, dan ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi untuk itu sehingga dapat dikumpulkan oleh pengumpul sampah.