SslStream.BeginAuthenticateAsServer Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia un'operazione asincrona per gestire il lato server dell'autenticazione di una connessione client-server.
Overload
| Nome | Descrizione |
|---|---|
| BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object) |
Chiamato dai server per avviare un'operazione asincrona per autenticare il client e facoltativamente il server in una connessione client-server. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object) |
Chiamato dai server per avviare un'operazione asincrona per autenticare il server e facoltativamente il client usando i certificati e i requisiti specificati e il protocollo di sicurezza predefinito del sistema. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object) |
Chiamato dai server per avviare un'operazione asincrona per autenticare il server e, facoltativamente, il client usando i certificati, i requisiti e il protocollo di sicurezza specificati. |
Commenti
Gli overload di questo metodo non bloccano mentre è in corso l'autenticazione. Per bloccare l'attesa del completamento dell'autenticazione, usare uno dei AuthenticateAsServer metodi .
BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)
Chiamato dai server per avviare un'operazione asincrona per autenticare il client e facoltativamente il server in una connessione client-server.
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);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametri
- serverCertificate
- X509Certificate
X509Certificate utilizzato per autenticare il server.
- asyncCallback
- AsyncCallback
Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'autenticazione.
- asyncState
- Object
Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al asyncCallback delegato al termine dell'operazione.
Valori restituiti
Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.
Eccezioni
serverCertificate è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione client con questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo oggetto è stato chiuso.
Il metodo BeginAuthenticateAsServer non è supportato in Windows 95, Windows 98 o Windows Millennium.
Commenti
A partire da .NET Framework 4.7, questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows). L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il client non è necessario per fornire un certificato per l'autenticazione.
L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.
Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, utilizzare uno degli overload del AuthenticateAsClient metodo.
Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni
Se si riceve un oggetto AuthenticationException, non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti a esso in modo che possa essere raccolto dal Garbage Collector.
Si applica a
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)
Chiamato dai server per avviare un'operazione asincrona per autenticare il server e facoltativamente il client usando i certificati e i requisiti specificati e il protocollo di sicurezza predefinito del sistema.
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);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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametri
- serverCertificate
- X509Certificate
X509Certificate utilizzato per autenticare il server.
- clientCertificateRequired
- Boolean
Valore Boolean che specifica se al client viene richiesto un certificato per l'autenticazione. Si noti che si tratta solo di una richiesta: se non viene fornito alcun certificato, il server accetta comunque la richiesta di connessione.
- checkCertificateRevocation
- Boolean
Valore Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
- asyncCallback
- AsyncCallback
Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'autenticazione.
- asyncState
- Object
Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al asyncCallback delegato al termine dell'operazione.
Valori restituiti
Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.
Eccezioni
serverCertificate è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo oggetto è stato chiuso.
Il metodo BeginAuthenticateAsServer non è supportato in Windows 95, Windows 98 o Windows Millennium.
Commenti
A partire da .NET Framework 4.7, questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows).
L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsServer metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.
Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, utilizzare uno degli overload del AuthenticateAsServer metodo.
Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni
Se si riceve un oggetto AuthenticationException, non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti a esso in modo che possa essere raccolto dal Garbage Collector.
Si applica a
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)
Chiamato dai server per avviare un'operazione asincrona per autenticare il server e, facoltativamente, il client usando i certificati, i requisiti e il protocollo di sicurezza specificati.
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);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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametri
- serverCertificate
- X509Certificate
X509Certificate utilizzato per autenticare il server.
- clientCertificateRequired
- Boolean
Valore Boolean che specifica se al client viene richiesto un certificato per l'autenticazione. Si noti che si tratta solo di una richiesta: se non viene fornito alcun certificato, il server accetta comunque la richiesta di connessione.
- enabledSslProtocols
- SslProtocols
Valore SslProtocols che rappresenta i protocolli utilizzati per l'autenticazione.
- checkCertificateRevocation
- Boolean
Valore Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
- asyncCallback
- AsyncCallback
Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'autenticazione.
- asyncState
- Object
Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al asyncCallback delegato al termine dell'operazione.
Valori restituiti
Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.
Eccezioni
serverCertificate è null.
enabledSslProtocols non è un valore valido SslProtocols .
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo oggetto è stato chiuso.
Il metodo BeginAuthenticateAsServer non è supportato in Windows 95, Windows 98 o Windows Millennium.
Commenti
A partire da .NET Framework 4.7, questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows).
L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsServer metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.
Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, utilizzare uno degli overload del AuthenticateAsServer metodo.
Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni
Se si riceve un oggetto AuthenticationException, non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti a esso in modo che possa essere raccolto dal Garbage Collector.