AzureDeveloperCliCredential Classe

  • Referência

Autentica ao pedir um token do Azure Developer CLI.

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 no Azure Active Directory (Azure AD). 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. Atua como o Azure Developer CLI utilizador ou principal de serviço com sessão iniciada e executa um comando da CLI do Azure por baixo para autenticar a aplicação no Azure Active Directory.

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

  • Execute "azd auth login" no Azure Developer CLI para se autenticar interativamente como utilizador.

  • Execute "azd auth login –client-id 'client_id' –client-secret 'client_secret' –tenant-id 'tenant_id'" para autenticar como 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.

Herança
builtins.object
AzureDeveloperCliCredential

Construtor

AzureDeveloperCliCredential(*, tenant_id: str = '', additionally_allowed_tenants: List[str] | None = None, process_timeout: int = 10)

Parâmetros

tenant_id
str

Inquilino opcional a incluir no pedido de token.

additionally_allowed_tenants
List[str]

Especifica inquilinos para além do "tenant_id" especificado para o qual a credencial pode adquirir tokens. Adicione o valor de caráter universal "*" para permitir que a credencial adquira tokens para qualquer inquilino a que a aplicação possa aceder.

process_timeout
int

Segundos para aguardar que o processo de Azure Developer CLI responda. A predefinição é de 10 segundos.

Exemplos

Crie um AzureDeveloperCliCredential.


   from azure.identity import AzureDeveloperCliCredential

   credential = AzureDeveloperCliCredential()

Métodos

close

Chamar este método é desnecessário.
get_token

Pedir um token de acesso para âmbitos.

Este método é chamado automaticamente pelos clientes do SDK do Azure. As aplicações que chamam diretamente este método também têm de processar a colocação em cache de tokens, uma vez que esta credencial não coloca em cache os tokens adquiridos.

close

Chamar este método é desnecessário.

close() -> None

get_token

Pedir um token de acesso para âmbitos.

Este método é chamado automaticamente pelos clientes do SDK do Azure. As aplicações que chamam diretamente este método também têm de processar a colocação em cache de tokens, uma vez que esta credencial não coloca em cache os tokens adquiridos.

get_token(*scopes: str, claims: str | None = None, tenant_id: str | None = None, **kwargs: Any) -> AccessToken

Parâmetros

scopes
str
Necessário

âmbito pretendido para o token de acesso. Esta credencial permite apenas um âmbito por pedido. Para obter mais informações sobre âmbitos, consulte https://video2.skills-academy.com/azure/active-directory/develop/scopes-oidc.

claims
str

não utilizado por esta credencial; qualquer valor fornecido será ignorado.

tenant_id
str

inquilino opcional a incluir no pedido de token.

Devoluções

Um token de acesso com os âmbitos pretendidos.

Tipo de retorno

AccessToken

Exceções

CredentialUnavailableError

a credencial não conseguiu invocar a Azure Developer CLI.

ClientAuthenticationError

a credencial invocou o Azure Developer CLI, mas não recebeu um token de acesso.