AbstractApplicationBuilder<T> Classe

Definição

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)

Parâmetros de Tipo Genérico

T
Herança
AbstractApplicationBuilder<T>
Derivado

Métodos

Name Descrição
WithAdfsAuthority(String, Boolean)

Adiciona uma Autoridade conhecida correspondente a um servidor ADFS. Veja https://aka.ms/msal-net-adfs

WithAuthority(AadAuthorityAudience, Boolean)

Adiciona uma autoridade conhecida do Azure AD à aplicação para os utilizadores que iniciam sessão, especificando o público de início de sessão (a cloud sendo a cloud pública do Azure). Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

Adiciona uma autoridade conhecida do Azure AD à aplicação para os utilizadores de iniciar sessão, especificando a instância cloud e o público de iniciação de sessão. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, Guid, Boolean)

Adiciona uma autoridade conhecida do Azure AD à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) descrita pela sua instância cloud e pelo seu ID de inquilino. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, String, Boolean)

Adiciona uma autoridade Azure AD conhecida à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) descrita pela sua instância cloud e pelo seu nome de domínio ou ID de inquilino. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(String, Boolean)

Adiciona uma autoridade conhecida do Azure AD à aplicação para os utilizadores que iniciam sessão, especificando o URI de autoridade completa. Ver opções de configuração da aplicação.

WithAuthority(String, Guid, Boolean)

Adiciona uma autoridade conhecida do Azure AD à aplicação para iniciar sessão com utilizadores a partir de uma única organização (aplicação de inquilin único) especificada pelo seu ID de inquilino. Ver opções de configuração da aplicação.

WithAuthority(String, String, Boolean)

Adiciona uma autoridade Azure AD conhecida à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) descrita pelo seu nome de domínio. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(Uri, Boolean)

Adiciona uma autoridade conhecida à aplicação. Ver opções de configuração da aplicação. Este construtor é usado principalmente em cenários onde a autoridade não é uma autoridade padrão do Azure AD, nem uma autoridade ADFS, nem uma autoridade B2C do Azure AD. Para o Azure AD, mesmo em nuvens soberanas, prefira usar outros overrides comoWithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

WithB2CAuthority(String)

Adiciona uma autoridade conhecida correspondente a uma política B2C do Azure AD. Veja https://aka.ms/msal-net-b2c-specificities

WithCacheOptions(CacheOptions)

Opções para caches de tokens MSAL.

O MSAL mantém uma cache de tokens internamente na memória. Por defeito, este objeto cache faz parte de cada instância de PublicClientApplication ou ConfidentialClientApplication. Este método permite a personalização da cache de tokens em memória do MSAL.

A cache de memória da MSAL é diferente da serialização da cache de tokens. A serialização da cache retira os tokens de uma cache (por exemplo, Redis, Cosmos ou um ficheiro no disco), onde são armazenados em formato JSON, para a cache interna de memória da MSAL. As operações de cache de memória não envolvem operações JSON.

A serialização da cache externa continua a ser a forma recomendada de lidar com aplicações de ambiente de trabalho, sites web e APIs web, pois proporciona persistência. Estas opções não controlam atualmente a serialização da cache externa.

Orientação detalhada para cada tipo de aplicação e plataforma: https://aka.ms/msal-net-token-cache-serialization

WithClientCapabilities(IEnumerable<String>)

Extensão OIDC específica do Microsoft Identity que permite resolver desafios de recursos sem interação. Permite a configuração de uma ou mais capacidades do cliente, por exemplo, "llt"

WithClientId(String)

Define o ID do Cliente da aplicação

WithClientName(String)

Define o nome da API do SDK chamador para fins de telemetria.

(Herdado de BaseAbstractApplicationBuilder<T>)
WithClientVersion(String)

Define a versão do SDK de chamada para fins de telemetria.

(Herdado de BaseAbstractApplicationBuilder<T>)
WithDebugLoggingCallback(LogLevel, Boolean, Boolean)

Define o callback de registo de depuração para um método de depuração predefinido que mostra o nível da mensagem e da própria mensagem. Para mais informações, consultar: https://aka.ms/msal-net-logging

(Herdado de BaseAbstractApplicationBuilder<T>)
WithExperimentalFeatures(Boolean)

Permite a utilização de funcionalidades experimentais e APIs. Se esta bandeira não estiver definida, as funcionalidades experimentais lançam uma exceção. Para mais informações, consultar: https://aka.ms/msal-net-experimental-features

(Herdado de BaseAbstractApplicationBuilder<T>)
WithExtraQueryParameters(IDictionary<String,String>)
Obsoleto.

Define parâmetros extra de consulta para a cadeia de consulta no pedido de autenticação HTTP

WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>)

Define Parâmetros Extra de Consulta para a cadeia de consulta no pedido de autenticação HTTP com controlo sobre quais os parâmetros incluídos na chave de cache

