Configurar um GitHub Enterprise Cloud Organization para logon único com a ID do Microsoft Entra

Neste artigo, você aprenderá a integrar um GitHub Enterprise Cloud Organization à ID do Microsoft Entra. Ao integrar uma organização do GitHub Enterprise Cloud com o Microsoft Entra ID, você pode:

• Controle no Microsoft Entra ID quem tem acesso à sua organização do GitHub Enterprise Cloud.
• Gerenciar o acesso à sua organização do GitHub Enterprise Cloud em um local central.

Pré-requisitos

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

• Uma conta de usuário do Microsoft Entra com uma assinatura ativa. Se você ainda não tiver uma, poderá criar uma conta gratuitamente.
• Uma das seguintes funções:
  • Administrador de Aplicativos
  • Administrador de Aplicativos na Nuvem
  • Proprietário do aplicativo.

• Uma organização do GitHub criada no GitHub Enterprise Cloud, que requer o plano de cobrança do GitHub Enterprise.

Descrição do cenário

Neste artigo, você configurará e testará o logon único do Microsoft Entra em um ambiente de teste.

• O GitHub dá suporte ao SSO iniciado por SP .

• O GitHub dá suporte ao provisionamento automatizado de usuários (convites da organização).

Adicionar o GitHub da galeria

Para configurar a integração do GitHub no Microsoft Entra ID, você precisa adicionar o GitHub da galeria à sua lista de aplicativos SaaS gerenciados.

1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos na Nuvem.
2. Navegue até Entrar ID>Aplicativos empresariais>Novo aplicativo.
3. Na seção Adicionar por meio da galeria , digite GitHub na caixa de pesquisa.
4. Selecione GitHub Enterprise Cloud – Organização no painel de resultados e, em seguida, adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Como alternativa, você também pode usar o Assistente de Configuração de Aplicativos Empresariais. Neste assistente, você pode adicionar um aplicativo ao seu locatário, adicionar usuários/grupos ao aplicativo, atribuir funções e também percorrer a configuração de SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o SSO do Microsoft Entra para GitHub

Configure e teste o SSO do Microsoft Entra com o GitHub usando um usuário de teste chamado B.Simon. Para que o SSO funcione, você precisa estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no GitHub.

Para configurar e testar o SSO do Microsoft Entra com o GitHub, execute as seguintes etapas:

1. Configure o SSO do Microsoft Entra para permitir que os usuários usem esse recurso.
   1. Crie um usuário de teste do Microsoft Entra para testar o single sign-on do Microsoft Entra com B.Simon.
   2. Atribua o usuário de teste do Microsoft Entra para permitir que B.Simon use o logon único do Microsoft Entra.
2. Configure o SSO do GitHub – para definir as configurações de logon único no lado do aplicativo.
   1. Crie um usuário de teste do GitHub para ter uma contraparte de B.Simon no GitHub que esteja vinculada à representação do usuário do Microsoft Entra.
3. Testar o SSO – para verificar se a configuração funciona.

Configurar o SSO do Microsoft Entra

Siga estas etapas para habilitar o SSO do Microsoft Entra.

1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos na Nuvem.

2. Navegue até Entra ID>Aplicativos empresariais>GitHub>Logon único.

3. Na página Selecionar um método de logon único , selecione SAML.

4. Na página Configurar logon único com SAML, selecione o ícone de lápis da Configuração Básica do SAML para editar os parâmetros.

   

5. Na seção Configuração Básica do SAML , insira os valores dos seguintes campos:

   um. Na caixa de texto Identificador (ID da Entidade), digite uma URL usando o seguinte padrão: https://github.com/orgs/<Organization ID>

   b. Na caixa de texto URL de Resposta , digite uma URL usando o seguinte padrão: https://github.com/orgs/<Organization ID>/saml/consume

   c. Na caixa de texto URL de Logon , digite uma URL usando o seguinte padrão: https://github.com/orgs/<Organization ID>/sso

   Observação

   Observe que esses não são os valores reais. Você precisa atualizar esses valores com o Identificador, a URL de Resposta e a URL de Logon reais. Aqui, sugerimos que você use o valor único da string no Identificador. Acesse a seção Administração do GitHub para recuperar esses valores.

6. Seu aplicativo GitHub espera as declarações de SAML em um formato específico, o que exige que você adicione mapeamentos de atributo personalizados de acordo com sua configuração de atributos do token SAML. A captura de tela a seguir mostra a lista de atributos padrão, enquanto o Identificador de Usuário Exclusivo (ID de Nome) é mapeado com user.userprincipalname. O aplicativo GitHub espera que o Identificador de Usuário Exclusivo (ID do Nome) seja mapeado com user.mail, portanto, você precisa editar o mapeamento de atributo selecionando o ícone Editar e alterar o mapeamento de atributo.

   

