AadCredentialBuilderBase<T> Classe

Pacote:

com.azure.identity

Artefato Maven:

com.azure:azure-identity:1.10.4

• java.lang.Object
• • com.azure.identity.CredentialBuilderBase<T>
  • • com.azure.identity.AadCredentialBuilderBase<T>

Parâmetros de tipo

T

o tipo do construtor de credenciais

public abstract class AadCredentialBuilderBase
extends CredentialBuilderBase<T>

A classe base para construtores de credenciais que permitem especificar uma ID do cliente, uma ID de locatário, um host de autoridade e locatários permitidos adicionalmente para um Azure Active Directory.

Resumo do Construtor

Construtor	Description
AadCredentialBuilderBase()

Resumo do método

Modificador e tipo	Método e descrição
T	additionallyAllowedTenants(String[] additionallyAllowedTenants) Para aplicativos multilocatários, especifica locatários adicionais para os quais a credencial pode adquirir tokens.
T	additionallyAllowedTenants(List<String> additionallyAllowedTenants) Para aplicativos multilocatários, especifica locatários adicionais para os quais a credencial pode adquirir tokens.
T	authorityHost(String authorityHost) Especifica o ponto de extremidade do Azure Active Directory para adquirir tokens.
T	clientId(String clientId) Define a ID do cliente do aplicativo.
T	disableInstanceDiscovery() Desabilita a configuração que determina se a descoberta de instância é executada ou não ao tentar se autenticar.
T	enableUnsafeSupportLogging() Habilita o log de suporte adicional para aplicativos cliente públicos e confidenciais.
T	executorService(ExecutorService executorService) Especifica o Serviço executora ser usado para executar as solicitações de autenticação.
T	tenantId(String tenantId) Define a ID do locatário do aplicativo.

Métodos herdados de CredentialBuilderBase

addPolicy clientOptions configuration enableAccountIdentifierLogging httpClient httpLogOptions httpPipeline maxRetry pipeline proxyOptions retryOptions retryPolicy retryTimeout

Métodos herdados de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Detalhes do construtor

AadCredentialBuilderBase

public AadCredentialBuilderBase()

Detalhes do método

additionallyAllowedTenants

public T additionallyAllowedTenants(String[] additionallyAllowedTenants)

Para aplicativos multilocatários, especifica locatários adicionais para os quais a credencial pode adquirir tokens. Adicione o valor curinga "*" para permitir que a credencial adquira tokens para qualquer locatário no qual o aplicativo está instalado.

Parameters:

additionallyAllowedTenants - os locatários permitidos adicionalmente.

Returns:

Uma instância atualizada desse construtor com os locatários adicionais configurados.

additionallyAllowedTenants

public T additionallyAllowedTenants(List additionallyAllowedTenants)

Para aplicativos multilocatários, especifica locatários adicionais para os quais a credencial pode adquirir tokens. Adicione o valor curinga "*" para permitir que a credencial adquira tokens para qualquer locatário no qual o aplicativo está instalado.

Parameters:

additionallyAllowedTenants - os locatários permitidos adicionalmente.

Returns:

Uma instância atualizada desse construtor com os locatários adicionais configurados.

authorityHost

public T authorityHost(String authorityHost)

Especifica o ponto de extremidade do Azure Active Directory para adquirir tokens.

Parameters:

authorityHost - o ponto de extremidade do Azure Active Directory

Returns:

Uma instância atualizada desse construtor com o host de autoridade definido conforme especificado.

clientId

public T clientId(String clientId)

Define a ID do cliente do aplicativo.

Parameters:

clientId - a ID do cliente do aplicativo.

Returns:

Uma instância atualizada desse construtor com a ID do cliente definida conforme especificado.

disableInstanceDiscovery

public T disableInstanceDiscovery()

Desabilita a configuração que determina se a descoberta de instância é executada ou não ao tentar se autenticar. Isso desabilitará completamente a descoberta de instância e a validação de autoridade. Essa funcionalidade destina-se ao uso em cenários em que o ponto de extremidade de metadados não pode ser alcançado, como em nuvens privadas ou no Azure Stack. O processo de descoberta de instância envolve a recuperação de metadados de autoridade de https://login.microsoft.com/ para validar a autoridade. Ao utilizar essa API, a validação da autoridade é desabilitada. Como resultado, é crucial garantir que o host de autoridade configurado seja válido e confiável.

Returns:

Uma instância atualizada desse construtor com a descoberta de instância desabilitada.

enableUnsafeSupportLogging

public T enableUnsafeSupportLogging()

Habilita o log de suporte adicional para aplicativos cliente públicos e confidenciais. Isso habilita o registro em log de PII no MSAL4J, conforme descrito aqui.

Essa operação registrará a PII, incluindo tokens. Ele só deve ser usado quando direcionado pelo suporte.

Returns:

Uma instância atualizada desse construtor com log de suporte adicional habilitado.

executorService

public T executorService(ExecutorService executorService)

Especifica o ExecutorService a ser usado para executar as solicitações de autenticação. O desenvolvedor é responsável por manter o ciclo de vida do ExecutorService.

Se isso não estiver configurado, o common fork join pool será usado, que também será compartilhado com outras tarefas do aplicativo. Se o pool comum for fortemente usado para outras tarefas, as solicitações de autenticação poderão morrer de fome e a configuração desse serviço executor deverá ser considerada.

O serviço executor e poderá ser desligado com segurança se o TokenCredential não estiver mais sendo usado pelos clientes do SDK do Azure e deverá ser desligado antes da saída do aplicativo.

Parameters:

executorService - o serviço executor a ser usado para executar solicitações de autenticação.

Returns:

Uma instância atualizada desse construtor com o serviço executor definido conforme especificado.

tenantId

public T tenantId(String tenantId)

Define a ID do locatário do aplicativo.

Parameters:

tenantId - a ID do locatário do aplicativo.

Returns:

Uma instância atualizada desse construtor com a ID do locatário definida conforme especificado.