AcquireTokenWithDeviceCodeParameterBuilder Classe
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.
Generatore di parametri per l'operazione AcquireTokenWithDeviceCode(IEnumerable<String>, Func<DeviceCodeResult,Task>) . Fare riferimento a https://aka.ms/msal-net-device-code-flow
public sealed class AcquireTokenWithDeviceCodeParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenWithDeviceCodeParameterBuilder>type AcquireTokenWithDeviceCodeParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenWithDeviceCodeParameterBuilder>Public NotInheritable Class AcquireTokenWithDeviceCodeParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenWithDeviceCodeParameterBuilder)- Ereditarietà
-
AcquireTokenWithDeviceCodeParameterBuilder
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 AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Convalida i parametri dell'operazione AcquireToken. (Ereditato da BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAdfsAuthority(String, Boolean) |
Aggiunge un'autorità nota corrispondente a un server ADFS. Vedete https://aka.ms/msal-net-adfs. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Obsoleti.
Importante: usare withTenantId o WithTenantIdFromAuthority oppure WithB2CAuthority per le autorità B2C. Aggiunge un'autorità di Azure AD nota all'applicazione per l'accesso degli utenti che specificano il gruppo di destinatari di accesso (il cloud è il cloud Azure cloud pubblico). Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Obsoleti.
Aggiunge un'autorità Azure AD nota all'applicazione per l'accesso degli utenti che specificano l'istanza cloud e il gruppo di destinatari dell'accesso. Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Obsoleti.
Importante: usare withTenantId o WithTenantIdFromAuthority oppure WithB2CAuthority per le autorità B2C. Aggiunge un'autorità di Azure AD nota all'applicazione per consentire agli utenti di accedere da una singola organizzazione (applicazione a tenant singolo) descritta dall'istanza cloud e dal relativo ID tenant. Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Obsoleti.
Importante: usare withTenantId o WithTenantIdFromAuthority oppure WithB2CAuthority per le autorità B2C. Aggiunge un'autorità di Azure AD nota all'applicazione per l'accesso degli utenti da una singola organizzazione (applicazione a tenant singolo) descritta dall'istanza cloud e dal relativo nome di dominio o ID tenant. Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Obsoleti.
Importante: usare withTenantId o WithTenantIdFromAuthority oppure WithB2CAuthority per le autorità B2C. Autorità specifica per cui viene richiesto il token. Il passaggio di un valore diverso rispetto a quello configurato nel costruttore dell'applicazione restringe la selezione a un tenant specifico. Questo non modifica il valore configurato nell'applicazione. Questa operazione è specifica per le applicazioni che gestiscono più account, ad esempio un client di posta elettronica con più cassette postali. Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
Obsoleti.
Importante: usare withTenantId o WithTenantIdFromAuthority oppure WithB2CAuthority per le autorità B2C. Aggiunge un'autorità di Azure AD nota all'applicazione per l'accesso degli utenti da una singola organizzazione (applicazione a tenant singolo) specificata dal relativo ID tenant. Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Obsoleti.
Importante: usare withTenantId o WithTenantIdFromAuthority oppure WithB2CAuthority per le autorità B2C. Aggiunge un'autorità di Azure AD nota all'applicazione per l'accesso degli utenti da una singola organizzazione (applicazione a tenant singolo) descritta dal nome di dominio. Vedete https://aka.ms/msal-net-application-configuration. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Aggiunge un'autorità nota corrispondente a un criterio di active directory B2C di Azure. Fare riferimento a https://aka.ms/msal-net-b2c-specificities (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Imposta le attestazioni nella query. Usare quando l'amministratore di AAD ha abilitato l'accesso condizionale. L'acquisizione del token genererà un MsalUiRequiredException oggetto con il set di Claims proprietà. Ripetere l'acquisizione del token e usare questo valore nel WithClaims(String) metodo . Per https://aka.ms/msal-exceptions informazioni dettagliate, vedere https://aka.ms/msal-net-claim-challenge. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| 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>) |
| WithDeviceCodeResultCallback(Func<DeviceCodeResult,Task>) |
Imposta il delegato callback in modo che l'applicazione possa interagire con l'utente per indirizzarli all'autenticazione (a un URL specifico, con un codice) |
| 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>) |
| WithExtraQueryParameters(String) |
Obsoleti.
Imposta parametri di query aggiuntivi per la stringa di query nella richiesta di autenticazione HTTP. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithScopes(IEnumerable<String>) |
Specifica gli ambiti da richiedere. Questo metodo viene usato quando l'applicazione deve specificare gli ambiti necessari per chiamare un'API protetta. >https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent<Vedere</vedere> per altre informazioni su ambiti, autorizzazioni e consenso e <vedere>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes</vedere> per informazioni su come creare ambiti per le applicazioni legacy usate per esporre le autorizzazioni OAuth2. (Ereditato da AbstractAcquireTokenParameterBuilder<T>) |
| WithTenantId(String) |
Esegue l'override dell'ID tenant specificato nell'autorità a livello di applicazione. Questa operazione mantiene l'host dell'autorità (ambiente). Se non è stata specificata un'autorità a livello di applicazione, l'impostazione predefinita usata è |
| WithTenantIdFromAuthority(Uri) |
Estrae l'ID tenant dall'URI dell'autorità fornita ed esegue l'override dell'ID tenant specificato nell'autorità a livello di applicazione. Questa operazione mantiene l'host dell'autorità (ambiente) fornito al generatore di applicazioni.
Se non è stata fornita un'autorità al generatore di applicazioni, questo metodo sostituirà l'ID tenant nell'autorità predefinita - |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Interviene nella pipeline di richiesta eseguendo un delegato fornito dall'utente prima che MSAL effettui la richiesta del token. Il delegato può modificare il payload della richiesta aggiungendo o rimuovendo i parametri e le intestazioni del corpo. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Specifica parametri aggiuntivi acquisiti dalle risposte di autenticazione da memorizzare nella cache con il token di accesso che normalmente non sono inclusi nell'oggetto cache. questi valori possono essere letti dal AdditionalResponseParameters parametro . |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Consente alle applicazioni client di fornire un'operazione di autenticazione personalizzata da usare nella richiesta di acquisizione del token. |
| 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 memorizzati nella cache ,ad esempio isolando le sessioni di breve durata dalle sessioni regolari per lo stesso utente. Sia |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Specifica attestazioni aggiuntive da includere nell'asserzione client. Queste attestazioni verranno unite con attestazioni predefinite quando viene generata l'asserzione client. In questo modo, le API di livello superiore, ad esempio Microsoft. Identity.Web fornisce attestazioni aggiuntive per l'asserzione client. Importante: i token sono associati alle attestazioni di asserzione client aggiuntive, che influiscono sulle ricerche nella cache. Si tratta di un'API di estendibilità e non deve essere usata direttamente dalle applicazioni. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Obsoleti.
Aggiunge altre intestazioni HTTP alla richiesta di token. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Aggiunge intestazioni HTTP aggiuntive alla richiesta di token. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Specifica un percorso FMI da utilizzare per l'asserzione client. In questo modo, le API di livello superiore come Id.Web forniscono credenziali sensibili a FMI. Importante: i token sono associati al percorso FMI delle credenziali, che influisce sulle ricerche nella cache. Si tratta di un'API di estendibilità e non deve essere usata dalle applicazioni. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Associa il token a una chiave nella cache. Nessuna operazione di crittografia viene eseguita sul token. |