SslStream.BeginAuthenticateAsClient Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memulai operasi untuk mengautentikasi sisi klien koneksi server klien.
Overload
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat yang ditentukan dan protokol keamanan default sistem. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat dan protokol keamanan yang ditentukan. |
Keterangan
Kelebihan beban metode ini tidak memblokir saat autentikasi sedang berlangsung. Untuk memblokir sambil menunggu autentikasi selesai, gunakan salah AuthenticateAsClient satu metode .
BeginAuthenticateAsClient(String, AsyncCallback, Object)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParameter
- asyncCallback
- AsyncCallback
Delegasi AsyncCallback yang mereferensikan metode yang akan dipanggil saat autentikasi selesai.
- asyncState
- Object
Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke asyncCallback delegasi ketika operasi selesai.
Mengembalikan
Objek IAsyncResult yang menunjukkan status operasi asinkron.
Pengecualian
targetHostadalah null.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi server menggunakan ini SslStream telah dicoba sebelumnya.
-atau-
Autentikasi sedang berlangsung.
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.
Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsClient metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.
Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah satu metode kelebihan AuthenticateAsClient beban.
Untuk informasi terperinci tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron
Jika Anda menerima AuthenticationException, ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi ke objek tersebut sehingga dapat dikumpulkan oleh pengumpul sampah.
Berlaku untuk
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat yang ditentukan dan protokol keamanan default sistem.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParameter
- clientCertificates
- X509CertificateCollection
Yang X509CertificateCollection berisi sertifikat klien.
- checkCertificateRevocation
- Boolean
Boolean Nilai yang menentukan apakah daftar pencabutan sertifikat diperiksa selama autentikasi.
- asyncCallback
- AsyncCallback
Delegasi AsyncCallback yang mereferensikan metode yang akan dipanggil saat autentikasi selesai.
- asyncState
- Object
Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke asyncCallback delegasi ketika operasi selesai.
Mengembalikan
Objek IAsyncResult yang menunjukkan status operasi asinkron.
Pengecualian
targetHostadalah null.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi server menggunakan ini SslStream telah dicoba sebelumnya.
-atau-
Autentikasi sedang berlangsung.
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).
Nilai yang ditentukan untuk targetHost harus cocok dengan nama pada sertifikat server.
Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsClient metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.
Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah satu metode kelebihan AuthenticateAsClient beban.
Untuk informasi terperinci tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron
Jika Anda menerima AuthenticationException, 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.
Berlaku untuk
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat dan protokol keamanan yang ditentukan.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParameter
- clientCertificates
- X509CertificateCollection
Yang X509CertificateCollection 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.
- asyncCallback
- AsyncCallback
Delegasi AsyncCallback yang mereferensikan metode yang akan dipanggil saat autentikasi selesai.
- asyncState
- Object
Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke asyncCallback delegasi ketika operasi selesai.
Mengembalikan
Objek IAsyncResult yang menunjukkan status operasi asinkron.
Pengecualian
targetHostadalah null.
enabledSslProtocols bukan nilai yang valid SslProtocols .
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi server menggunakan ini SslStream telah dicoba sebelumnya.
-atau-
Autentikasi sedang berlangsung.
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).
Nilai yang ditentukan untuk targetHost harus cocok dengan nama pada sertifikat server.
Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsClient metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.
Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah satu metode kelebihan AuthenticateAsClient beban.
Untuk informasi terperinci tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron
Jika Anda menerima AuthenticationException, 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.
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk