Lingua

AcquireTokenForManagedIdentityParameterBuilder Classe

Definizione

Generatore per AcquireTokenForManagedIdentity (usato per ottenere il token per le identità gestite). Fare riferimento a https://aka.ms/msal-net-managed-identity

public sealed class AcquireTokenForManagedIdentityParameterBuilder : Microsoft.Identity.Client.AbstractManagedIdentityAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenForManagedIdentityParameterBuilder>
type AcquireTokenForManagedIdentityParameterBuilder = class
    inherit AbstractManagedIdentityAcquireTokenParameterBuilder<AcquireTokenForManagedIdentityParameterBuilder>
Public NotInheritable Class AcquireTokenForManagedIdentityParameterBuilder
Inherits AbstractManagedIdentityAcquireTokenParameterBuilder(Of AcquireTokenForManagedIdentityParameterBuilder)
Ereditarietà

Metodi

Nome Descrizione
ExecuteAsync()

Esegue la richiesta token in modo asincrono.

(Ereditato da BaseAbstractAcquireTokenParameterBuilder<T>)
ExecuteAsync(CancellationToken)

Esegue la richiesta token in modo asincrono, con la possibilità di annullare il metodo asincrono.

(Ereditato da AbstractManagedIdentityAcquireTokenParameterBuilder<T>)
Validate()

Convalida i parametri dell'operazione AcquireToken.

(Ereditato da BaseAbstractAcquireTokenParameterBuilder<T>)
WithClaims(String)

Aggiunge una richiesta di attestazioni alla richiesta di token. L'SDK ignora la cache dei token quando viene specificata una richiesta di verifica delle attestazioni. Ripetere l'acquisizione del token e usare questo valore nel WithClaims(String) metodo . Una richiesta di attestazioni si verifica in genere quando si chiama l'API downstream protetta, ad esempio quando l'amministratore tenant revoca le credenziali. Le app devono cercare una risposta 401 Non autorizzata dall'API protetta e analizzare l'intestazione di risposta WWW-Authenticate per estrarre le attestazioni. Per informazioni dettagliate, vedere https://aka.ms/msal-net-claim-challenge.

WithCorrelationId(Guid)

Imposta l'ID di correlazione da utilizzare nella richiesta di autenticazione. Usato per tenere traccia di una richiesta nei log dell'SDK e del servizio provider di identità. Se non è impostato, ne verrà generato uno casuale.

(Ereditato da BaseAbstractAcquireTokenParameterBuilder<T>)
WithExtraQueryParameters(Dictionary<String,String>)
Obsoleti.

Imposta parametri di query aggiuntivi per la stringa di query nella richiesta di autenticazione HTTP.

(Ereditato da BaseAbstractAcquireTokenParameterBuilder<T>)
WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>)

Imposta parametri di query aggiuntivi per la stringa di query nella richiesta di autenticazione HTTP con il controllo sui parametri inclusi nella chiave della cache

(Ereditato da BaseAbstractAcquireTokenParameterBuilder<T>)
WithForceRefresh(Boolean)

Specifica se l'applicazione client deve ignorare i token di accesso durante la lettura della cache dei token. I nuovi token verranno comunque scritti nella cache dei token dell'applicazione. Per le richieste mTLS MSI v2, questo ignora anche il certificato di associazione memorizzato nella cache e crea un nuovo certificato. Per impostazione predefinita, il token viene acquisito dalla cache dei token dell'applicazione (forceRefresh=false)

Metodi di estensione

Nome Descrizione
WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String, Boolean)

Aggiunge una coppia chiave-valore alla chiave della cache dei token senza inviarla come parametro di query. Usare questa opzione per partizionare i token memorizzati nella cache ,ad esempio isolando le sessioni di breve durata dalle sessioni regolari per lo stesso utente. Sia AcquireTokenByAuthorizationCode che AcquireTokenSilent devono usare la stessa chiave di partizione per trovare le corrispondenze con le voci memorizzate nella cache.

WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String)

Aggiunge una coppia chiave-valore alla chiave della cache dei token senza inviarla come parametro di query. Usare questa opzione per partizionare i token di accesso memorizzati nella cache ,ad esempio isolando le sessioni di breve durata dalle sessioni regolari per lo stesso utente. Sia AcquireTokenByAuthorizationCode che AcquireTokenSilent devono usare la stessa chiave di partizione per trovare le corrispondenze con le voci memorizzate nella cache.

WithMtlsProofOfPossession(AcquireTokenForManagedIdentityParameterBuilder, PoPOptions)

Abilita mTLS Proof-of-Possession per l'acquisizione del token di identità gestita con opzioni poP aggiuntive, ad esempio un livello minimo di associazione richiesto. Quando è necessaria l'attestazione (scenari keyguard), usare il pacchetto Msal.KeyAttestation e chiamare . WithAttestationSupport() dopo questo metodo.

WithMtlsProofOfPossession(AcquireTokenForManagedIdentityParameterBuilder)

Abilita mTLS Proof-of-Possession per l'acquisizione del token di identità gestita. Quando è necessaria l'attestazione (scenari keyguard), usare il pacchetto Msal.KeyAttestation e chiamare . WithAttestationSupport() dopo questo metodo.

WithOtelTagsEnricher<T>(AbstractManagedIdentityAcquireTokenParameterBuilder<T>, Action<ExecutionResult,IList<KeyValuePair<String,Object>>>)

Registra un delegato che aggiunge tag aggiuntivi (dimensioni) alle metriche MSAL di OpenTelemetry genera per questa acquisizione del token di identità gestita. Il delegato viene richiamato mentre MSAL registra le metriche e riceve l'oggetto dell'acquisizione ExecutionResult (che indica l'esito positivo o negativo, con il risultato o l'eccezione) insieme a un elenco modificabile di tag. I tag aggiunti a tale elenco vengono associati a ogni metrica registrata per la richiesta, incluse le metriche generate durante l'aggiornamento in background proattivo.

WithRequestOverMtls(AcquireTokenForManagedIdentityParameterBuilder)

Usa il flusso attestato IMDSv2 (certificato rilasciato da Credential Guard su mTLS) per acquisire un token di connessione standard. Il certificato mTLS autentica la connessione all'endpoint del token ESTS, ma il token restituito contiene token_type=bearer e non dispone di alcun certificato di associazione in AuthenticationResult. È necessario abilitare Windows Credential Guard (VBS) nell'host. Quando è necessaria l'attestazione, chiamare .WithAttestationSupport() (dal Microsoft.Identity.Client.KeyAttestation pacchetto) dopo questo metodo.

Si applica a