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

T
Herança
AbstractApplicationBuilder<T>
Derivado

Métodos

Nome Description
WithAdfsAuthority(String, Boolean)

Adiciona uma autoridade conhecida correspondente a um servidor do ADFS. Consulte https://aka.ms/msal-net-adfs

WithAuthority(AadAuthorityAudience, Boolean)

Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários que especificam o público-alvo de entrada (a nuvem é o Azure nuvem pública). Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários que especificam a instância de nuvem e o público-alvo de entrada. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, Guid, Boolean)

Adiciona uma autoridade de Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) descrito por sua instância de nuvem e sua ID de locatário. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, String, Boolean)

Adiciona uma autoridade de Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) descrito por sua instância de nuvem e seu nome de domínio ou ID de locatário. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(String, Boolean)

Adiciona uma autoridade de Azure AD conhecida ao aplicativo para conectar usuários que especificam o URI de autoridade completa. Consulte as opções de configuração do aplicativo.

WithAuthority(String, Guid, Boolean)

Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) especificada por sua ID de locatário. Consulte as opções de configuração do aplicativo.

WithAuthority(String, String, Boolean)

Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) descrito pelo nome de domínio. Consulte https://aka.ms/msal-net-application-configuration.

WithAuthority(Uri, Boolean)

Adiciona uma autoridade conhecida ao aplicativo. Consulte as opções de configuração do aplicativo. Esse construtor é usado principalmente para cenários em que a autoridade não é uma autoridade padrão Azure do AD, nem uma autoridade do ADFS, nem uma autoridade Azure AD B2C. Para Azure AD, mesmo em nuvens soberanas, prefira usar outras substituições, comoWithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

WithB2CAuthority(String)

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

WithCacheOptions(CacheOptions)

Opções para caches de token MSAL.

A MSAL mantém um cache de token internamente na memória. Por padrão, esse objeto de cache faz parte de cada instância de PublicClientApplication ou ConfidentialClientApplication. Esse método permite a personalização do cache de token na memória da MSAL.

O cache de memória da MSAL é diferente da serialização do cache de token. A serialização de cache extrai os tokens de um cache (por exemplo, Redis, Cosmos ou um arquivo em disco), em que eles são armazenados no formato JSON, no cache de memória interna da MSAL. As operações de cache de memória não envolvem operações JSON.

A serialização de cache externo continua sendo a maneira recomendada de lidar com aplicativos da área de trabalho, site e APIs da Web, pois fornece persistência. No momento, essas opções não controlam a serialização de cache externo.

Diretrizes detalhadas para cada tipo de aplicativo e plataforma: https://aka.ms/msal-net-token-cache-serialization

WithClientCapabilities(IEnumerable<String>)

Microsoft extensão OIDC específica da identidade que permite que os desafios de recursos sejam resolvidos sem interação. Permite a configuração de um ou mais recursos do cliente, por exemplo, "llt"

WithClientId(String)

Define a ID do cliente do aplicativo

WithClientName(String)

Define o nome da API do SDK de chamada 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 retorno de chamada de registro em log de depuração como um método de depuração padrão que exibe o nível da mensagem e a própria mensagem. Para obter detalhes, consulte https://aka.ms/msal-net-logging

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

Permite o uso de recursos experimentais e APIs. Se esse sinalizador não estiver definido, os recursos experimentais gerarão uma exceção. Para obter detalhes, consulte https://aka.ms/msal-net-experimental-features

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

Define parâmetros de consulta extra para a cadeia de caracteres de consulta na solicitação de autenticação HTTP

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

Define parâmetros de consulta extra para a cadeia de caracteres de consulta na solicitação de autenticação HTTP com controle sobre quais parâmetros estão incluídos na chave de cache

WithExtraQueryParameters(String)
Obsoleto.

Define parâmetros de consulta extra para a cadeia de caracteres de consulta na solicitação de autenticação HTTP

