AbstractApplicationBuilder<T> Classe

Definizione

public abstract class AbstractApplicationBuilder<T> : Microsoft.Identity.Client.BaseAbstractApplicationBuilder<T> where T : BaseAbstractApplicationBuilder<T>
type AbstractApplicationBuilder<'T (requires 'T :> BaseAbstractApplicationBuilder<'T>)> = class
    inherit BaseAbstractApplicationBuilder<'T (requires 'T :> BaseAbstractApplicationBuilder<'T>)>
Public MustInherit Class AbstractApplicationBuilder(Of T)
Inherits BaseAbstractApplicationBuilder(Of T)

Parametri di tipo

T
Ereditarietà
AbstractApplicationBuilder<T>
Derivato

Metodi

Nome Descrizione
WithAdfsAuthority(String, Boolean)

Aggiunge un'autorità nota corrispondente a un server ADFS. Fare riferimento a https://aka.ms/msal-net-adfs

WithAuthority(AadAuthorityAudience, Boolean)

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.

WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

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.

WithAuthority(AzureCloudInstance, Guid, Boolean)

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.

WithAuthority(AzureCloudInstance, String, Boolean)

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.

WithAuthority(String, Boolean)

Aggiunge un'autorità Azure AD nota all'applicazione per l'accesso degli utenti che specificano l'URI completo dell'autorità. Vedere Opzioni di configurazione dell'applicazione.

WithAuthority(String, Guid, Boolean)

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. Vedere Opzioni di configurazione dell'applicazione.

WithAuthority(String, String, Boolean)

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.

WithAuthority(Uri, Boolean)

Aggiunge un'autorità nota all'applicazione. Vedere Opzioni di configurazione dell'applicazione. Questo costruttore viene usato principalmente per gli scenari in cui l'autorità non è un'autorità standard di Azure AD, né un'autorità ADFS, né un'autorità ad Azure AD B2C. Per Azure AD, anche nei cloud sovrani, preferire l'uso di altri override, ad esempioWithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

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

WithCacheOptions(CacheOptions)

Opzioni per le cache dei token MSAL.

MSAL gestisce una cache dei token internamente in memoria. Per impostazione predefinita, questo oggetto cache fa parte di ogni istanza di PublicClientApplication o ConfidentialClientApplication. Questo metodo consente la personalizzazione della cache dei token in memoria di MSAL.

La cache di memoria di MSAL è diversa dalla serializzazione della cache dei token. La serializzazione della cache esegue il pull dei token da una cache (ad esempio Redis, Cosmos o un file su disco), in cui vengono archiviati in formato JSON, nella cache di memoria interna di MSAL. Le operazioni della cache di memoria non comportano operazioni JSON.

La serializzazione della cache esterna rimane il modo consigliato per gestire le app desktop, il sito Web e le API Web, in quanto garantisce la persistenza. Queste opzioni non controllano attualmente la serializzazione della cache esterna.

Indicazioni dettagliate per ogni tipo di applicazione e piattaforma: https://aka.ms/msal-net-token-cache-serialization

WithClientCapabilities(IEnumerable<String>)

Microsoft'estensione OIDC specifica dell'identità che consente di risolvere i problemi delle risorse senza interazione. Consente la configurazione di una o più funzionalità client, ad esempio "llt"

WithClientId(String)

Imposta l'ID client dell'applicazione

WithClientName(String)

Imposta il nome dell'API SDK chiamante a scopo di telemetria.

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithClientVersion(String)

Imposta la versione dell'SDK chiamante a scopo di telemetria.

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithDebugLoggingCallback(LogLevel, Boolean, Boolean)

Imposta il callback di registrazione debug su un metodo di debug predefinito che visualizza il livello del messaggio e il messaggio stesso. Per informazioni dettagliate, vedere https://aka.ms/msal-net-logging

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithExperimentalFeatures(Boolean)

Consente l'uso di funzionalità sperimentali e API. Se questo flag non è impostato, le funzionalità sperimentali genereranno un'eccezione. Per informazioni dettagliate, vedere https://aka.ms/msal-net-experimental-features

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithExtraQueryParameters(IDictionary<String,String>)
Obsoleti.

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

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

WithExtraQueryParameters(String)
Obsoleti.

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

WithHttpClientFactory(IMsalHttpClientFactory, Boolean)

Usa un oggetto specifico IMsalHttpClientFactory per comunicare con il provider di identità. Ciò consente scenari avanzati, ad esempio l'impostazione di un proxy o l'impostazione dell'agente.

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithHttpClientFactory(IMsalHttpClientFactory)

