Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Serviços do Azure DevOps
Use uma entidade de serviço do Microsoft Entra ou uma identidade gerenciada para automação do Azure DevOps executada sem um usuário. Essas identidades de aplicativo não estão vinculadas a uma conta de funcionário e adquirem tokens de acesso Microsoft Entra de curta duração em vez de PATs (tokens de acesso pessoal).
Identidades gerenciadas e entidades de serviço têm requisitos diferentes para o gerenciamento de credenciais:
| Identity | Melhor para | Gerenciamento de credenciais |
|---|---|---|
| Identidade gerenciada | Cargas de trabalho hospedadas no Azure | Azure gerencia a identidade e suas credenciais. Seu aplicativo não armazena um segredo do cliente. |
| Entidade de serviço | Cargas de trabalho fora de Azure ou cargas de trabalho que precisam de uma identidade de aplicativo portátil | Seu aplicativo usa federação de identidade de carga de trabalho, um certificado ou um segredo do cliente. Você gerencia certificados e segredos do cliente. |
Prefira uma identidade gerenciada para uma carga de trabalho hospedada Azure. Para uma entidade de serviço, prefira federação de identidade de carga de trabalho ou um certificado em vez de um segredo do cliente quando o ambiente de hospedagem dá suporte a ele.
Importante
Considere usar os tokens Microsoft Entra mais seguros ao invés de tokens de acesso pessoais de maior risco. Para obter mais informações, consulte Reduzir o uso do PAT. Examine as diretrizes de autenticação para escolher o mecanismo de autenticação correto para suas necessidades.
Entenda as identidades do aplicativo
Entidades de serviço
Uma entidade de serviço é a representação local de um aplicativo em um locatário do Microsoft Entra. Registrar um aplicativo cria uma entidade de serviço em seu locatário de origem. Um aplicativo multilocatário também pode ter uma entidade de serviço em cada locatário que autorize o aplicativo.
Uma entidade de serviço pode se autenticar usando:
- Uma credencial de identidade federada, quando compatível com a plataforma de hospedagem.
- Um certificado
- Um segredo do cliente, que você deve armazenar e rotacionar com segurança.
Identidades gerenciadas
Uma identidade gerenciada é um tipo especial de entidade de serviço cujas credenciais Azure gerencia.
- Uma identidade gerenciada atribuída pelo sistema pertence a um recurso Azure e é excluída com esse recurso.
- Uma identidade gerenciada atribuída pelo usuário é um recurso Azure separado que pode ser atribuído a vários recursos e gerenciado de forma independente.
Pré-requisitos
- Uma organização Azure DevOps conectada a um locatário Microsoft Entra.
- Uma entidade de serviço ou identidade gerenciada no locatário conectado à organização.
- Permissão para adicionar usuários à organização. Um membro do Project Collection Administrators pode adicionar uma identidade. Um administrador de projeto ou de equipe pode adicionar uma identidade quando a política de convite permitir.
- As permissões e o nível de acesso necessários para os recursos de Azure DevOps que a identidade acessa.
Criar uma identidade
Escolha o tipo de identidade que corresponde ao ambiente de hospedagem da carga de trabalho.
Criar uma entidade de serviço
- No Centro de administração do Microsoft Entra, selecione Registros de aplicativo>Novo registro.
- Insira um nome descritivo e selecione o tipo de conta com suporte para seu aplicativo.
- Deixe o URI de Redirecionamento vazio para um aplicativo serviço a serviço.
- Adicione uma credencial de identidade federada ou um certificado. Crie um segredo do cliente somente quando a carga de trabalho não puder usar uma credencial mais forte.
Importante
Um registro de aplicativo possui um objeto de aplicativo e um objeto de entidade de serviço. Ao adicionar a identidade ao Azure DevOps, use a ID do Objeto da entidade de serviço em Aplicativos empresariais, e não a ID do objeto do aplicativo em Registros de aplicativo.
Para obter mais informações, consulte Objetos de aplicativo e de entidade de serviço e Criar uma entidade de serviço.
Criar uma identidade gerenciada
Para habilitar uma identidade gerenciada atribuída pelo sistema:
- No portal Azure, abra o recurso Azure que hospeda sua carga de trabalho.
- Selecione Sistema de Identidade>atribuído.
- Defina Status como Ativado e, em seguida, selecione Salvar.
Para criar e atribuir uma identidade gerenciada atribuída pelo usuário:
- No portal Azure, crie um recurso de Identidade Gerenciada.
- Abra o recurso Azure que hospeda sua carga de trabalho.
- Selecione Identidade>>.
- Selecione a identidade gerenciada e, em seguida, selecione Adicionar.
Para obter mais informações, consulte Gerenciar identidades gerenciadas atribuídas pelo usuário.
Adicionar a identidade ao Azure DevOps
Você deve adicionar explicitamente uma identidade de aplicativo a cada organização Azure DevOps que ela acessa. Adicionar a identidade apenas a um grupo de Microsoft Entra não a disponibiliza em Azure DevOps.
Em Azure DevOps, selecione Configurações da organização>Usuários.
Selecione Adicionar usuários.
Insira o nome de exibição da entidade de serviço ou identidade gerenciada.
Selecione o nível de acesso e os projetos necessários. O acesso ao Azure Repos requer Basic ou um nível de acesso superior. Os benefícios da assinatura do Visual Studio não se aplicam às identidades de aplicativo.
Selecione Adicionar. Azure DevOps não envia um email de convite para uma identidade de aplicativo.
Para automatizar essa etapa, use a API Service Principal Entitlements.
Configurar o acesso
Azure DevOps não usa permissões de aplicativo Microsoft Entra para autorizar uma identidade de aplicativo. Atribua um nível de acesso, associações a grupos do Azure DevOps e permissões de recursos, assim como faria para outro membro da organização.
Siga estas práticas:
- Atribua o nível de acesso mais baixo que dá suporte ao cenário.
- Adicione a identidade a um grupo do Azure DevOps para uma finalidade específica, em vez de atribuir muitas permissões diretamente.
- Conceda acesso somente aos projetos e recursos necessários.
- Examine as permissões da identidade e as associações de grupo regularmente.
Para pesquisa e gerenciamento programáticos, consulte a API do Graph de Entidade de Serviço.
Adquirir e usar um token de acesso
Solicite um token de acesso para o recurso Azure DevOps, e envie-o no cabeçalho Authorization como token do portador. Trate os tokens de acesso como opacos. Não dependa de uma validade fixa nem decodifique as declarações do token. Reutilize o objeto de credencial para que a biblioteca de identidade do Azure possa armazenar tokens em cache e adquirir um novo token quando necessário.
Os exemplos de .NET a seguir exigem o Azure. Pacote de identidade.
Principal de serviço com certificado
Definir AZURE_TENANT_ID, AZURE_CLIENT_IDe AZURE_CLIENT_CERTIFICATE_PATH na configuração segura da carga de trabalho.
using Azure.Core;
using Azure.Identity;
using System.Net.Http.Headers;
string RequiredSetting(string name) =>
Environment.GetEnvironmentVariable(name)
?? throw new InvalidOperationException($"Missing {name}.");
// Create a service-principal credential from a certificate.
var credential = new ClientCertificateCredential(
RequiredSetting("AZURE_TENANT_ID"),
RequiredSetting("AZURE_CLIENT_ID"),
RequiredSetting("AZURE_CLIENT_CERTIFICATE_PATH"));
var token = await credential.GetTokenAsync(new TokenRequestContext(
new[] { "https://app.vssps.visualstudio.com/.default" }));
// Call Azure DevOps with the Microsoft Entra token.
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", token.Token);
var response = await client.GetAsync(
"https://dev.azure.com/{organization}/_apis/projects?api-version=7.1");
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Identidade gerenciada atribuída pelo usuário
Defina AZURE_CLIENT_ID como a ID do cliente da identidade gerenciada atribuída pelo usuário. Atribua essa identidade ao recurso Azure que hospeda o aplicativo.
using Azure.Core;
using Azure.Identity;
using System.Net.Http.Headers;
var managedIdentityClientId =
Environment.GetEnvironmentVariable("AZURE_CLIENT_ID")
?? throw new InvalidOperationException("Missing AZURE_CLIENT_ID.");
// Select the user-assigned identity explicitly.
var credential = new ManagedIdentityCredential(
ManagedIdentityId.FromUserAssignedClientId(managedIdentityClientId));
var token = await credential.GetTokenAsync(new TokenRequestContext(
new[] { "https://app.vssps.visualstudio.com/.default" }));
// Call Azure DevOps with the Microsoft Entra token.
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", token.Token);
var response = await client.GetAsync(
"https://dev.azure.com/{organization}/_apis/projects?api-version=7.1");
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Para uma identidade gerenciada atribuída pelo sistema, crie a credencial com ManagedIdentityId.SystemAssigned em vez disso. Para obter mais opções de aquisição de token, consulte Adquirir tokens de Microsoft Entra.
Gerenciar identidades de aplicativo
Licenciamento
- Atribua um nível de acesso diretamente a cada identidade do aplicativo.
- Cada identidade consome uma licença em todas as organizações em que ela recebe um nível de acesso pago.
- A cobrança para várias organizações e os benefícios da assinatura do Visual Studio para usuários não se aplicam a identidades de aplicativo.
Ciclo de vida da identidade
- As identidades do aplicativo não têm endereços de email e não recebem convites.
- Eles não podem entrar interativamente ou usar o portal da Web Azure DevOps.
- Eles não podem criar PATs ou chaves SSH, criar organizações ou usar Azure DevOps fluxos OAuth.
- Remover uma identidade de aplicativo de Microsoft Entra ID não remove automaticamente sua associação Azure DevOps. Remova identidades obsoletas de Azure DevOps como parte do desprovisionamento.
Acesso Condicional
O Acesso Condicional para identidades de carga de trabalho pode ter como alvo entidades de serviço, de acordo com as condições com suporte e os requisitos de licenciamento. Ele não dá suporte a identidades gerenciadas. Controles de usuário, como autenticação multifator e conformidade do dispositivo, não se aplicam a identidades que não são de usuário.
Perguntas frequentes
Por que usar uma identidade de aplicativo em vez de um PAT?
Uma identidade de aplicativo não está vinculada ao ciclo de vida de emprego de um usuário. Ele solicita tokens de acesso de curta duração e pode ser regido separadamente em Microsoft Entra ID e Azure DevOps. As identidades gerenciadas não exigem um segredo do aplicativo. As entidades de serviço ainda exigem gerenciamento de credenciais, a menos que utilizem a federação de identidade de carga de trabalho.
Quais limites de taxa se aplicam?
Principais de serviço e identidades gerenciadas têm os mesmos limites de taxa do Azure DevOps que os usuários.
Como uma identidade de aplicativo é cobrada?
Atribua um nível de acesso com base nos recursos de que a identidade precisa. Um nível de acesso pago é cobrado separadamente em todas as organizações. O licenciamento baseado em grupo, a cobrança de usuários de várias organizações e os benefícios de assinatura do Visual Studio não se aplicam.
Posso adicionar uma identidade de um locatário diferente?
A entidade de serviço ou o objeto de identidade gerenciada que você adiciona deve existir no locatário do Microsoft Entra conectado à organização do Azure DevOps. Você não pode adicionar uma identidade gerenciada diretamente de outro locatário.
Por que a identidade não pode acessar um repositório Azure Repos?
Confirme se a identidade tem acesso básico ou superior, associação ao projeto e permissão para acessar o repositório. O acesso de partes interessadas não inclui Azure Repos.
Por que o Azure DevOps não consegue localizar minha entidade de serviço?
No centro de administração do Microsoft Entra, selecione aplicativos Empresariais, abra o aplicativo e use sua ID de Objeto. Não use o ID do objeto de Registros de aplicativo.
Por que o API do Graph retorna uma lista vazia ou incompleta?
Siga os valores da continuationToken API até que nenhum token de continuação seja retornado. Uma entidade de serviço pode aparecer em uma página posterior.
Como posso resolver TF401444: Sign-in required?
Adicione a identidade do aplicativo explicitamente à organização Azure DevOps, atribua um nível de acesso e conceda as permissões de projeto e recurso necessárias.