SslStream.AuthenticateAsClientAsync Metode

Definisi

Ruang nama:

System.Net.Security

Rakitan:

System.Net.Security.dll

Mengautentikasi sisi klien koneksi server klien sebagai operasi asinkron.

Overload

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan kumpulan sertifikat dan protokol SSL yang ditentukan.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan kumpulan sertifikat yang ditentukan dan protokol SSL default sistem.
AuthenticateAsClientAsync(String)	Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan informasi yang ditentukan dalam sslClientAuthenticationOptions tas properti.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Sumber:

SslStream.cs

Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan kumpulan sertifikat dan protokol SSL yang ditentukan.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parameter

targetHost

String

Nama server yang akan berbagi ini SslStream.

clientCertificates

X509CertificateCollection

X509CertificateCollection yang berisi sertifikat klien.

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

AuthenticationException

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

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server 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).

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

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.

Catatan

Sertifikat klien tidak didukung dalam protokol SSL versi 2.

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

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Sumber:

SslStream.cs

Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi klien-server sebagai operasi asinkron. Proses autentikasi menggunakan kumpulan sertifikat yang ditentukan dan protokol SSL default sistem.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

Parameter

targetHost

String

Nama server yang akan berbagi ini SslStream.

clientCertificates

X509CertificateCollection

X509CertificateCollection yang berisi sertifikat klien.

checkCertificateRevocation

Boolean

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

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

AuthenticationException

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

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server 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).

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

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.

Catatan

Sertifikat klien tidak didukung dalam protokol SSL versi 2.

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

AuthenticateAsClientAsync(String)

Sumber:

SslStream.cs

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

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

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

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

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parameter

targetHost

String

Nama server yang berbagi ini SslStream.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

targetHostadalah null.

AuthenticationException

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

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server 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). Tidak ada sertifikat klien yang digunakan dalam autentikasi. Daftar pencabutan sertifikat tidak diperiksa selama autentikasi. Nilai yang ditentukan untuk targetHost harus cocok dengan nama pada sertifikat server.

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

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 AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Sumber:

SslStream.cs

Dipanggil oleh klien 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 ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Tas properti untuk koneksi SSL.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

sslClientAuthenticationOptionsadalah null.

AuthenticationException

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

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server 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

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

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 AuthenticateAsClient(SslClientAuthenticationOptions).