Skip to main content

Gerenciando associações de equipes com grupos de provedores de identidade

Conecte grupos de IdP com equipes no GitHub para gerenciar a associação de equipes e organizações por meio de seu provedor de identidade.

Quem pode usar esse recurso?

O Enterprise Managed Users está disponível para novas contas empresariais no GitHub Enterprise Cloud. Confira "Sobre os Enterprise Managed Users".

Sobre o gerenciamento de equipes com o Enterprise Managed Users

Com o Enterprise Managed Users, você poderá gerenciar a subscrição à equipe e à organização na sua empresa por meio do IdP conectando as equipes em GitHub.com com grupos no seu IdP. Quando conectar uma equipe de uma das organizações da sua empresa a um grupo do IdP as alterações à subscrição do grupo do IdP serão refletidas na sua empresa automaticamente, reduzindo a necessidade de atualizações manuais e scripts personalizados.

Quando uma alteração em um grupo de IdP ou uma nova conexão de equipe fizer com que um usuário ingresse em uma equipe em uma organização da qual ainda não é membro, o usuário será adicionado automaticamente à organização. Ao desconectar um grupo de uma equipe, usuários que se tornaram integrantes da organização por da associação da equipe são removidos da organização se uma associação não lhes for atribuída na organização por outros meios.

Observação: os proprietários da organização também podem adicionar usuários às organizações manualmente, desde que as contas já tenham sido provisionadas por meio do SCIM.

Quando o membro do grupo mudar no seu IdP, esse enviará uma solicitação de SCIM com alterações para GitHub de acordo com o cronograma determinado pelo seu IdP. Portanto, é possível que a alteração não seja imediata. Qualquer solicitação que altere a equipe de equipe ou associação da organização será registrada no log de auditoria como alterações feitas pela conta usada para configurar provisionamento do usuário.

O GitHub também executa um trabalho de reconciliação uma vez por dia, que sincroniza a associação à equipe com a associação ao grupo IdP armazenado em GitHub, com base nas informações enviadas anteriormente do IdP via SCIM. Se esse trabalho descobrir que um usuário é membro de um grupo IdP na empresa, mas não é membro da equipe mapeada ou de sua organização, o trabalho tentará adicionar o usuário à organização e à equipe.

As quipes conectadas a grupos de IdP não podem ser equipes principais de outras equipes nem uma equipe secundária de outra equipe. Se a equipe que você deseja conectar a um grupo de IdP for uma equipe principal ou secundária recmendamos criar uma nova equipe ou remover a relação aninhada que faças da sua equipe uma equipe principal.

Para gerenciar o acesso ao repositório para qualquer equipe em sua empresa, incluindo equipes conectadas a um grupo de IdP, você deverá fazer alterações no GitHub. Para obter mais informações, confira "Gerenciar o acesso da equipe em um repositório da organização".

Requisitos para conectar grupos de IdP às equipes

Para conectar um grupo de IdP a uma equipe no GitHub, você precisa atribuir o grupo ao aplicativo GitHub Enterprise Managed User no IdP. Para obter mais informações, consulte "Configurando o provisionamento do SCIM para Usuários Gerenciados da Empresa".

É possível conectar uma equipe da sua empresa a um grupo de IdP. Você pode atribuir o mesmo grupo do IdP a várias equipes na sua empresa.

Se você estiver conectando uma equipe existente a um grupo de IdP, primeiro você deverá remover todos os integrantes que foram adicionados manualmente. Depois de conectar uma equipe da sua empresa a um grupo do IdP, o administrador do IdP deverá realizar as alterações na associação da equipe por meio do provedor de identidade. Você não pode gerenciar a associação da equipe no GitHub.

Se você usar o Microsoft Entra ID (o antigo Azure AD) como seu IdP, apenas poderá conectar uma equipe a um grupo de segurança. Não há compatibilidade com associações de grupo aninhado e grupos do Microsoft 365.

Criando uma nova equipe conectada a um grupo de IdP