7. Na página Configurar Sign-On Único com SAML, na seção Certificado de Assinatura SAML, selecione Baixar para fazer o download do Certificado (Base64) das opções fornecidas de acordo com suas necessidades e salvá-lo em seu computador.

   

8. Na seção Configurar o GitHub , copie as URLs apropriadas de acordo com suas necessidades.

   

Criar e atribuir um usuário de teste do Microsoft Entra

Siga as diretrizes no guia de início rápido criar e atribuir uma conta de usuário para criar uma conta de usuário de teste chamada B.Simon.

Configurar o SSO do GitHub

1. Em outra janela do navegador da Web, faça logon em seu site de organização do GitHub como administrador.

2. Navegue até Configurações e selecione Segurança.

   

3. Marque a caixa de seleção Habilitar autenticação SAML, o que revelará os campos de configuração do Single Sign-on, e execute as seguintes etapas:

   

   um. Copie o valor da URL de logon único e cole esse valor na caixa de texto URL de Logon na Configuração Básica do SAML.

   b. Copie o valor da URL do serviço do consumidor de declaração e cole esse valor na caixa de texto URL de Resposta na Configuração Básica de SAML.

4. Configure os seguintes campos:

   

   um. Na caixa de texto URL de Sign-on, cole o valor de URL de Login que você copiou anteriormente.

   b. Na caixa de texto Emissor, cole o valor que você copiou anteriormente do Identificador do Microsoft Entra.

   c. Abra o certificado baixado do portal do Azure no bloco de notas, cole o conteúdo na caixa de texto Certificado Público .

   d. Selecione o ícone Editar para editar o método Signature e o método Digest de RSA-SHA1 e SHA1 para RSA-SHA256 e SHA256 , conforme mostrado abaixo.

   e. Atualize a URL do serviço do consumidor de declaração (URL de Resposta) da URL padrão para que a URL no GitHub corresponda à URL no registro do aplicativo do Azure.

   

5. Selecione Testar a configuração do SAML para confirmar que não há falhas ou erros de validação durante o SSO.

   

6. Selecione Salvar

Observação

O logon único no GitHub autentica-se em uma organização específica no GitHub e não substitui a autenticação do GitHub em si. Portanto, se a sessão do github.com do usuário expirou, você poderá ser solicitado a autenticar-se com a ID/senha do GitHub durante o processo de logon único.

Criar um usuário de teste do GitHub

O objetivo desta seção é criar um usuário chamado Britta Simon no GitHub. O GitHub dá suporte ao provisionamento automático de usuário, que está habilitado por padrão. Você pode encontrar mais detalhes aqui sobre como configurar o provisionamento automático de usuário.

Se você precisar criar o usuário manualmente, execute as seguintes etapas:

1. Faça logon em seu site de empresa do GitHub como administrador.

2. Selecione Pessoas.

   

3. Selecione Convidar membro.

   

4. Na página da caixa de diálogo Convidar membro , execute as seguintes etapas:

   um. Na caixa de texto Email, digite o endereço de email da conta de Britta Simon.

   

   b. Selecione Enviar Convite.

   

   Observação

   O titular da conta do Microsoft Entra receberá um email e clicará em um link para confirmar sua conta antes que ela se torne ativa.

Testar o SSO

Nesta seção, você vai testar a configuração de logon único do Microsoft Entra com as opções a seguir.

• Selecione Testar este aplicativo, essa opção redireciona para a URL de Logon do GitHub, na qual você pode iniciar o fluxo de logon.

• Acesse diretamente a página de login do GitHub e inicie o fluxo de logon de lá.

• Você pode usar os Meus Aplicativos da Microsoft. Quando você seleciona o bloco do GitHub em Meus Aplicativos, essa opção redireciona para a URL de Logon do GitHub. Para obter mais informações sobre meus aplicativos, consulte Introdução aos Meus Aplicativos.

Observação

Se um usuário tiver direitos de Administrador Global no Microsoft Entra ID, ele poderá entrar por meio do ponto de extremidade de SSO na sua organização do GitHub sem ser adicionado como membro do aplicativo de empresa. Eles também podem ingressar automaticamente na organização sem um convite.

Conteúdo relacionado

Depois de configurar o GitHub, você poderá impor o controle de sessão, que fornece proteção contra exfiltração e infiltração dos dados confidenciais da sua organização em tempo real. O controle da sessão é estendido do acesso condicional. Saiba como impor o controle de sessão com o Microsoft Defender para Aplicativos de Nuvem.