Integração manual do Git com um principal de serviço no Azure DevOps

Este artigo fornece passos manuais sobre como configurar um principal de serviço para integrar Fabric com Azure DevOps usando identidade de usuário. Para saber como funciona a integração do principal de serviço do Azure DevOps, consulte Automatizar a integração do Git com um principal de serviço no Azure DevOps.

Pré-requisitos

Para registrar um aplicativo com o seu locatário do Microsoft Entra e usá-lo para integrar seu espaço de trabalho do Fabric com o Git, você precisa ter:

• Pelo menos permissões de Administrador de Aplicativos na Nuvem .
• Um workspace do Fabric com permissões de administrador.

Etapa 1: Registrar um aplicativo com a ID do Microsoft Entra

Registre seu aplicativo com a ID do Microsoft Entra e crie um segredo seguindo as instruções em Registrar seu aplicativo. Confirme se as políticas da sua organização permitem a criação de segredos do cliente e seu uso para aquisição de token. Certifique-se de salvar o segredo, ele é necessário em uma etapa posterior.

Se o aplicativo residir em um inquilino que não seja o mesmo que o principal para sua instância do Azure DevOps, consulte considerações sobre multilocação.

Para obter mais informações, consulte objetos de principal de serviço e de aplicativo no Microsoft Entra ID e melhores práticas de segurança para propriedades de aplicativo no Microsoft Entra ID.

Para obter um exemplo de registro de aplicativo e criação de entidade de serviço, consulte Registrar um aplicativo do Microsoft Entra e criar uma entidade de serviço.

Etapa 2: Atribuir principal de serviço a uma organização de DevOps

Depois de criar nosso aplicativo e a entidade de serviço, precisamos adicioná-lo à nossa organização do Azure DevOps para conceder acesso aos recursos.

1. Faça logon em sua organização do Azure DevOps
2. Navegar até as configurações da organização –> Usuário –> Adicionar usuários
3. Selecione para adicionar a entidade de serviço

4. Navegue até as configurações relevantes do projeto do Azure DevOps ->Teams
5. Adicionar a entidade de serviço à equipe relevante

Etapa 3: Criar conexão de controle do código-fonte do Azure DevOps

Em seguida, criamos a conexão de controle do código-fonte do Azure DevOps. As informações a seguir são necessárias para concluir esta etapa.

Obter a ID do locatário

Para obter a ID do locatário, use as etapas a seguir.

1. Acesse o portal do Azure e entre com suas credenciais.
2. Navegue até o Microsoft Entra ID (Azure Active Directory)
3. Na seção "Visão geral", você verá sua "ID do Locatário" listada.

Para obter outras maneiras de obter a ID do locatário, consulte Como encontrar sua ID de locatário do Microsoft Entra.

Obter a ID do Service Principal

Para obter a ID da entidade de serviço, use as etapas a seguir.

1. Acesse o portal do Azure e entre com suas credenciais.
2. Navegue até o Microsoft Entra ID (Azure Active Directory)
3. À esquerda, selecione Registros de aplicativo
4. Navegando até o aplicativo e selecionando a guia Visão Geral
5. Utilize a ID do aplicativo (cliente) para a ID Principal do Serviço

Criar a conexão de controle do código-fonte

Para criar a conexão de controle do código-fonte, use os detalhes e as etapas a seguir.

1. Em um workspace, selecione as configurações do workspace
2. Selecionar Integração do Git
3. Selecione Azure DevOps
4. Clique em Adicionar Conta
5. Em Nome de exibição, insira um nome.
6. Insira a URL do Azure DevOps.
7. Em Método de Autenticação, selecione Service Principal.
8. Preencha os outros detalhes (ID do locatário, ID do principal de serviço, chave do principal de serviço) usando as informações acima.

9. Depois de adicionar a conexão, você precisa clicar em conectar e concluir os detalhes da conexão git. Para obter mais informações, consulte Conectar-se a uma área de trabalho

Considerações multilocatários para a criação da entidade de serviço

Para acessar recursos protegidos por um locatário do Microsoft Entra, seu aplicativo deve ter um princípio de segurança. Quando você cria seu aplicativo, o principal de serviço é criado automaticamente no tenant em que o aplicativo reside.

Nos casos em que o tenant do aplicativo é diferente do tenant inicial da instância do Azure DevOps, você precisará criar o principal de serviço, no tenant do Azure DevOps. Considere os cenários a seguir ao registrar seu aplicativo na etapa 1 e veja os exemplos.

Você pode criar o principal de serviço no locatário do Azure DevOps usando um dos exemplos. Os exemplos a seguir mostram como fazer isso com a CLI do Azure e o PowerShell. Ambos os exemplos pressupõem que seu aplicativo está no locatário A e o Azure DevOps está no locatário B.

az login --tenant <your-tenant-id> # where --tenant is the tenant ID of Azure DevOps tenant (tenant B)

az ad sp create --id <app id> # where --id <app id> is the client ID of the application in tenant A

Connect-MgGraph -TenantId "<Tenant B ID>" -Scopes "Application.ReadWrite.All", "Directory.ReadWrite.All" # Where -TenantID is the tenant ID of Azure DevOps tenant (tenant B)


New-MgServicePrincipal -AppId "00001111-aaaa-2222-bbbb-3333cccc4444" # Where -AppID is the client ID of the application in tenant A

Para obter mais informações, consulte Como e por que os aplicativos são adicionados à ID do Microsoft Entra e à Locação na ID do Microsoft Entra.

Apêndice: editar detalhes da conexão do principal de serviço

Quando você precisar atualizar os detalhes do principal de serviço, por exemplo, atualizar a chave do principal de serviço, siga os seguintes passos:

1. Nas configurações do Fabric, navegue até Gerenciar Conexões e Gateways. Localize a conexão de nuvem que você criou anteriormente.
2. Edite a conexão com as configurações atualizadas.

3. Depois de terminar de editar a conexão, clique em Salvar.

Conteúdo relacionado

• Automatizar a integração do Git usando APIs
• Automatize a integração do Git com uma entidade de serviço no Azure DevOps.
• Entender o processo de integração do Git
• Gerenciar branches do Git
• Práticas recomendadas de integração do Git