SslStream.AuthenticateAsServerAsync 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.
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 |
| 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 |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- 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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParameter
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
serverCertificateadalah null.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi klien yang 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).
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).
Berlaku untuk
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- 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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParameter
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
serverCertificateadalah null.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi klien yang 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).
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).
Berlaku untuk
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- 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);public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParameter
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
Tas properti untuk koneksi SSL.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
Baik ServerCertificateSelectionCallback atau atau ServerCertificateContextServerCertificate dan nullLocalCertificateSelectionCallback tidak diatur dalam SslStream konstruktor.
sslServerAuthenticationOptionsadalah null.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi klien yang menggunakan ini SslStream telah dicoba sebelumnya.
-atau-
Autentikasi sedang berlangsung.
Objek ini telah ditutup.
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).
Berlaku untuk
AuthenticateAsServerAsync(X509Certificate)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- 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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParameter
- serverCertificate
- X509Certificate
Sertifikat yang digunakan untuk mengautentikasi server.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
serverCertificateadalah null.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi klien yang menggunakan ini SslStream telah dicoba sebelumnya.
-atau-
Autentikasi sedang berlangsung.
Objek ini telah ditutup.
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).
Berlaku untuk
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Sumber:
- SslStream.cs
- Sumber:
- SslStream.cs
- 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.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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
Objek tugas yang mewakili operasi asinkron.
Pengecualian
Baik ServerCertificateSelectionCallback atau atau ServerCertificateContextServerCertificate dan nullLocalCertificateSelectionCallback tidak diatur dalam SslStream konstruktor.
Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.
Autentikasi telah terjadi.
-atau-
Autentikasi klien menggunakan ini SslStream telah dicoba sebelumnya.
-atau-
Autentikasi sudah berlangsung.
Objek ini telah ditutup.
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.
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