Compartilhar via

Iniciar sessão no Azure com uma entidade de serviço usando a CLI do Azure

  • Artigo

Entidades de serviço são contas que não estão associadas a nenhum usuário específico, as quais podem ter permissões atribuídas por meio de funções predefinidas. Autenticar com uma entidade de serviço é a melhor maneira de gravar scripts seguros ou programas, permitindo a aplicação de restrições de permissões e informações de credenciais estáticas armazenadas localmente. Para saber mais sobre entidades de serviço, confira Trabalhar com entidades de serviço do Azure usando a CLI do Azure.

Para entrar com uma entidade de serviço, você precisa:

  • Da URL ou nome associado à entidade de serviço
  • O segredo do cliente da entidade de serviço ou o certificado X509 usado para criar a entidade de serviço no formato PEM
  • O locatário associado à entidade de serviço, como um .onmicrosoft.com domínio ou ID de locatário do Microsoft Entra

Observe dois fatos importantes ao trabalhar com entidades de serviço e a CLI do Azure:

  • Um CERTIFICADO precisa ser anexado à CHAVE PRIVADA dentro de um arquivo PEM. Para obter um exemplo de um formato de arquivo PEM, confira Autenticação baseada em certificado.

  • Se a entidade de serviço usa um certificado que é armazenado no cofre de chaves, a chave privada do certificado deve estar disponível sem entrar no Azure. Para recuperar o certificado de az login, confira Recuperar certificado do Key Vault.

Faça login com o segredo do cliente:

az login --service-principal --username APP_ID --password CLIENT_SECRET --tenant TENANT_ID

Faça login com certificado:

az login --service-principal --username APP_ID --certificate /path/to/cert.pem --tenant TENANT_ID

Importante

Caso deseje evitar a exibição de sua senha no console e esteja usando az login interativamente, use o comando read -s em bash.

read -sp "Azure password: " AZ_PASS && echo && az login --service-principal --username <app-id> --password $AZ_PASS --tenant <tenant>

No PowerShell, use o cmdlet Get-Credential.

$AzCred = Get-Credential -UserName <app-id>
az login --service-principal --username $AzCred.UserName --password $AzCred.GetNetworkCredential().Password --tenant <tenant>

Confira também