NegotiateStream.AuthenticateAsClientAsync 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.
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona.
Overload
| AuthenticateAsClientAsync() |
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. |
| AuthenticateAsClientAsync(NetworkCredential, String) |
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza le credenziali del client specificate. |
| AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String) |
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza l'associazione di canale e le credenziali del client specificate. |
| AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel) |
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza le credenziali e le opzioni di autenticazione specificate. |
| AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel) |
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza l'associazione di canale, le opzioni di autenticazione e la credenziale specificate. |
AuthenticateAsClientAsync()
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync();public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync ();abstract member AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync () As TaskRestituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'oggetto è stato chiuso.
L'autenticazione è già stata effettuata.
-oppure-
Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come server. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come client.
Commenti
L'autenticazione usa l'oggetto del DefaultCredentialsclient. Non viene specificato alcun nome dell'entità servizio (SPN) per il server. Il livello di rappresentazione è Identification, il livello di sicurezza è EncryptAndSigne viene richiesta l'autenticazione reciproca. La NegotiateStream classe creerà il nome SPN usato per l'autenticazione reciproca.
Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
Se l'autenticazione non riesce, si riceve un oggetto AuthenticationException o .InvalidCredentialException In questo caso, è possibile ritentare l'autenticazione con credenziali diverse.
Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient().
Si applica a
AuthenticateAsClientAsync(NetworkCredential, String)
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza le credenziali del client specificate.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As TaskParametri
- credential
- NetworkCredential
Classe NetworkCredential che viene utilizzata per stabilire l'identità del client.
- targetName
- String
L'SPN (Service Principal Name, Nome principale servizio) che identifica in modo univoco il server da autenticare.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'oggetto è stato chiuso.
L'autenticazione è già stata effettuata.
-oppure-
Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come server. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come client.
targetName è null.
Commenti
Il livello di rappresentazione è Identification, il livello di sicurezza è EncryptAndSigne viene richiesta l'autenticazione reciproca. La NegotiateStream classe creerà il nome SPN usato per l'autenticazione reciproca.
Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(NetworkCredential, String).
Si applica a
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza l'associazione di canale e le credenziali del client specificate.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As TaskParametri
- credential
- NetworkCredential
Classe NetworkCredential che viene utilizzata per stabilire l'identità del client.
- binding
- ChannelBinding
Oggetto ChannelBinding che viene utilizzato per la protezione estesa.
- targetName
- String
L'SPN (Service Principal Name, Nome principale servizio) che identifica in modo univoco il server da autenticare.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione è già stata effettuata.
-oppure-
Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come server. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come client.
L'oggetto è stato chiuso.
Commenti
Il livello di rappresentazione è Identification, il livello di sicurezza è EncryptAndSigne viene richiesta l'autenticazione reciproca. La NegotiateStream classe creerà il nome SPN usato per l'autenticazione reciproca.
L'oggetto ChannelBinding utilizzato per la protezione estesa passata a questo metodo nel binding parametro viene recuperato da un'applicazione dalla TransportContext proprietà nell'oggetto associato SslStream.
Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(NetworkCredential, ChannelBinding, String).
Vedi anche
Si applica a
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza le credenziali e le opzioni di autenticazione specificate.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As TaskParametri
- credential
- NetworkCredential
Classe NetworkCredential che viene utilizzata per stabilire l'identità del client.
- targetName
- String
L'SPN (Service Principal Name, Nome principale servizio) che identifica in modo univoco il server da autenticare.
- requiredProtectionLevel
- ProtectionLevel
Uno dei valori della classe ProtectionLevel che indica i servizi di sicurezza per il flusso.
- allowedImpersonationLevel
- TokenImpersonationLevel
Uno dei valori della classe TokenImpersonationLevel, che indica il modo in cui il server può utilizzare le credenziali del client per accedere alle risorse.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
allowedImpersonationLevel non è un valore valido.
targetName è null.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'oggetto è stato chiuso.
L'autenticazione è già stata effettuata.
-oppure-
Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come server. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come client.
Commenti
Usare il requiredProtectionLevel parametro per richiedere servizi di sicurezza per i dati trasmessi usando il flusso autenticato. Ad esempio, per avere i dati crittografati e firmati, specificare il EncryptAndSign valore. L'autenticazione riuscita non garantisce che l'utente richiesto ProtectionLevel sia stato concesso. È necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream.
Se l'autenticazione ha esito negativo, viene visualizzato un AuthenticationException oggetto o .InvalidCredentialException In questo caso, è possibile riprovare l'autenticazione con credenziali diverse.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel).
Si applica a
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
- Origine:
- NegotiateStream.cs
Viene chiamato per l'autenticazione del client e, facoltativamente, del server, in una connessione client-server come operazione asincrona. Il processo di autenticazione utilizza l'associazione di canale, le opzioni di autenticazione e la credenziale specificate.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As TaskParametri
- credential
- NetworkCredential
Classe NetworkCredential che viene utilizzata per stabilire l'identità del client.
- binding
- ChannelBinding
Oggetto ChannelBinding che viene utilizzato per la protezione estesa.
- targetName
- String
L'SPN (Service Principal Name, Nome principale servizio) che identifica in modo univoco il server da autenticare.
- requiredProtectionLevel
- ProtectionLevel
Uno dei valori della classe ProtectionLevel che indica i servizi di sicurezza per il flusso.
- allowedImpersonationLevel
- TokenImpersonationLevel
Uno dei valori della classe TokenImpersonationLevel, che indica il modo in cui il server può utilizzare le credenziali del client per accedere alle risorse.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
allowedImpersonationLevel non è un valore valido.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.
L'autenticazione è già stata effettuata.
-oppure-
Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come server. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come client.
L'oggetto è stato chiuso.
Commenti
Usare il requiredProtectionLevel parametro per richiedere servizi di sicurezza per i dati trasmessi usando il flusso autenticato. Ad esempio, per avere i dati crittografati e firmati, specificare il EncryptAndSign valore. L'autenticazione riuscita non garantisce che l'utente richiesto ProtectionLevel sia stato concesso. È necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream.
L'oggetto ChannelBinding usato per la protezione estesa passata a questo metodo nel binding parametro verrà recuperato da un'applicazione dalla TransportContext proprietà nell'oggetto associato SslStream.
Se l'autenticazione ha esito negativo, viene visualizzato un AuthenticationException oggetto o .InvalidCredentialException In questo caso, è possibile riprovare l'autenticazione con credenziali diverse.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel).