Usa un oggetto specifico IMsalHttpClientFactory per comunicare con il provider di identità. Ciò consente scenari avanzati, ad esempio l'impostazione di un proxy o l'impostazione dell'agente.

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithInstanceDicoveryMetadata(String)
Obsoleti.

Consente agli sviluppatori di configurare le proprie autorità valide. Deve essere fornita una stringa json simile a https://aka.ms/aad-instance-discovery . MSAL usa queste informazioni per:

  • Chiamare le API REST nell'ambiente specificato nel preferred_network
  • Identificare un ambiente in cui salvare i token e gli account nella cache
  • Usare gli alias dell'ambiente per associare i token emessi ad altre autorità
Per altri dettagli, vedere https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDicoveryMetadata(Uri)
Obsoleti.

Consente a un'organizzazione di configurare il proprio servizio per gestire l'individuazione delle istanze, consentendo una migliore memorizzazione nella cache per gli ambienti microservizi/servizi. Deve essere fornito un URI che restituisce una risposta simile a https://aka.ms/aad-instance-discovery . MSAL usa queste informazioni per:

  • Chiamare le API REST nell'ambiente specificato nel preferred_network
  • Identificare un ambiente in cui salvare i token e gli account nella cache
  • Usare gli alias dell'ambiente per associare i token emessi ad altre autorità
Per altri dettagli, vedere https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscovery(Boolean)

Determina se l'individuazione dell'istanza viene eseguita o meno durante il tentativo di autenticazione. Se si imposta su false, l'individuazione dell'istanza e la convalida dell'autorità verranno completamente disabilitate. Questo non influirà sul comportamento dell'applicazione configurata con gli endpoint a livello di area.

WithInstanceDiscoveryMetadata(String)

Consente agli sviluppatori di configurare le proprie autorità valide. Deve essere fornita una stringa json simile a https://aka.ms/aad-instance-discovery . MSAL usa queste informazioni per:

  • Chiamare le API REST nell'ambiente specificato nel preferred_network
  • Identificare un ambiente in cui salvare i token e gli account nella cache
  • Usare gli alias dell'ambiente per associare i token emessi ad altre autorità
Per altri dettagli, vedere https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscoveryMetadata(Uri)

Consente a un'organizzazione di configurare il proprio servizio per gestire l'individuazione delle istanze, consentendo una migliore memorizzazione nella cache per gli ambienti microservizi/servizi. Deve essere fornito un URI che restituisce una risposta simile a https://aka.ms/aad-instance-discovery . MSAL usa queste informazioni per:

  • Chiamare le API REST nell'ambiente specificato nel preferred_network
  • Identificare un ambiente in cui salvare i token e gli account nella cache
  • Usare gli alias dell'ambiente per associare i token emessi ad altre autorità
Per altri dettagli, vedere https://aka.ms/msal-net-custom-instance-metadata
WithLegacyCacheCompatibility(Boolean)

Abilita la serializzazione e la deserializzazione della cache ADAL legacy.

WithLogging(IIdentityLogger, Boolean)

Imposta il logger di identità. Per informazioni dettagliate, vedere https://aka.ms/msal-net-logging

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>)

Imposta il callback di registrazione. Per informazioni dettagliate, vedere https://aka.ms/msal-net-logging

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithOptions(ApplicationOptions)

Imposta le opzioni dell'applicazione, che possono, ad esempio, essere state lette dai file di configurazione. Vedete https://aka.ms/msal-net-application-configuration.

WithOptions(BaseApplicationOptions)

Imposta le opzioni dell'applicazione, che possono, ad esempio, essere state lette dai file di configurazione. Vedete https://aka.ms/msal-net-application-configuration.

(Ereditato da BaseAbstractApplicationBuilder<T>)
WithRedirectUri(String)

Imposta l'URI di reindirizzamento dell'applicazione. L'URI deve essere registrato anche nel portale dell'applicazione. Fare riferimento a https://aka.ms/msal-net-application-configuration

WithTelemetry(ITelemetryConfig)
Obsoleti.

Generare eventi di aggregazione di telemetria.

WithTenantId(String)

Imposta l'ID tenant dell'organizzazione da cui l'applicazione consentirà agli utenti di accedere. Si tratta classicamente di un GUID o di un nome di dominio. Vedete https://aka.ms/msal-net-application-configuration. Anche se è anche possibile impostare su tenantIdcommon, organizationse consumers, è consigliabile usare una delle sostituzioni di WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean).

Si applica a