Compartilhar via


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
builtins.object
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 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.

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.

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

Exceções

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

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