PublicClientApplicationBuilder 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.
public sealed class PublicClientApplicationBuilder : Microsoft.Identity.Client.AbstractApplicationBuilder<Microsoft.Identity.Client.PublicClientApplicationBuilder>type PublicClientApplicationBuilder = class
inherit AbstractApplicationBuilder<PublicClientApplicationBuilder>Public NotInheritable Class PublicClientApplicationBuilder
Inherits AbstractApplicationBuilder(Of PublicClientApplicationBuilder)- Ereditarietà
-
PublicClientApplicationBuilder
Metodi
| Nome | Descrizione | |||
|---|---|---|---|---|
| Build() |
Compila un'istanza di IPublicClientApplication dai parametri impostati in PublicClientApplicationBuilder. |
|||
| Create(String) |
Crea un PublicClientApplicationBuilder da un clientID. Fare riferimento a https://aka.ms/msal-net-application-configuration |
|||
| CreateWithApplicationOptions(PublicClientApplicationOptions) |
Crea un publicClientApplicationBuilder dalle opzioni di configurazione dell'applicazione client pubblica. Fare riferimento a https://aka.ms/msal-net-application-configuration |
|||
| IsBrokerAvailable() |
Restituisce |
|||
| WithAdfsAuthority(String, Boolean) |
Aggiunge un'autorità nota corrispondente a un server ADFS. Fare riferimento a https://aka.ms/msal-net-adfs (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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) (Ereditato da AbstractApplicationBuilder<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 AbstractApplicationBuilder<T>) |
|||
| WithBroker(Boolean) | ||||
| 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 app desktop, siti Web e API Web, in quanto fornisce 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 (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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" (Ereditato da AbstractApplicationBuilder<T>) |
|||
| WithClientId(String) |
Imposta l'ID client dell'applicazione (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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>) |
|||
| WithDefaultRedirectUri() |
Configura l'applicazione client pubblica per l'uso dell'URI di risposta consigliato per la piattaforma. Vedete https://aka.ms/msal-net-default-reply-uri.
|
|||
| 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 (Ereditato da AbstractApplicationBuilder<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 AbstractApplicationBuilder<T>) |
|||
| WithExtraQueryParameters(String) |
Obsoleti.
Imposta parametri di query aggiuntivi per la stringa di query nella richiesta di autenticazione HTTP (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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:
|
|||
| 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:
|
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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:
|
|||
| 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:
|
|||
| WithIosKeychainSecurityGroup(String) |
È possibile specificare un gruppo di accesso Keychain da usare per rendere persistente la cache dei token in più applicazioni. In questo modo è possibile condividere la cache dei token tra più applicazioni con lo stesso gruppo di accesso Keychain. La condivisione della cache dei token consente l'accesso Single Sign-On tra tutte le applicazioni che usano lo stesso gruppo di accesso Keychain. Per altre informazioni, vedere https://aka.ms/msal-net-ios-keychain-security-group. |
|||
| WithKerberosTicketClaim(String, KerberosTicketContainer) |
Obsoleti.
Imposta i parametri necessari per ottenere un ticket Kerberos dal servizio Azure AD. |
|||
| WithLegacyCacheCompatibility(Boolean) |
Abilita la serializzazione e la deserializzazione della cache ADAL legacy. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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>) |
|||
| WithMultiCloudSupport(Boolean) |
Abilita il supporto multi-cloud per questa istanza di applicazione client pubblica. Consente alle applicazioni di usare in un'autorità cloud pubblica globale per la libreria e può comunque ottenere token per le risorse dai cloud sovrani. |
|||
| WithOidcAuthority(String) |
Aggiunge un'autorità nota corrispondente a un provider di identità OpenIdConnect generico. MSAL aggiungerà ".well-known/openid-configuration" all'autorità e recupererà i metadati OIDC da questa posizione per individuare gli endpoint. Fare riferimento a https://openid.net/specs/openid-connect-core-1_0.html#Terminology |
|||
| 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. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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>) |
|||
| WithParentActivityOrWindow(Func<IntPtr>) |
Imposta un riferimento a IntPtr su una finestra che attiva la visualizzazione del browser. Usato per centrare il browser che viene visualizzato in questa finestra. |
|||
| WithParentActivityOrWindow(Func<Object>) |
Imposta un riferimento a ViewController (se si usa iOS), l'attività (se si usa Android) IWin32Window o IntPtr (se si usa .Net Framework). Utilizzato per richiamare il browser. |
|||
| 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 (Ereditato da AbstractApplicationBuilder<T>) |
|||
| WithTelemetry(ITelemetryConfig) |
Obsoleti.
Generare eventi di aggregazione di telemetria. (Ereditato da AbstractApplicationBuilder<T>) |
|||
| 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 |
|||
| WithWindowsBrokerOptions(WindowsBrokerOptions) |
Obsoleti.
Consente la personalizzazione dell'esperienza Windows 10 Broker. |
|||
Metodi di estensione
| Nome | Descrizione |
|---|---|
| WithBroker(PublicClientApplicationBuilder, BrokerOptions) |
I broker abilitano l'accesso Single Sign-On, l'identificazione dei dispositivi e la verifica dell'identificazione dell'applicazione, aumentando al contempo la sicurezza delle applicazioni. Usare questa API per abilitare i broker sulle piattaforme desktop. Per https://aka.ms/msal-net-wam altre informazioni sulle impostazioni specifiche della piattaforma necessarie per abilitare il broker, ad esempio gli URI di reindirizzamento. |
| WithBroker(PublicClientApplicationBuilder, BrokerOptions) |
I broker abilitano l'accesso Single Sign-On, l'identificazione dei dispositivi e la sicurezza avanzata. Usare questa API per abilitare i broker sulle piattaforme desktop. Per https://aka.ms/msal-net-wam altre informazioni sulle impostazioni specifiche della piattaforma necessarie per abilitare il broker, ad esempio gli URI di reindirizzamento. |
| WithBrokerPreview(PublicClientApplicationBuilder, Boolean) |
Obsoleti.
Consente a MSAL di usare i flussi broker, che sono più sicuri rispetto ai browser. Per informazioni dettagliate su Windows broker, vederehttps://aka.ms/msal-net-wam |
| WithDesktopFeatures(PublicClientApplicationBuilder) |
Obsoleti.
Aggiunge supporto avanzato per le applicazioni desktop, ad esempio l'interfaccia della riga di comando, WinForms macchine virtuali Windows app. Il supporto aggiunto riguarda:
|
| WithSsoPolicy(PublicClientApplicationBuilder) |
Usare questa API per abilitare l'imposizione di SsoPolicy. Deve essere utilizzato solo da Microsoft applicazioni di prima parte. Questo è applicabile solo quando broker non è abilitato e la visualizzazione Web incorporata è la scelta preferita. Per impostazione predefinita, il broker supporta SsoPolicy e anche webview webview di sistema SsoPolicy è supportato a livello di sistema operativo. |
| WithWindowsBroker(PublicClientApplicationBuilder, Boolean) |
Obsoleti.
Abilita Windows flussi broker su piattaforme meno recenti, ad esempio .NET framework, in cui non sono disponibili nella casella con Microsoft. Identity.Client Per informazioni dettagliate su Windows broker, vederehttps://aka.ms/msal-net-wam |
| WithWindowsDesktopFeatures(PublicClientApplicationBuilder, BrokerOptions) |
Aggiunge supporto avanzato per le applicazioni desktop, ad esempio l'interfaccia della riga di comando, WinForms macchine virtuali Windows app.
|
| WithWindowsEmbeddedBrowserSupport(PublicClientApplicationBuilder) |
Aggiunge un supporto migliore del browser incorporato a MSAL. Le applicazioni AAD useranno il controllo WebBrowser precedente. Altre applicazioni (B2C, ADFS e così via) useranno un browser incorporato basato su Microsoft Edge :https://aka.ms/msal-net-webview2 |