Configurar o GitHub Enterprise Cloud - Conta Corporativa para logon único com ID do Microsoft Entra

Neste artigo, você aprenderá a configurar uma integração do Microsoft Entra SAML com uma conta corporativa do GitHub Enterprise Cloud - Enterprise. Ao integrar o GitHub Enterprise Cloud - Enterprise Account com o Microsoft Entra ID, você pode:

• Controle no Microsoft Entra ID quem tem acesso a uma Conta Corporativa do GitHub e a quaisquer organizações dentro da Conta Empresarial.

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 ainda não tiver uma, pode Criar uma conta gratuitamente.
• Uma das seguintes funções:
  • Administrador de aplicativos
  • Administrador de Aplicações em Nuvem
  • Responsável pela Aplicação.

• Uma conta GitHub Enterprise.
• Uma conta de usuário do GitHub que é proprietária de uma conta Enterprise.

Descrição do cenário

Neste artigo, você configura uma integração SAML para uma conta corporativa do GitHub e testa a autenticação e o acesso do proprietário da conta corporativa e do membro da empresa/organização.

• O GitHub Enterprise Cloud - Enterprise Account suporta SSO iniciado por SP e IDP.

Adicionando o GitHub Enterprise Cloud - Conta Empresarial da galeria

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

1. Entre no centro de administração do Microsoft Entra com, no mínimo, uma função de Administrador de Aplicações na Nuvem.
2. Navegue até Entra ID>Enterprise apps>Novo aplicativo.
3. Na seção Adicionar da galeria, digite GitHub Enterprise Cloud - Enterprise Account na caixa de pesquisa.
4. Selecione GitHub Enterprise Cloud - Enterprise Account no painel de resultados e 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 do Enterprise App. Neste assistente, pode adicionar uma aplicação ao seu ambiente, adicionar utilizadores/grupos à aplicação, atribuir funções e configurar o SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o Microsoft Entra SSO para GitHub Enterprise Cloud - Conta Corporativa

Configure e teste o Microsoft Entra SSO com o GitHub Enterprise Cloud - Enterprise Account 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 Enterprise Cloud - Enterprise Account.

Para configurar e testar o Microsoft Entra SSO com o GitHub Enterprise Cloud - Enterprise Account, execute as seguintes etapas:

1. Configurar o Microsoft Entra SSO - para permitir que seus usuários usem esse recurso.
   1. Crie um usuário de teste do Microsoft Entra - para testar o logon único do Microsoft Entra com B.Simon.
   2. Atribua o seu utilizador do Microsoft Entra e a conta de utilizador de teste à aplicação GitHub - para habilitar a sua conta de utilizador e a conta de utilizador de teste B.Simon para usar o início de sessão único do Microsoft Entra.
2. Habilitar e testar o SAML para a Conta Corporativa e suas organizações - para definir as configurações de logon único no lado do aplicativo.
   1. Teste o SSO com outro proprietário de conta enterprise ou membro da organização - para verificar se a configuração funciona.

Configurar o Microsoft Entra SSO

Siga estas etapas para habilitar o Microsoft Entra SSO.

1. Entre no centro de administração do Microsoft Entra com, no mínimo, uma função de Administrador de Aplicações na Nuvem.

2. Navegue até Entra ID>Aplicações empresariais>GitHub Enterprise Cloud - Enterprise Account>Autenticação única.

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

4. Na página Configurar logon único com SAML, selecione o ícone de lápis para Configuração Básica de SAML para editar as configurações.

   

5. Na seção Configuração Básica do SAML, execute as seguintes etapas:

   um. Na caixa de texto Identificador (ID de Entidade), digite uma URL usando o seguinte padrão: https://github.com/enterprises/<ENTERPRISE-SLUG>

   b) Na caixa de texto URL de resposta, digite uma URL usando o seguinte padrão: https://github.com/enterprises/<ENTERPRISE-SLUG>/saml/consume

6. Execute a seguinte etapa se desejar configurar a aplicação no modo iniciado SP:

   Na caixa de texto URL de Logon, digite uma URL usando o seguinte padrão: https://github.com/enterprises/<ENTERPRISE-SLUG>/sso

   Observação

   Substitua <ENTERPRISE-SLUG> pelo nome real da sua conta do GitHub Enterprise.

7. Na página Configurar logon único com SAML, na seção Certificado de Assinatura SAML, localize Certificado (Base64) e selecione Download para baixar o certificado e salvá-lo no seu computador.

   

8. Na secção Configuração da Conta Corporativa GitHub Enterprise Cloud, copie os URLs apropriados conforme a sua necessidade.

   

Criar um usuário de teste do Microsoft Entra

Nesta seção, você cria um usuário de teste no portal do Azure chamado B.Simon.

1. Entre no centro de administração do Microsoft Entra como, no mínimo, um Administrador de Utilizadores.
2. Navegue até Entra ID>Usuários.
3. Selecione Novo usuário>Criar novo usuário, na parte superior da tela.
4. Nas propriedades do utilizador , siga estes passos:
   1. No campo Nome para exibição, digite B.Simon.
   2. No campo Nome principal do usuário campo, digite o username@companydomain.extension. Por exemplo, B.Simon@contoso.com.
   3. Marque a caixa de seleção Mostrar palavra-passe e anote o valor exibido na caixa Palavra-passe.
   4. Selecione Revisão + Criação.
