Condividi tramite


NegotiateStream.AuthenticateAsClientAsync Metodo

Definizione

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.Task
Public Overridable Function AuthenticateAsClientAsync () As Task

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.

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.Task
Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As Task

Parametri

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.Task
Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As Task

Parametri

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

targetName è null.

-oppure-

credential è 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'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.Task
Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Parametri

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.Task
Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Parametri

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

targetName è null.

-oppure-

credential è null.

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

Vedi anche

Si applica a