SslStream.AuthenticateAsClient 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.
Autentikasi sisi klien dari koneksi server klien.
Overload
| AuthenticateAsClient(SslClientAuthenticationOptions) |
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien. |
| AuthenticateAsClient(String) |
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien. |
| AuthenticateAsClient(String, X509CertificateCollection, Boolean) |
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien. Proses autentikasi menggunakan pengumpulan sertifikat yang ditentukan, dan protokol SSL default sistem. |
| AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) |
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien. Proses autentikasi menggunakan kumpulan sertifikat dan protokol SSL yang ditentukan. |
AuthenticateAsClient(SslClientAuthenticationOptions)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien.
public:
void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unitPublic Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)Parameter
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Tas properti untuk koneksi SSL.
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 sudah 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.
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 timbul.
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.
Berlaku untuk
AuthenticateAsClient(String)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien.
public:
virtual void AuthenticateAsClient(System::String ^ targetHost);public virtual void AuthenticateAsClient (string targetHost);abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String)Parameter
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 sudah 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.
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 timbul.
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.
Berlaku untuk
AuthenticateAsClient(String, X509CertificateCollection, Boolean)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien. Proses autentikasi menggunakan pengumpulan sertifikat yang ditentukan, dan protokol SSL default sistem.
public:
virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)Parameter
- clientCertificates
- X509CertificateCollection
X509CertificateCollection yang berisi sertifikat klien.
- checkCertificateRevocation
- Boolean
Boolean Nilai yang menentukan apakah daftar pencabutan sertifikat diperiksa selama autentikasi.
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 timbul.
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.
Catatan
Sertifikat klien tidak didukung dalam protokol SSL versi 2.
Berlaku untuk
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
Dipanggil oleh klien untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien. Proses autentikasi menggunakan kumpulan sertifikat dan protokol SSL yang ditentukan.
public:
virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)Parameter
- 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.
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 timbul.
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.
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