Skip to main content
Skip to content

Sobre Enterprise-Managed Autorização para aplicativos

Os aplicativos podem entrar com logon único para GitHub usar uma credencial de provedor de identidade (IdP), sem uma entrada interativa.

Quem pode usar esse recurso?

Enterprise admins can manage Enterprise-Managed Authorization.

Observação

Enterprise-Managed Autorização está dentro prévia pública e sujeito a alterações. Somente aplicativos selecionados podem usar a EMA e somente com o backup Enterprise Managed Usersde OIDC. Para usar a EMA em sua empresa, você deve habilitá-la em GitHub e no Microsoft Entra.

Enterprise-Managed Authorization (EMA) é um padrão de identidade emergente que permite que um aplicativo acesse um recurso usando sua entrada IdP em vez de exigir que o usuário entre diretamente no recurso. O EMA também é conhecido como ID JAG, XAA (acesso entre aplicativos) ou SSO agentic, dependendo de qual plataforma você está usando. Ele é mais popular no ecossistema do MCP, mas útil para qualquer configuração federada.

Os benefícios da EMA se aplicam a desenvolvedores e administradores:

  • Os desenvolvedores têm acesso mais fácil a GitHub partir de clientes compatíveis. Eles não precisam configurar o MCP JSON ou concluir um fluxo OAuth separado.
  • Os administradores podem ver e controlar o acesso entre aplicativos e GitHub, fornecendo suporte adicional de segurança e auditoria.
  • Os aplicativos cliente recebem tokens rotativos de curta duração em vez de tokens de aplicativo OAuth de longa duração ou personal access tokens.

Habilitando a autorização gerenciada pela empresa na sua empresa

Antes que os usuários possam usar o EMA, ele precisa ser habilitado em sua empresa. Quando habilitado, ele permite que os usuários acessem GitHub a partir de Copilot CLI e VS Code depois de entrar no Microsoft Entra, em vez de fazer logon com OAuth em GitHub. Sua empresa deve usar Enterprise Managed Users com o logon único do OpenID Connect (OIDC).

  1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  2. Na parte superior da página, clique em Provedor de identidade.
  3. Selecione Enterprise-Managed Authorization na seção Logon único.
  4. Defina a política de acesso padrão como Habilitada ou Desabilitada.
  5. Se você quiser habilitar ou desabilitar o EMA seletivamente para uma equipe da empresa, um usuário ou uma função, selecione Adicionar substituição e escolha o alvo que deve receber uma configuração diferente. Em seguida, defina a política para a substituição, habilitada ou desabilitada.

No caso de várias substituições aplicadas a um usuário (por exemplo, porque o usuário pertence a duas equipes diferentes, cada uma com uma substituição, e é diretamente direcionado por uma delas), a seguinte lógica se aplica:

  1. Se um usuário for direcionado diretamente com um override, esse resultado se aplicará.
  2. Supondo que nenhuma substituição direcione diretamente o usuário, qualquer substituição aplicável que desabilite o recurso se aplica e o usuário não pode usar o EMA.
  3. Se todas as substituições aplicáveis habilitarem o recurso para o usuário, elas poderão usar a EMA.
  4. Por fim, se nenhuma substituição de política se aplicar, estarão sujeitos à política padrão.

Aplicativos com suporte

Copilot CLI e VS Code oferecem suporte ao EMA com GitHub. As versões mais recentes de cada aplicativo dão suporte à EMA, mas podem exigir configuração para habilitar o recurso no aplicativo. Ambos os aplicativos exigem configuração no Microsoft Entra para permitir a conexão com GitHub.

Habilitando o login no Microsoft Entra

Para habilitar o SSO entre um aplicativo e GitHub dentro de Microsoft Entra, você deve garantir que o aplicativo cliente (VS Code ou Copilot CLI) esteja presente em seu locatário e tenha permissão para acessar o GitHub Enterprise Managed User (OIDC) aplicativo.

Como administrador de locatários, você deve fornecer consentimento do administrador para que cada aplicativo dê suporte à conexão.

Usando a ID do locatário ou o nome de domínio no lugar de <TENANT_IDENTIFIER>, visite cada uma dessas URLs e aprove o acesso do aplicativo a GitHub:

  • Para VS Code: https://login.microsoftonline.com/<TENANT_IDENTIFIER>/v2.0/adminconsent?client_id=aebc6443-996d-45c2-90f0-388ff96faa56&scope=12f6db80-0741-4a7e-b9c5-b85d737b3a31/user_impersonation
  • Para Copilot CLI: https://login.microsoftonline.com/<TENANT_IDENTIFIER>/v2.0/adminconsent?client_id=5ecc71bb-0fa6-4d6b-a31b-de12184c4b1a&scope=12f6db80-0741-4a7e-b9c5-b85d737b3a31/user_impersonation

