Partilhar via

ClientSecretCredentialBuilder Classe

  • Referência
Pacote:
com.azure.identity
Artefato Maven:
com.azure:azure-identity:1.10.4

public class ClientSecretCredentialBuilder
extends AadCredentialBuilderBase<ClientSecretCredentialBuilder>

Construtor de credenciais fluente para instanciar um ClientSecretCredential.

O ClientSecretCredential adquire um token por meio da autenticação da entidade de serviço. É um tipo de autenticação no Azure que permite um logon não interativo no Azure Active Directory (Azure AD), permitindo que um aplicativo ou serviço se autentique com recursos do Azure. Uma Entidade de Serviço é essencialmente uma identidade criada para um aplicativo em Azure AD que pode ser usada para autenticar com recursos do Azure. Ele é como uma "identidade de usuário" para o aplicativo ou serviço e fornece uma maneira de o aplicativo se autenticar com recursos do Azure sem precisar usar as credenciais de um usuário. O Azure Active Directory (Azure AD) permite que os usuários registrem entidades de serviço que podem ser usadas como uma identidade para autenticação. Um segredo do cliente associado à entidade de serviço registrada é usado como a senha ao autenticar a entidade de serviço. O ClientSecretCredential adquire um token de acesso com um segredo do cliente para uma entidade de serviço/aplicativo AAD registrado. A tenantId, clientId e clientSecret da entidade de serviço são necessárias para que essa credencial adquira um token de acesso. Ele pode ser usado em ambientes de desenvolvimento hospedados no Azure e locais para autenticação. Para obter mais informações, consulte os detalhes de configuração e conhecimento conceitual.

Exemplo: Construir um ClientSecretCredential simples

O exemplo de código a seguir demonstra a criação de um ClientSecretCredential, usando o ClientSecretCredentialBuilder para configurá-lo. Os tenantIdparâmetros , clientId e clientSecret são necessários para criar ClientSecretCredential . Depois que essa credencial for criada, ela poderá ser passada para o construtor de muitos dos construtores de clientes do SDK do Azure para Java como o parâmetro "credencial".

TokenCredential clientSecretCredential = new ClientSecretCredentialBuilder()
     .tenantId(tenantId)
     .clientId(clientId)
     .clientSecret(clientSecret)
     .build();

Exemplo: Construir um ClientSecretCredential por trás de um proxy

O exemplo de código a seguir demonstra a criação de um ClientSecretCredential, usando o ClientSecretCredentialBuilder para configurá-lo. Os tenantIdparâmetros , clientId e clientSecret são necessários para criar ClientSecretCredential. Opcionalmente proxyOptions , o pode ser configurado para direcionar um proxy. Depois que essa credencial for criada, ela poderá ser passada para o construtor de muitos dos construtores de clientes do SDK do Azure para Java como o parâmetro "credencial".

TokenCredential secretCredential = new ClientSecretCredentialBuilder()
     .tenantId(tenantId)
     .clientId(clientId)
     .clientSecret(clientSecret)
     .proxyOptions(new ProxyOptions(Type.HTTP, new InetSocketAddress("10.21.32.43", 5465)))
     .build();

Resumo do Construtor

Construtor Description
ClientSecretCredentialBuilder()

Resumo do método

Modificador e tipo Método e descrição
ClientSecretCredential build()

Cria um novo ClientCertificateCredential com as configurações atuais.
ClientSecretCredentialBuilder clientSecret(String clientSecret)

Define o segredo do cliente para a autenticação.
ClientSecretCredentialBuilder tokenCachePersistenceOptions(TokenCachePersistenceOptions tokenCachePersistenceOptions)

Configura as opções persistentes de cache de token compartilhado e habilita o cache de token persistente que está desabilitado por padrão.

Métodos herdados de AadCredentialBuilderBase

additionallyAllowedTenants additionallyAllowedTenants authorityHost clientId disableInstanceDiscovery enableUnsafeSupportLogging executorService tenantId

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

ClientSecretCredentialBuilder

public ClientSecretCredentialBuilder()

Detalhes do método

build

public ClientSecretCredential build()

Cria um novo ClientCertificateCredential com as configurações atuais.

Returns:

um ClientSecretCredentialBuilder com as configurações atuais.

clientSecret

public ClientSecretCredentialBuilder clientSecret(String clientSecret)

Define o segredo do cliente para a autenticação.

Parameters:

clientSecret - o valor secreto do aplicativo AAD.

Returns:

Uma instância atualizada desse construtor.

tokenCachePersistenceOptions

public ClientSecretCredentialBuilder tokenCachePersistenceOptions(TokenCachePersistenceOptions tokenCachePersistenceOptions)

Configura as opções persistentes de cache de token compartilhado e habilita o cache de token persistente que está desabilitado por padrão. Se configurada, a credencial armazenará tokens em um cache persistido no computador, protegido para o usuário atual, que pode ser compartilhado por outras credenciais e processos.

Parameters:

tokenCachePersistenceOptions - as opções de configuração de cache de token

Returns:

Uma instância atualizada desse construtor com as opções de cache de token configuradas.

Aplica-se a