Bagikan melalui

SslStream.BeginAuthenticateAsServer Metode

  • Referensi

Definisi

Ruang nama:
System.Net.Security
Rakitan:
System.Net.Security.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Memulai operasi asinkron untuk menangani sisi server untuk mengautentikasi koneksi server klien.

Overload

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)

Dipanggil oleh server untuk memulai operasi asinkron untuk mengautentikasi klien dan secara opsional server dalam koneksi server klien.
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)

Dipanggil oleh server untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat dan persyaratan yang ditentukan, dan protokol keamanan default sistem.
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)

Dipanggil oleh server untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat, persyaratan, dan protokol keamanan yang ditentukan.

Keterangan

Kelebihan beban metode ini tidak memblokir saat autentikasi sedang berlangsung. Untuk memblokir sambil menunggu autentikasi selesai, gunakan salah AuthenticateAsServer satu metode.

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)

Sumber:
SslStream.cs
Sumber:
SslStream.cs
Sumber:
SslStream.cs

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parameter

serverCertificate
X509Certificate

X509Certificate digunakan untuk mengautentikasi server.

asyncCallback
AsyncCallback

Delegasi AsyncCallback yang mereferensikan metode untuk 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

IAsyncResult

Objek IAsyncResult yang menunjukkan status operasi asinkron.

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 BeginAuthenticateAsServer 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.

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 AuthenticateAsClient satu metode kelebihan 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 untuk itu sehingga dapat dikumpulkan oleh pengumpul sampah.

Berlaku untuk

BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)

Sumber:
SslStream.cs
Sumber:
SslStream.cs
Sumber:
SslStream.cs

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

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.

asyncCallback
AsyncCallback

Delegasi AsyncCallback yang mereferensikan metode untuk 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

IAsyncResult

Objek IAsyncResult yang menunjukkan status operasi asinkron.

Pengecualian

ArgumentNullException

serverCertificateadalah 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 sudah berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

PlatformNotSupportedException

Metode BeginAuthenticateAsServer 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).

Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsServer metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.

Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah AuthenticateAsServer satu metode kelebihan 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 untuk itu sehingga dapat dikumpulkan oleh pengumpul sampah.

Berlaku untuk

BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)

Sumber:
SslStream.cs
Sumber:
SslStream.cs
Sumber:
SslStream.cs

Dipanggil oleh server untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat, persyaratan, dan protokol keamanan yang ditentukan.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

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.

asyncCallback
AsyncCallback

Delegasi AsyncCallback yang mereferensikan metode untuk 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

IAsyncResult

Objek IAsyncResult yang menunjukkan status operasi asinkron.

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 server menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sudah berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

PlatformNotSupportedException

Metode BeginAuthenticateAsServer 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).

Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsServer metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.

Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah AuthenticateAsServer satu metode kelebihan 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 untuk itu sehingga dapat dikumpulkan oleh pengumpul sampah.

Berlaku untuk