O 12f6db80-0741-4a7e-b9c5-b85d737b3a31 GUID incluído no parâmetro de consulta de escopo é a ID GitHub Enterprise Managed User (OIDC) do aplicativo. user_impersonation é o escopo padrão que indica que você está entrando como o usuário. Uma vez dentro GitHub, as permissões do aplicativo ainda são impostas e as ações ainda são atribuídas ao aplicativo.

Ao passar pelo fluxo de consentimento do administrador, você receberá duas aprovações cada vez: uma para o aplicativo cliente acessando GitHub (chamado SPN-GITHUB_MANAGED_USER_OIDC na caixa de diálogo de consentimento) e uma vez para GitHub ter acesso aos dados do usuário. O acesso aos dados do usuário já foi concedido quando você aprovou o aplicativo pela primeira vez. Isso é apenas o Entra executando o processo de aprovação para todos os aplicativos envolvidos.

Você pode validar se os aplicativos foram criados e aprovados em seu locatário navegando até a guia Aplicativos Empresariais do locatário do Entra no Portal do Azure. Lá, pesquise cada um dos aplicativos pelo nome ou pelo ID de aplicativo, usando o filtro O ID de aplicativo começa com. Certifique-se de remover o filtro Tipo de aplicativo ou defini-lo como aplicativos da Microsoft para que os aplicativos sejam exibidos. Os IDs de cada aplicativo são:

  • VS Code: aebc6443-996d-45c2-90f0-388ff96faa56
  • Copilot CLI: 5ecc71bb-0fa6-4d6b-a31b-de12184c4b1a

Depois de localizar os aplicativos, abra a página Permissões na seção Segurança. Se o aplicativo estiver presente e tiver recebido acesso a GitHub, você deverá ver uma entrada na tabela para GitHub Enterprise Managed User (OIDC) e user_impersonation, concedida por consentimento do administrador. Se você quiser remover esse acesso, clique nos três pontos à direita da entrada e selecione Revogar permissão.

Copilot CLI

Para usar Enterprise-Managed Autorização com o Copilot CLI, consulte Autenticando GitHub Copilot CLI. O EMA está habilitado na versão 1.0.113 e posterior quando você executa /login.

VS Code

A partir da versão 1.141.0 do VS Code, os usuários podem ver a opção de entrar com sua conta Microsoft Entra. Se você fizer isso e sua conta do Entra estiver vinculada a um OIDC conta de usuário gerenciada, você terá acesso imediato a GitHub e suas GitHub Copilot permissões. Quando você selecionar a opção Microsoft, VS Code tentará entrar usando seu broker no dispositivo a fim de fazer SSO em uma conta do Entra. Se não for possível, você poderá entrar no Entra por meio do navegador da Web.

Habilitando a autenticação Microsoft emVS Code

VS Code pode não mostrar a opção Continuar com Microsoft quando você for solicitado a fazer login. Isso pode ocorrer porque o recurso está desabilitado em sua VS Code instância ou porque VS Code não foi possível detectar uma conta de Microsoft Entra existente no dispositivo. Para forçar a habilitação do recurso, altere a configuração.

O recurso é controlado pela configuração chat.microsoftAuthentication.enabled , que tem um dos três valores:

ValorBehavior
"auto"Verifica se uma conta Microsoft Entra é detectável antes de mostrar a opção.
"always"Sempre mostra a opção de entrar com a Microsoft.
"never"Oculta a opção de entrada da Microsoft.

Por exemplo, para sempre mostrar a opção, adicione-a ao seu settings.json:

{
  "chat.microsoftAuthentication.enabled": "always"
}

Para obter ajuda para localizar e abrir settings.json em VS Code, consulte "Configurações de usuário e workspace" na documentação do VS Code.

O padrão na versão 1.141.0 depende da configuração de telemetria:

  • Se a telemetria e, portanto, a experimentação A/B estiver habilitada, o padrão será "auto".
  • Se a telemetria estiver desabilitada, o padrão será "never". Defina o valor como "auto" ou "always" para ativar manualmente.

Em versões futuras, essa configuração usará como padrão "auto".

Suporte do EMA para outros aplicativos e IdPs

GitHub planeja expandir o suporte à EMA para toda a gama de aplicativos cliente e IdPs que implementam o protocolo, incluindo Okta, ClaudePing e Cursor. Se o seu empresa com usuários gerenciados usar um desses IdPs, os aplicativos compatíveis poderão acessar GitHub em nome dos seus usuários.

Para saber mais sobre Enterprise-Managed Authorization, consulte a documentação padrão do MCP e a especificação ID JAG. Você pode seguir o item do roadmap e o changelog para obter atualizações sobre este trabalho.