AzureDeveloperCliCredential Classe

Autentica solicitando um token do Azure Developer CLI.

Azure Developer CLI é uma ferramenta de interface de linha de comando que permite que os desenvolvedores criem, gerenciem e implantem recursos no Azure. Ele é criado com base na CLI do Azure e fornece funcionalidade adicional específica para desenvolvedores do Azure. Ele permite que os usuários se autentiquem como um usuário e/ou uma entidade de serviço no Azure Active Directory (Azure AD). O AzureDeveloperCliCredential é autenticado em um ambiente de desenvolvimento e adquire um token em nome do usuário conectado ou da entidade de serviço no Azure Developer CLI. Ele atua como o Azure Developer CLI usuário conectado ou entidade de serviço e executa um comando da CLI do Azure abaixo para autenticar o aplicativo no Azure Active Directory.

Para usar essa credencial, o desenvolvedor precisa se autenticar localmente no Azure Developer CLI usando um dos comandos abaixo:

• Execute "azd auth login" no Azure Developer CLI para autenticar interativamente como um usuário.

• Execute "azd auth login –client-id 'client_id' –client-secret 'client_secret' –tenant-id 'tenant_id'" para se autenticar como uma entidade de serviço.

Talvez seja necessário repetir esse processo após um determinado período, dependendo da validade do token de atualização em sua organização. Em geral, o período de validade do token de atualização é de algumas semanas a alguns meses. AzureDeveloperCliCredential solicitará que você entre novamente.

Herança

azure.identity.aio._internal.AsyncContextManager

AzureDeveloperCliCredential

Construtor

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

Parâmetros

tenant_id

str

Locatário opcional a ser incluído na solicitação de token.

additionally_allowed_tenants

List[str]

Especifica locatários além do "tenant_id" especificado para o qual a credencial pode adquirir tokens. Adicione o valor curinga "*" para permitir que a credencial adquira tokens para qualquer locatário que o aplicativo possa acessar.

process_timeout

int

Segundos para aguardar a resposta do processo de Azure Developer CLI. O valor padrão é 10 segundos.

Exemplos

Crie um AzureDeveloperCliCredential.

   from azure.identity.aio import AzureDeveloperCliCredential

   credential = AzureDeveloperCliCredential()

Métodos

close	Chamar esse método é desnecessário
get_token	Solicite um token de acesso para escopos. Esse método é chamado automaticamente por clientes do SDK do Azure. Os aplicativos que chamam esse método diretamente também devem manipular o cache de token porque essa credencial não armazena em cache os tokens adquiridos.

close

Chamar esse método é desnecessário

async close() -> None

get_token

Solicite um token de acesso para escopos.

Esse método é chamado automaticamente por clientes do SDK do Azure. Os aplicativos que chamam esse método diretamente também devem manipular o cache de token porque essa credencial não armazena em cache os tokens adquiridos.

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

Parâmetros

scopes

str

Obrigatório

escopo desejado para o token de acesso. Essa credencial permite apenas um escopo por solicitação. Para obter mais informações sobre escopos, consulte https://learn.microsoft.com/azure/active-directory/develop/scopes-oidc.

claims

str

não usado por essa credencial; qualquer valor fornecido será ignorado.

tenant_id

str

locatário opcional a ser incluído na solicitação de token.

Retornos

Um token de acesso com os escopos desejados.

Tipo de retorno

AccessToken

Exceções

CredentialUnavailableError

a credencial não pôde invocar o Azure Developer CLI.

ClientAuthenticationError

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