5. Selecione Criar.

Atribua seu usuário do Microsoft Entra e a conta de usuário de teste ao aplicativo GitHub

Nesta seção, você habilita B.Simon e sua conta de usuário para usar o logon único do Azure concedendo acesso ao GitHub Enterprise Cloud - Enterprise Account.

1. Entre no centro de administração do Microsoft Entra com, no mínimo, uma função de Administrador de Aplicações na Nuvem.
2. Navegue até Entra ID>Enterprise apps>GitHub Enterprise Cloud - Enterprise Account.
3. Na página de visão geral do aplicativo, encontre a seção Gerenciar e selecione Usuários e grupos.
4. Selecione Adicionar utilizadore, em seguida, selecione Utilizadores e grupos na caixa de diálogo Nova atribuição.
5. Na caixa de diálogo Usuários e grupos, selecione B.Simon e sua conta de usuário na lista Usuários e, em seguida, selecione o botão Selecionar na parte inferior da tela.
6. Caso preveja que um papel seja atribuído aos utilizadores, pode selecioná-lo na lista suspensa Selecionar um papel. Se nenhuma função tiver sido configurada para este aplicativo, você verá a função "Acesso padrão" selecionada.
7. Na caixa de diálogo Adicionar Atribuição, clique no botão Atribuir.

Habilitar e testar o SAML para a Conta Corporativa e suas organizações

Para configurar o logon único na parte do GitHub Enterprise Cloud - Enterprise Account, siga as etapas listadas em esta documentação do GitHub.

1. Inicie sessão no GitHub.com com uma conta de utilizador que seja proprietário de uma conta empresarial.
2. Copie o valor do campo Login URL no aplicativo e cole-o no campo Sign on URL nas configurações SAML da Conta Empresarial do GitHub.
3. Copie o valor do campo Azure AD Identifier no aplicativo e cole-o no campo Issuer nas configurações SAML da Conta Empresarial do GitHub.
4. Copie o conteúdo do ficheiro Certificado (Base64) que descarregou nos passos acima no portal do Azure e cole-as no campo apropriado nas definições SAML da conta GitHub Enterprise.
5. Selecione a Test SAML configuration e confirme se você pode se autenticar da Conta Corporativa do GitHub para a ID do Microsoft Entra com êxito.
6. Quando o teste for bem-sucedido, salve as configurações.
7. Depois de autenticar via SAML pela primeira vez a partir da conta corporativa do GitHub, uma identidade externa vinculada é criada, designada como, na conta corporativa do GitHub, associando a conta de utilizador do GitHub ligada à conta de utilizador do Microsoft Entra.

Depois de habilitar o SAML SSO para sua conta corporativa do GitHub, o SAML SSO é habilitado por padrão para todas as organizações de propriedade de sua conta corporativa. Todos os membros são obrigados a autenticar usando SAML SSO para obter acesso às organizações onde são membros, e os proprietários de empresas são obrigados a autenticar usando SAML SSO ao acessar uma conta corporativa.

Teste o SSO com outro proprietário de conta corporativa ou conta de membro da organização

Depois que a integração SAML for configurada para a conta corporativa do GitHub (que também se aplica às organizações do GitHub na conta enterprise), outros proprietários de contas corporativas atribuídas ao aplicativo no Microsoft Entra ID deverão ser capazes de navegar até a URL da conta corporativa do GitHub (https://github.com/enterprises/<enterprise account>), autenticar via SAML e acessar as políticas e configurações na conta corporativa do GitHub.

Um proprietário de uma organização numa conta corporativa deve ser capaz de convidar um utilizador para participar na sua organização GitHub. Entre no GitHub.com com uma conta de proprietário da organização e siga as etapas no artigo para convidar B.Simon para a organização. Uma conta de usuário do GitHub precisará ser criada para B.Simon se ainda não existir.

Para testar o acesso à organização do GitHub na Conta Enterprise com a conta de usuário de teste B.Simon:

1. Convide B.Simon para uma organização na Conta Enterprise como dono da organização.
2. Entre no GitHub.com usando a conta de usuário que você gostaria de vincular à conta de usuário B.Simon Microsoft Entra.
3. Entre no Microsoft Entra ID usando a conta de usuário B.Simon.
4. Vá para a organização do GitHub. O usuário deve ser solicitado a autenticar via SAML. Após a autenticação SAML bem-sucedida, B.Simon deve ser capaz de acessar os recursos da organização.

Conteúdo relacionado

Depois de configurar o GitHub Enterprise Cloud - Enterprise Account, você pode impor o controle de sessão, que protege a exfiltração e a infiltração dos dados confidenciais da sua organização em tempo real. O controle de sessão se estende do Acesso Condicional. Saiba como impor o controlo de sessão com o Microsoft Defender for Cloud Apps.