NegotiateStream.BeginAuthenticateAsServer Metodo

Definizione

Spazio dei nomi:

System.Net.Security

Assembly:

System.Net.Security.dll

Avvia un'operazione asincrona per gestire il lato server dell'autenticazione di una connessione client-server.

Overload

BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)	Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Il processo di autenticazione utilizza le credenziali del server, le opzioni di autenticazione e i criteri di protezione estesa specificati. Questo metodo non si blocca.
BeginAuthenticateAsServer(AsyncCallback, Object)	Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Questo metodo non si blocca.
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)	Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Il processo di autenticazione utilizza i criteri di protezione estesa specificati. Questo metodo non si blocca.
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)	Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Il processo di autenticazione utilizza le credenziali del server e le opzioni di autenticazione specificate. Questo metodo non si blocca.

Commenti

Gli overload di questo metodo non vengono bloccati mentre è in corso l'autenticazione. Per bloccare l'attesa del completamento dell'autenticazione, usare il AuthenticateAsServer metodo .

BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)

Origine:

NegotiateStream.cs

Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Il processo di autenticazione utilizza le credenziali del server, le opzioni di autenticazione e i criteri di protezione estesa specificati. Questo metodo non si blocca.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametri

credential

NetworkCredential

Classe NetworkCredential che viene utilizzata per stabilire l'identità del client.

policy

ExtendedProtectionPolicy

Oggetto ExtendedProtectionPolicy che viene utilizzato per la protezione estesa.

requiredProtectionLevel

ProtectionLevel

Uno dei valori della classe ProtectionLevel che indica i servizi di sicurezza per il flusso.

requiredImpersonationLevel

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.

asyncCallback

AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState

Object

Oggetto definito dall'utente contenente informazioni sull'operazione di scrittura. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

IAsyncResult

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

ArgumentException

Le proprietà CustomChannelBinding e CustomServiceNames sui criteri di protezione estesa passati al parametro policy sono entrambe null.

ArgumentNullException

credential è null.

ArgumentOutOfRangeException

requiredImpersonationLevel deve essere Identification, Impersonation o Delegation.

AuthenticationException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

InvalidCredentialException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come client. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come server.

ObjectDisposedException

L'oggetto è stato chiuso.

PlatformNotSupportedException

Il parametro policy è stato impostato su Always in una piattaforma che non supporta la protezione estesa.

NotSupportedException

Windows 95 e Windows 98 non sono supportati.

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 sia stata concessa l'autenticazione richiesta ProtectionLevel . È necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream.

Se il policy parametro è null, viene usato PolicyEnforcement un criterio di protezione esteso impostato su Never.

Questo metodo è asincrono e non blocca mentre l'operazione viene completata. Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsServer metodo.

L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsServer metodo . In genere, il metodo viene richiamato dal asyncCallback delegato. Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata di metodi sincroni in modo asincrono

Se l'autenticazione ha esito negativo, viene visualizzato un AuthenticationException oggetto o .InvalidCredentialException In questo caso, è possibile riprovare l'autenticazione con credenziali diverse.

Vedi anche

• ExtendedProtectionPolicy
• Integrated Windows Authentication with Extended Protection

BeginAuthenticateAsServer(AsyncCallback, Object)

Origine:

NegotiateStream.cs

Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Questo metodo non si blocca.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametri

asyncCallback

AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState

Object

Oggetto definito dall'utente contenente informazioni sull'operazione. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

IAsyncResult

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

AuthenticationException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

InvalidCredentialException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

ObjectDisposedException

L'oggetto è stato chiuso.

NotSupportedException

Windows 95 e Windows 98 non sono supportati.

Commenti

L'autenticazione usa l'oggetto .DefaultCredentials Per il server non è specificato alcun nome dell'entità servizio (SPN). Il livello di rappresentazione è Identification, il livello di sicurezza è EncryptAndSign.

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 proprietà per determinare se si è verificata l'autenticazione IsMutuallyAuthenticated reciproca.

Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsServer metodo.