WithHttpClientFactory(IMsalHttpClientFactory, Boolean)

Usa um específico IMsalHttpClientFactory para se comunicar com o IdP. Isso 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 se comunicar com o IdP. Isso permite cenários avançados, como definir um proxy ou definir o Agente.

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

Permite que os desenvolvedores configurem suas próprias autoridades válidas. Uma cadeia de caracteres json semelhante a https://aka.ms/aad-instance-discovery deve ser fornecida. A MSAL usa essas informações para:

  • Chamar APIs REST no ambiente especificado no preferred_network
  • Identificar um ambiente no qual salvar tokens e contas no cache
  • Usar os aliases de ambiente para corresponder tokens emitidos a outras autoridades
Para obter mais detalhes, consulte https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDicoveryMetadata(Uri)
Obsoleto.

Permite que uma organização configure seu próprio serviço para lidar com a descoberta de instância, o que permite um melhor cache para ambientes de microsserviço/serviço. Um Uri que retorna uma resposta semelhante a https://aka.ms/aad-instance-discovery deve ser fornecida. A MSAL usa essas informações para:

  • Chamar APIs REST no ambiente especificado no preferred_network
  • Identificar um ambiente no qual salvar tokens e contas no cache
  • Usar os aliases de ambiente para corresponder tokens emitidos a outras autoridades
Para obter mais detalhes, consulte https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscovery(Boolean)

Determina se a descoberta de instância é executada ou não ao tentar se autenticar. Definir isso como false desabilitará completamente a descoberta de instância e a validação de autoridade. No entanto, isso não afetará o comportamento do aplicativo configurado com pontos de extremidade regionais.

WithInstanceDiscoveryMetadata(String)

Permite que os desenvolvedores configurem suas próprias autoridades válidas. Uma cadeia de caracteres json semelhante a https://aka.ms/aad-instance-discovery deve ser fornecida. A MSAL usa essas informações para:

  • Chamar APIs REST no ambiente especificado no preferred_network
  • Identificar um ambiente no qual salvar tokens e contas no cache
  • Usar os aliases de ambiente para corresponder tokens emitidos a outras autoridades
Para obter mais detalhes, consulte https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscoveryMetadata(Uri)

Permite que uma organização configure seu próprio serviço para lidar com a descoberta de instância, o que permite um melhor cache para ambientes de microsserviço/serviço. Um Uri que retorna uma resposta semelhante a https://aka.ms/aad-instance-discovery deve ser fornecida. A MSAL usa essas informações para:

  • Chamar APIs REST no ambiente especificado no preferred_network
  • Identificar um ambiente no qual salvar tokens e contas no cache
  • Usar os aliases de ambiente para corresponder tokens emitidos a outras autoridades
Para obter mais detalhes, consulte https://aka.ms/msal-net-custom-instance-metadata
WithLegacyCacheCompatibility(Boolean)

Habilita a serialização e a desserialização do cache ADAL herdadas.

WithLogging(IIdentityLogger, Boolean)

Define o Agente de Identidade. Para obter detalhes, consulte https://aka.ms/msal-net-logging

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

Define o retorno de chamada de registro em log. Para obter detalhes, consulte https://aka.ms/msal-net-logging

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

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

WithOptions(BaseApplicationOptions)

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

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

Define o URI de redirecionamento do aplicativo. O URI também deve ser registrado no portal do aplicativo. Consulte https://aka.ms/msal-net-application-configuration

WithTelemetry(ITelemetryConfig)
Obsoleto.

Gerar eventos de agregação de telemetria.

WithTenantId(String)

Define a ID do locatário da organização da qual o aplicativo permitirá que os usuários entrem. Isso é clássicamente um GUID ou um nome de domínio. Consulte https://aka.ms/msal-net-application-configuration. Embora também seja possível definir tenantId como common, organizationse consumers, é recomendável usar uma das substituições de WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean).

Aplica-se a