Partilhar via


Iniciar sessão com um token de acesso pessoal

Azure DevOps Serviços

Este artigo explica como iniciar sessão usando um token de acesso pessoal (PAT) do Azure DevOps. Pode iniciar sessão interativamente com o Microsoft Entra através do comando az login ou usando um Azure DevOps PAT. Para criar um PAT, consulte Usar tokens de acesso pessoal.

Importante

Considere usar tokens mais seguros Microsoft Entra em vez de tokens de acesso pessoal de maior risco. Para mais informações, consulte Reduzir o uso do PAT. Consulte as orientações de autenticação para escolher o mecanismo de autenticação adequado às suas necessidades.

Para automação de pipelines, use um PAT apenas quando necessário. Para autenticação baseada em ligação a serviços, consulte Gerir ligações de serviço.

Pré-requisitos

Categoria Requerimentos
Níveis de acesso Pelo menos Acesso Básico.
Permissões Membro do grupo Project Collection Valid Users.
Tokens Um token de acesso pessoal (PAT) com os escopos apropriados para os comandos que quer executar.
Tools CLI do Azure com a extensão CLI Azure DevOps.

Para usar um PAT com a CLI do Azure DevOps, escolha um dos seguintes métodos:

Inicie sessão com az devops login e insira o seu PAT

Execute o az devops login comando e introduza o seu PAT quando solicitado:

az devops login --organization https://dev.azure.com/contoso
Token:

Se já fez login interativamente com az login, não precisa de fornecer um PAT. Os az devops comandos suportam iniciar sessão através de az login.

Quando você entra com êxito, esse comando também pode definir sua organização padrão se nenhuma estiver configurada.

Nota

Para usuários convidados, apenas az devops login é suportado.

Use um PAT para iniciar sessão no az devops

Podes fornecer o teu PAT ao CLI Azure DevOps transmitindo-o para o comando az devops login. Essa abordagem é útil para automação e pipelines de CI/CD onde a entrada interativa não é possível.

Usar uma variável

Substitua ###### por $(System.AccessToken) ou outra variável de pipeline:

echo "######" | az devops login --organization https://dev.azure.com/contoso/

Usar um arquivo

Também pode armazenar o seu PAT num ficheiro e canalizá-lo para o comando login:

cat my_pat_token.txt | az devops login --organization https://dev.azure.com/contoso/

Autenticar com a variável de ambiente AZURE_DEVOPS_EXT_PAT

Para cenários não interativos ou de automação, defina a AZURE_DEVOPS_EXT_PAT variável de ambiente como seu PAT. Se você não tiver usado az login ou az devops login, todos os az devops comandos tentarão usar essa variável para autenticação.

Defina a variável de ambiente no nível do processo antes de executar comandos da CLI para habilitar a autenticação contínua.

# set environment variable for current process
$env:AZURE_DEVOPS_EXT_PAT = 'xxxxxxxxxx'