Partilhar via


AzureDeveloperCliCredential class

Azure Developer CLI é uma ferramenta de interface de linha de comandos que permite aos programadores criar, gerir e implementar recursos no Azure. Baseia-se na CLI do Azure e fornece funcionalidades adicionais específicas aos programadores do Azure. Permite que os utilizadores se autentiquem como utilizador e/ou principal de serviço em relação Microsoft Entra ID. O AzureDeveloperCliCredential autentica-se num ambiente de desenvolvimento e adquire um token em nome do utilizador ou principal de serviço com sessão iniciada no Azure Developer CLI. Funciona como o Azure Developer CLI com sessão iniciada no utilizador ou principal de serviço e executa um comando da CLI do Azure por baixo para autenticar a aplicação em relação a Microsoft Entra ID.

Configurar o AzureDeveloperCliCredential

Para utilizar esta credencial, o programador tem de se autenticar localmente no Azure Developer CLI através de um dos comandos abaixo:

  1. Execute "azd auth login" no Azure Developer CLI para se autenticar interativamente como utilizador.
  2. Execute "azd auth login --client-id clientID --client-secret clientSecret --tenant-id tenantID" para autenticar como um principal de serviço.

Poderá ter de repetir este processo após um determinado período de tempo, dependendo da validade do token de atualização na sua organização. Geralmente, o período de validade do token de atualização é de algumas semanas a alguns meses. O AzureDeveloperCliCredential irá pedir-lhe para iniciar sessão novamente.

Construtores

AzureDeveloperCliCredential(AzureDeveloperCliCredentialOptions)

Cria uma instância do AzureDeveloperCliCredential.

Para utilizar esta credencial, certifique-se de que já iniciou sessão através da ferramenta "azd" com o comando "azd auth login" na linha de comandos.

Métodos

getToken(string | string[], GetTokenOptions)

Autentica com Microsoft Entra ID e devolve um token de acesso se for bem-sucedido. Se a autenticação falhar, será apresentado um CredentialUnavailableError com os detalhes da falha.

Detalhes do Construtor

AzureDeveloperCliCredential(AzureDeveloperCliCredentialOptions)

Cria uma instância do AzureDeveloperCliCredential.

Para utilizar esta credencial, certifique-se de que já iniciou sessão através da ferramenta "azd" com o comando "azd auth login" na linha de comandos.

new AzureDeveloperCliCredential(options?: AzureDeveloperCliCredentialOptions)

Parâmetros

options
AzureDeveloperCliCredentialOptions

Opções, para permitir opcionalmente pedidos multi-inquilinos.

Detalhes de Método

getToken(string | string[], GetTokenOptions)

Autentica com Microsoft Entra ID e devolve um token de acesso se for bem-sucedido. Se a autenticação falhar, será apresentado um CredentialUnavailableError com os detalhes da falha.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

Parâmetros

scopes

string | string[]

A lista de âmbitos aos quais o token terá acesso.

options
GetTokenOptions

As opções utilizadas para configurar quaisquer pedidos que esta implementação tokenCredential possa fazer.

Devoluções

Promise<AccessToken>