Se l'autenticazione ha esito negativo, viene visualizzato un AuthenticationException oggetto o .InvalidCredentialException In questo caso, è possibile riprovare l'autenticazione con credenziali diverse.

BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)

Origine:

NegotiateStream.cs

Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Il processo di autenticazione utilizza i criteri di protezione estesa specificati. Questo metodo non si blocca.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (policy As ExtendedProtectionPolicy, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametri

policy

ExtendedProtectionPolicy

Oggetto ExtendedProtectionPolicy che viene utilizzato per la protezione estesa.

asyncCallback

AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState

Object

Oggetto definito dall'utente contenente informazioni sull'operazione di scrittura. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

IAsyncResult

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

ArgumentException

Le proprietà CustomChannelBinding e CustomServiceNames sui criteri di protezione estesa passati al parametro policy sono entrambe null.

AuthenticationException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

InvalidCredentialException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

ObjectDisposedException

L'oggetto è stato chiuso.

PlatformNotSupportedException

Il parametro policy è stato impostato su Always in una piattaforma che non supporta la protezione estesa.

NotSupportedException

Windows 95 e Windows 98 non sono supportati.

Commenti

L'autenticazione usa l'oggetto .DefaultCredentials Per il server non è specificato alcun nome dell'entità servizio (SPN). Il livello di rappresentazione è Identification, il livello di sicurezza è EncryptAndSign.

Se il policy parametro è null, viene usato PolicyEnforcement un criterio di protezione esteso impostato su Never.

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.

Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsServer metodo.

Se l'autenticazione non riesce, si riceve un oggetto AuthenticationException o .InvalidCredentialException In questo caso, è possibile ritentare l'autenticazione con credenziali diverse.

Vedi anche

• ExtendedProtectionPolicy
• Integrated Windows Authentication with Extended Protection

BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)

Origine:

NegotiateStream.cs

Viene chiamato dai server per avviare un'operazione asincrona di autenticazione del client e, facoltativamente, del server, in una connessione client-server. Il processo di autenticazione utilizza le credenziali del server e le opzioni di autenticazione specificate. Questo metodo non si blocca.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametri

credential

NetworkCredential

Classe NetworkCredential che viene utilizzata per stabilire l'identità del client.

requiredProtectionLevel

ProtectionLevel

Uno dei valori della classe ProtectionLevel che indica i servizi di sicurezza per il flusso.

requiredImpersonationLevel

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.

asyncCallback

AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState

Object

Oggetto definito dall'utente contenente informazioni sull'operazione. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

IAsyncResult

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

ArgumentNullException

credential è null.

ArgumentOutOfRangeException

requiredImpersonationLevel deve essere Identification, Impersonation o Delegation.

AuthenticationException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

InvalidCredentialException

L'autenticazione non è riuscita. È possibile utilizzare questo oggetto per tentare nuovamente l'autenticazione.

ObjectDisposedException

L'oggetto è stato chiuso.

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

Questo flusso è stato precedentemente utilizzato per tentare l'autenticazione come client. Non è possibile utilizzare il flusso per tentare nuovamente l'autenticazione come server.

NotSupportedException

Windows 95 e Windows 98 non sono supportati.

Commenti

Usare il requiredProtectionLevel parametro per richiedere i servizi di sicurezza per i dati trasmessi usando il flusso autenticato. Ad esempio, per fare in modo che i dati siano crittografati e firmati, specificare il EncryptAndSign valore . L'autenticazione riuscita non garantisce che sia stato concesso l'oggetto richiesto ProtectionLevel . È necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da NegotiateStream.

Questo metodo è asincrono e non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsServer metodo.

L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsServer metodo . In genere, il metodo viene richiamato dal asyncCallback delegato. Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni

Se l'autenticazione non riesce, si riceve un oggetto AuthenticationException o .InvalidCredentialException In questo caso, è possibile ritentare l'autenticazione con credenziali diverse.