Configurar o GitHub Enterprise Managed User (OIDC) para provisionamento automático de usuários com o Microsoft Entra ID

Este artigo descreve as etapas que você precisa executar no GitHub Enterprise Managed User (OIDC) e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente usuários e grupos para o GitHub Enterprise Managed User (OIDC) usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Capacidades suportadas

GitHub Enterprise Managed User (OIDC) está disponível nas seguintes implementações em clouds nacionais.

Pré-requisitos

O cenário descrito neste artigo pressupõe que você já tenha os seguintes pré-requisitos:

• Um locatário do Microsoft Entra
• Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário de Aplicativos.
• Utilizadores Geridos Empresariais do GitHub Enterprise habilitados e configurados para iniciar sessão com OIDC SSO através do seu tenant Microsoft Entra.

Etapa 1: Planejar a implantação do provisionamento

1. Saiba como funciona o serviço de aprovisionamento.
2. Determine quem faz parte do escopo de aprovisionamento.
3. Determine quais dados mapear entre o Microsoft Entra ID e o GitHub Enterprise Managed User.

Etapa 2: Preparar para configurar o provisionamento com o Microsoft Entra ID

1. Identifique o URL do locatário. Este é o valor que você insere no campo URL do Locatário na guia Provisionamento do seu aplicativo GitHub Enterprise Managed User.

   • Para uma empresa em GitHub.com, a URL do locatário é https://api.github.com/scim/v2/enterprises/{enterprise}.
   • Para uma empresa no GHE.com, a URL do locatário é https://api.{subdomain}.ghe.com/scim/v2/enterprises/{subdomain}

2. Certifique-se de que criou um token com o escopo scim:enterprise para o utilizador de configuração da sua empresa. Esse valor é inserido no campo Token secreto na guia Provisionamento do seu aplicativo GitHub Enterprise Managed User. Consulte Introdução aos Utilizadores Geridos Corporativamente no GitHub Docs.

Etapa 3: Adicionar o GitHub Enterprise Managed User (OIDC) da galeria de aplicativos do Microsoft Entra

Adicione o GitHub Enterprise Managed User (OIDC) a partir da galeria de aplicações do Microsoft Entra para começar a gerir o provisionamento para o GitHub Enterprise Managed User (OIDC). Se você tiver configurado anteriormente o GitHub Enterprise Managed User (OIDC) para SSO, poderá usar o mesmo aplicativo. No entanto, é recomendável que você crie um aplicativo separado ao testar a integração inicialmente. Saiba mais sobre como adicionar uma aplicação a partir da galeria aqui.

Etapa 4: Definir quem está no escopo do provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem é provisionado com base na atribuição ao aplicativo ou com base nos atributos do usuário ou grupo. Se você optar por definir o escopo de quem é provisionado para seu aplicativo com base na atribuição, poderá usar as etapas para atribuir usuários e grupos ao aplicativo. Se você optar por definir o escopo de quem é provisionado com base apenas nos atributos do usuário ou grupo, poderá usar um filtro de escopo.

• Comece pequeno. Teste com um pequeno conjunto de utilizadores e grupos antes de implementar para todos. Quando o âmbito do aprovisionamento está definido para os utilizadores e os grupos atribuídos, pode controlar isto ao atribuir um ou dois utilizadores ou grupos à aplicação. Quando o âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.

• Se precisar de funções extras, você pode atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuários para o GitHub Enterprise Managed User (OIDC)

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no TestApp com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.

Para configurar o provisionamento automático de usuários para o GitHub Enterprise Managed User (OIDC) na ID do Microsoft Entra:

1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

2. Navegue para Entra ID>Aplicações empresariais

   

3. Na lista de aplicativos, selecione GitHub Enterprise Managed User (OIDC).

   

4. Selecione o separador Aprovisionamento.

   

5. Definir + Nova configuração.

   

6. Na seção Credenciais de Administrador, insira a URL do Tenant do GitHub Enterprise Managed User (OIDC) e o Token Secreto. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao GitHub Enterprise Managed User (OIDC). Se a conexão falhar, verifique se sua conta do GitHub Enterprise Managed User (OIDC) criou o token secreto como proprietário da empresa e tente novamente.

   • Em "URL do locatário", digite a URL do locatário identificada anteriormente.

     • Para uma empresa chamada octo-corp em GitHub.com, o URL do Tenant é https://api.github.com/scim/v2/enterprises/octo-corp.
     • Para uma empresa chamada octo-corp no GHE.com, o URL do Tenant é https://api.octo-corp.ghe.com/scim/v2/enterprises/octo-corp.

   • Para "Token secreto", cole o token de acesso pessoal do GitHub que você criou anteriormente.

     

7. Selecione Criar para criar a sua configuração.

8. Selecione Propriedades na página de Visão Geral.

9. Selecione o lápis para editar as propriedades. Habilite e-mails de notificação e forneça um e-mail para receber e-mails de quarentena. Ative a opção para evitar eliminação acidental. Selecione Aplicar para salvar as alterações.

   

10. Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.

11. Analise os atributos de usuário sincronizados do Microsoft Entra ID para o GitHub Enterprise Managed User (OIDC) na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no GitHub Enterprise Managed User (OIDC) para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API do GitHub Enterprise Managed User (OIDC) ofereça suporte à filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Suportado para filtragem
    Id externo	Cordão	✓
    nome de utilizador	Cordão
    ativo	booleano
    funções	Cordão
    nome de exibição	Cordão
    nome.dado	Cordão
    nome.sobrenome	Cordão
    nomeFormatado	Cordão
    emails[tipo = "trabalho"].valor	Cordão
    e-mails[tipo eq "home"].valor	Cordão
    e-mails[tipo eq "outros"].value	Cordão

    Nota

    A configuração AppRoleAssignmentComplex só funciona quando a opção Sincronizar apenas Utilizadores Atribuídos e Grupos está selecionada como âmbito. Se esta opção não for selecionada, a approleassignment não funcionará como esperado.

    

12. Selecione Grupos.

13. Analise os atributos de grupo sincronizados do Microsoft Entra ID para o GitHub Enterprise Managed User (OIDC) na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no GitHub Enterprise Managed User (OIDC) para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Suportado para filtragem
    Id externo	Cordão	✓
    nome de exibição	Cordão
    membros	Referência

14. Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo Filtro de escopo .

15. Use provisionamento sob demanda para validar a sincronização com um pequeno número de utilizadores antes de uma implementação mais ampla na sua organização.

16. Quando estiver pronto para provisionar, selecione Iniciar Provisão na página de Visão Geral .

Etapa 6: Monitorar sua implantação

Depois de configurar o provisionamento, use os seguintes recursos para monitorar sua implantação:

1. Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
3. Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre o estado de quarentena no artigo estado de quarentena de aprovisionamento de aplicativos.

Mais recursos

• Gerir o aprovisionamento de contas de utilizador para Aplicações Empresariais
• O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?

Conteúdo relacionado

• Saiba como analisar os registos e obter relatórios sobre a atividade de aprovisionamento