SslStream.AuthenticateAsServer Metode

Definisi

Ruang nama:

System.Net.Security

Rakitan:

System.Net.Security.dll

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

Overload

AuthenticateAsServer(SslServerAuthenticationOptions)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat yang ditentukan.
AuthenticateAsServer(X509Certificate)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat yang ditentukan.
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	Dipanggil oleh server untuk mengautentikasi server dan secara opsional klien dalam koneksi server klien menggunakan sertifikat dan persyaratan yang ditentukan, dan menggunakan protokol keamanan default sistem.
AuthenticateAsServer(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.

AuthenticateAsServer(SslServerAuthenticationOptions)

Sumber:

SslStream.cs

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

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

Parameter

sslServerAuthenticationOptions

SslServerAuthenticationOptions

Tas properti untuk koneksi SSL.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

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.

PlatformNotSupportedException

Metode AuthenticateAsServer 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). Daftar pencabutan sertifikat tidak diperiksa selama autentikasi. Klien tidak diharuskan menyediakan sertifikat untuk autentikasi.

Metode ini memblokir hingga operasi selesai. Untuk mencegah pemblokiran hingga operasi selesai, gunakan salah satu metode kelebihan BeginAuthenticateAsServer beban.

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.

AuthenticateAsServer(X509Certificate)

Sumber:

SslStream.cs

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

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)

Parameter

serverCertificate

X509Certificate

Sertifikat yang digunakan untuk mengautentikasi server.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

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.

PlatformNotSupportedException

Metode AuthenticateAsServer 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). Daftar pencabutan sertifikat tidak diperiksa selama autentikasi. Klien tidak diharuskan menyediakan sertifikat untuk autentikasi.

Metode ini memblokir hingga operasi selesai. Untuk mencegah pemblokiran hingga operasi selesai, gunakan salah satu metode kelebihan BeginAuthenticateAsServer beban.

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.

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

Sumber:

SslStream.cs

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

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)

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.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

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.

PlatformNotSupportedException

Metode AuthenticateAsServer 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 memblokir hingga operasi selesai. Untuk mencegah pemblokiran hingga operasi selesai, gunakan salah satu metode kelebihan BeginAuthenticateAsServer beban.

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.

AuthenticateAsServer(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.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

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.

Pengecualian

ArgumentNullException

serverCertificateadalah null.

ArgumentException

enabledSslProtocols bukan nilai yang valid SslProtocols .

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.

PlatformNotSupportedException

Metode AuthenticateAsServer 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 memblokir hingga operasi selesai. Untuk mencegah pemblokiran hingga operasi selesai, gunakan salah satu metode kelebihan BeginAuthenticateAsServer beban.

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.