Qualquer integrante de uma organização pode criar uma nova equipe e conectar a equipe a um grupo de IdP.

  1. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

  2. Clique no nome da sua organização.

  3. Abaixo do nome da sua organização, clique em Equipes.

    Captura de tela da barra de navegação horizontal para uma organização. Uma guia rotulada com um ícone de pessoas e "Equipes" tem um contorno laranja escuro.

  4. Na parte superior da página, clique em Nova equipe.

  5. Em "Create new team" (Criar nova equipe), digite o nome para sua nova equipe.

  6. Opcionalmente, no campo "Descrição", digite uma descrição da equipe.

  7. Para conectar uma equipe, em "Grupos de Provedores de Identidade", selecione o menu suspenso Selecionar Grupos e clique na equipe que você deseja conectar.

  8. Em "Visibilidade da equipe", selecione uma visibilidade para a equipe.

  9. Clique em Criar equipe.

Gerenciando a conexão entre uma equipe existente e um grupo de IdP

Os proprietários da organização podem gerenciar a conexão existente entre um grupo de IdP e uma equipe. Se sua empresa não usa contas de usuário gerenciadas, os mantenedores de equipe também podem gerenciar a conexão.

Observação: para conectar uma equipe existente no GitHub a um grupo de IdP pela primeira vez, todos os membros da equipe no GitHub devem primeiro ser removidos. Para obter mais informações, consulte "Remover integrantes da organização de uma equipe".

  1. No canto superior direito do GitHub, selecione sua foto de perfil e selecione Seu perfil.

    Captura de tela do menu suspenso na imagem de perfil do @octocat. "Seu perfil" está contornado em laranja escuro.

  2. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

  3. Abaixo do nome da sua organização, clique em Equipes.

    Captura de tela da barra de navegação horizontal para uma organização. Uma guia rotulada com um ícone de pessoas e "Equipes" tem um contorno laranja escuro.

  4. Clique no nome da equipe.

  5. Na parte superior da página da equipe, clique em Configurações.

    Captura de tela do cabeçalho da página de uma equipe. Uma guia rotulada com um ícone de engrenagem e "Configurações" tem o contorno em laranja escuro.

  6. Opcionalmente, em "Grupo de Provedores de Identidade", à direita do grupo do IdP que deseja desconectar, clique em .

    Cancele a seleção de um grupo de IdP conectado da equipe do GitHub.

  7. Para conectar um grupo de IdP, em "Grupo de Fornecedores de Identidade", selecione o menu suspenso e clique em um grupo de provedores de identidade da lista.

    Menu suspenso usado para escolher o grupo de provedores de identidade.

  8. Clique em Salvar alterações.

Visualizando grupos de IdP, associações de grupo e equipes conectadas

Os proprietários corporativos podem revisar uma lista de grupos IdP, as associações de cada grupo e todas as equipes conectadas a cada grupo. Os grupos de IdP e associações listadas nesta exibição são baseados em informações enviadas do IdP para GitHub via SCIM. Você deve editar a associação de um grupo no seu IdP.

  1. No canto superior direito do GitHub, clique na sua foto de perfil e em Suas empresas.

  2. Na lista de empresas, clique na empresa que você deseja visualizar.

  3. Para examinar uma lista de grupos de IdP, na barra lateral esquerda, clique em Provedor de Identidade.

  4. Para ver os integrantes e equipes conectados a um grupo do IdP, clique no nome do grupo.

  5. Para ver as equipes conectadas ao grupo de IdP, clique em Equipes.

Se uma equipe não puder se sincronizar com o grupo em seu IdP, a equipe exibirá um erro. Para obter mais informações, consulte "Solucionar problemas de subscrição de equipe com grupos de provedores de identidade".

Como remover membros de organizações

A maneira como um membro é adicionado a uma organização pertencente à empresa determina como ele deve ser removido de uma organização.

  • Se um membro tiver sido adicionado a uma organização manualmente, você deverá removê-lo manualmente. O cancelamento da atribuição do aplicativo GitHub Enterprise Managed User no IdP suspende o usuário, mas não o remove da organização.
  • Se um usuário tiver se tornado membro de uma organização por ter sido adicionado a grupos de IdP, remova-o de todos os grupos de IdP mapeados associados à organização.

Para descobrir como um membro foi adicionado a uma organização, você pode filtrar a lista de membros por tipo. Consulte "Visualizar pessoas na sua empresa".