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).
- Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
- Na parte superior da página, clique em Provedor de identidade.
- Selecione Enterprise-Managed Authorization na seção Logon único.
- Defina a política de acesso padrão como Habilitada ou Desabilitada.
- 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:
- Se um usuário for direcionado diretamente com um override, esse resultado se aplicará.
- 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.
- Se todas as substituições aplicáveis habilitarem o recurso para o usuário, elas poderão usar a EMA.
- 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:
| Valor | Behavior |
|---|---|
"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.