WithExtraQueryParameters(String)
Obsoleto.

Define parâmetros extra de consulta para a cadeia de consulta no pedido de autenticação HTTP

WithHttpClientFactory(IMsalHttpClientFactory, Boolean)

Usa um específico IMsalHttpClientFactory para comunicar com o IDP. Isto permite cenários avançados, como definir um proxy ou definir o Agente.

(Herdado de BaseAbstractApplicationBuilder<T>)
WithHttpClientFactory(IMsalHttpClientFactory)

Usa um específico IMsalHttpClientFactory para comunicar com o IDP. Isto permite cenários avançados, como definir um proxy ou definir o Agente.

(Herdado de BaseAbstractApplicationBuilder<T>)
WithInstanceDicoveryMetadata(String)
Obsoleto.

Permite aos programadores configurar as suas próprias autoridades válidas. Deve ser fornecida uma cadeia json semelhante a https://aka.ms/aad-instance-discovery . A MSAL utiliza esta informação para:

  • Chamadas APIs REST no ambiente especificado na preferred_network
  • Identifique um ambiente onde guardar tokens e contas na cache
  • Usar os pseudónimos ambientais para corresponder a tokens emitidos a outras autoridades
Para mais detalhes, veja https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDicoveryMetadata(Uri)
Obsoleto.

Permite a uma organização configurar o seu próprio serviço para gerir a descoberta de instâncias, o que permite um melhor cache para ambientes de microserviços/serviços. Deve ser fornecido um Uri que devolva uma resposta semelhante à https://aka.ms/aad-instance-discovery . A MSAL utiliza esta informação para:

  • Chamadas APIs REST no ambiente especificado na preferred_network
  • Identifique um ambiente onde guardar tokens e contas na cache
  • Usar os pseudónimos ambientais para corresponder a tokens emitidos a outras autoridades
Para mais detalhes, veja https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscovery(Boolean)

Determina se a descoberta de instâncias é realizada ao tentar autenticar. Definir isto como falso desativa completamente a descoberta de instâncias e a validação de autoridade. No entanto, isto não afetará o comportamento da aplicação configurada com endpoints regionais.

WithInstanceDiscoveryMetadata(String)

Permite aos programadores configurar as suas próprias autoridades válidas. Deve ser fornecida uma cadeia json semelhante a https://aka.ms/aad-instance-discovery . A MSAL utiliza esta informação para:

  • Chamadas APIs REST no ambiente especificado na preferred_network
  • Identifique um ambiente onde guardar tokens e contas na cache
  • Usar os pseudónimos ambientais para corresponder a tokens emitidos a outras autoridades
Para mais detalhes, veja https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscoveryMetadata(Uri)

Permite a uma organização configurar o seu próprio serviço para gerir a descoberta de instâncias, o que permite um melhor cache para ambientes de microserviços/serviços. Deve ser fornecido um Uri que devolva uma resposta semelhante à https://aka.ms/aad-instance-discovery . A MSAL utiliza esta informação para:

  • Chamadas APIs REST no ambiente especificado na preferred_network
  • Identifique um ambiente onde guardar tokens e contas na cache
  • Usar os pseudónimos ambientais para corresponder a tokens emitidos a outras autoridades
Para mais detalhes, veja https://aka.ms/msal-net-custom-instance-metadata
WithLegacyCacheCompatibility(Boolean)

Permite a serialização e desserialização da cache ADAL legado.

WithLogging(IIdentityLogger, Boolean)

Define o registo de identidade. Para mais informações, consultar: https://aka.ms/msal-net-logging

(Herdado de BaseAbstractApplicationBuilder<T>)
WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>)

Define o callback de registo. Para mais informações, consultar: https://aka.ms/msal-net-logging

(Herdado de BaseAbstractApplicationBuilder<T>)
WithOptions(ApplicationOptions)

Define opções de aplicação, que podem, por exemplo, ter sido lidas a partir de ficheiros de configuração. Consulte https://aka.ms/msal-net-application-configuration.

WithOptions(BaseApplicationOptions)

Define opções de aplicação, que podem, por exemplo, ter sido lidas a partir de ficheiros de configuração. Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de BaseAbstractApplicationBuilder<T>)
WithRedirectUri(String)

Define o URI de redirecionamento da aplicação. O URI deve também estar registado no portal de candidaturas. Veja https://aka.ms/msal-net-application-configuration

WithTelemetry(ITelemetryConfig)
Obsoleto.

Gerar eventos de agregação de telemetria.

WithTenantId(String)

Define o ID do inquilino da organização a partir do qual a aplicação permitirá aos utilizadores iniciar sessão. Isto é classicamente um GUID ou um nome de domínio. Consulte https://aka.ms/msal-net-application-configuration. Embora também seja possível definir tenantId para common, organizations, e consumers, recomenda-se usar um dos overrides de WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean).

Aplica-se a