Skip to main content
Skip to content

À propos de l’autorisation gérée par l’entreprise pour les applications

Les applications peuvent se connecter avec l’authentification unique à GitHub à l’aide d’informations d’identification du fournisseur d’identité (IdP), sans connexion interactive.

Qui peut utiliser cette fonctionnalité ?

Enterprise admins can manage Enterprise-Managed Authorization.

Remarque

Enterprise-Managed Authorization est en préversion publique et susceptible de changer. Seules les applications sélectionnées peuvent utiliser EMA, et uniquement avec Enterprise Managed Users adossé à OIDC. Pour utiliser l’EMA dans votre entreprise, vous devez l’activer dans GitHub et dans Microsoft Entra.

Enterprise-Managed Authorization (EMA) est une norme d’identité émergente qui permet à une application d’accéder à une ressource à l’aide de sa connexion IdP au lieu de demander à l’utilisateur de se connecter directement à la ressource. EMA est également connu sous le nom de ID JAG, d’accès inter-applications (XAA) ou d’Agentic SSO en fonction de la plateforme que vous utilisez. Il est le plus populaire dans l’écosystème MCP, mais utile pour toute configuration fédérée.

Les avantages de l’EMA s’appliquent aux développeurs et aux administrateurs :

  • Les développeurs obtiennent un accès plus facile à GitHub depuis des clients compatibles. Ils n’ont pas besoin de configurer MCP JSON ou d’effectuer un flux OAuth distinct.
  • Les administrateurs peuvent voir et contrôler l’accès entre les applications et GitHub, ce qui offre une prise en charge supplémentaire de la sécurité et de l’audit.
  • Les applications clientes reçoivent des jetons de courte durée, renouvelés régulièrement, au lieu de jetons d’application OAuth de longue durée ou de personal access tokens des secrets client.

Activation de Enterprise-Managed Authorization dans votre entreprise

Pour que vos utilisateurs puissent utiliser EMA, il doit être activé dans votre entreprise. Lorsqu’il est activé, il permet à vos utilisateurs d’accéder à GitHub depuis Copilot CLI et VS Code après s’être connectés à Microsoft Entra, au lieu d’effectuer une connexion OAuth sur GitHub. Votre entreprise doit utiliser Enterprise Managed Users avec l’authentification unique OpenID Connect (OIDC).

  1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
  2. En haut de la page, cliquez sur Fournisseur d’identité.
  3. Sélectionnez Autorisation gérée par l’entreprise dans la section Authentification unique.
  4. Définissez la stratégie d’accès par défaut sur Activé ou Désactivé.
  5. Si vous souhaitez activer ou désactiver EMA de manière sélective pour une équipe d’entreprise, un utilisateur ou un rôle, sélectionnez Ajouter un remplacement et choisissez la cible qui doit recevoir un résultat différent. Définissez ensuite la stratégie pour la dérogation, Activé ou Désactivé.

En cas de dérogations multiples s’appliquant à un utilisateur (par exemple, parce qu’il appartient à deux équipes différentes, chacune avec une dérogation, et qu’il est directement ciblé par l’une d’elles), la logique suivante s’applique :

  1. Si un utilisateur est ciblé directement par une dérogation, ce résultat s’applique.
  2. En supposant qu’aucune substitution ne cible directement l’utilisateur, toute substitution applicable qui désactive la fonctionnalité s’applique et l’utilisateur ne peut pas utiliser l’OUTIL.
  3. Si toutes les dérogations applicables activent la fonctionnalité pour l’utilisateur, il peut utiliser EMA.
  4. Enfin, si aucune dérogation ne s’applique, elles sont soumises à la stratégie par défaut.

Applications prises en charge

Copilot CLI et VS Code prennent en charge l’EMA avec GitHub. Les versions les plus récentes de chaque application prennent en charge LA GESTION, mais peuvent nécessiter une configuration pour activer la fonctionnalité dans l’application. Les deux applications nécessitent une configuration dans Microsoft Entra pour autoriser la connexion à GitHub.

Activation de l’authentification dans Microsoft Entra

Pour activer l’authentification unique entre une application et GitHub dans Microsoft Entra, vous devez vous assurer que l’application cliente (VS CodeouCopilot CLI) est présente dans votre locataire et autorisée à accéder à l’applicationGitHub Enterprise Managed User (OIDC).

En tant qu’administrateur du locataire, vous devez fournir le consentement administrateur pour chaque application afin de prendre en charge la connexion.

À l’aide de votre ID de locataire ou de votre nom de domaine à la place de <TENANT_IDENTIFIER>, visitez chacune de ces URL et approuvez l’accès de l’application à GitHub:

  • Pour 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
  • Pour 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

Le 12f6db80-0741-4a7e-b9c5-b85d737b3a31 GUID inclus dans le paramètre de requête d’étendue est l’ID d’application de l’application GitHub Enterprise Managed User (OIDC) . user_impersonation est le scope standard qui indique que vous vous connectez en tant qu’utilisateur. Une fois dans GitHub, les autorisations de l’application sont toujours appliquées et les actions sont toujours attribuées à l’application.

Lorsque vous passez par le flux de consentement administrateur, vous êtes invité à fournir deux approbations chaque fois : une fois pour l’accès à l’application GitHub cliente (appelée SPN-GITHUB_MANAGED_USER_OIDC dans la boîte de dialogue de consentement), et une fois pour GitHub avoir accès aux données de votre utilisateur. L’accès aux données utilisateur a déjà été accordé lors de la première approbation de l’application. Il s’agit simplement d’Entra exécutant le processus d’approbation pour toutes les applications impliquées.

Vous pouvez vérifier si les applications ont été créées et approuvées dans votre tenant en accédant à l’onglet Applications d’entreprise de votre tenant Entra dans le portail Portail Azure. Là, recherchez chacune des applications par nom ou ID d’application, à l’aide du filtre Application ID starts with. Veillez à supprimer le filtre Type d’application ou à le définir sur applications Microsoft afin que les applications apparaissent. Les ID d’application pour chaque application sont les suivants :

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

Lorsque vous avez trouvé les applications, ouvrez la page Autorisations dans la section Sécurité . Si l’application est présente et a été accordée à GitHubl’accès, vous devez voir une entrée dans la table pour GitHub Enterprise Managed User (OIDC) et user_impersonation, accordée par le biais du consentement administrateur. Si vous souhaitez supprimer cet accès, vous pouvez cliquer sur les trois points à droite de l’entrée et sélectionner Révoquer l’autorisation.

Copilot CLI

Pour utiliser Enterprise-Managed Authorization avec le Copilot CLI, consultez Authentification de GitHub Copilot CLI. EMA est activé dans la version 1.0.113 et ultérieure lorsque vous exécutez /login.

VS Code

À compter de la version 1.141.0, VS Codeles utilisateurs peuvent voir l’option de se connecter avec leur compte Microsoft Entra. Si vous le faites, et que votre compte Entra est lié à un OIDC compte d’utilisateur managé, vous obtiendrez un accès immédiat à GitHub et à vos GitHub Copilot droits d’utilisation. Lorsque vous sélectionnez l’option Microsoft, VS Code tente de vous connecter à l’aide de votre broker sur l’appareil afin de se connecter en authentification unique à un compte Entra. S’il n’est pas en mesure de le faire, vous pouvez vous connecter à Entra via votre navigateur web.

Activation de l’authentification Microsoft dansVS Code

VS Codepeut ne pas afficher l’option Continuer avec Microsoft lorsque vous êtes invité à vous connecter. Cela peut être dû au fait que la fonctionnalité est désactivée sur votre VS Code instance ou qu’elle VS Code n’a pas pu détecter un compte Microsoft Entra existant sur l’appareil. Pour forcer l’activation de la fonctionnalité, modifiez le paramètre.

La fonctionnalité est contrôlée par le chat.microsoftAuthentication.enabled paramètre, qui a l’une des trois valeurs suivantes :

ValeurBehavior
"auto"Vérifie si un compte Microsoft Entra est détectable avant d’afficher l’option.
"always"Affiche toujours l’option de connexion Microsoft.
"never"Masque l’option de connexion Microsoft.

Par exemple, pour toujours afficher l’option, ajoutez ceci à votre settings.json:

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

Pour obtenir de l’aide sur la recherche et l’ouverture de settings.json dans VS Code, consultez « Paramètres de l’utilisateur et de l’espace de travail » dans la documentation VS Code.

La valeur par défaut dans la version 1.141.0 dépend de votre paramètre de télémétrie :

  • Si la télémétrie, et donc l’expérimentation A/B, est activée, la valeur par défaut est "auto".
  • Si la télémétrie est désactivée, la valeur par défaut est "never". Définissez la valeur sur "auto" ou "always" pour activer manuellement.

Dans les versions ultérieures, ce paramètre est défini par défaut sur "auto".

Prise en charge de l’EMA pour d’autres applications et fournisseurs d’identité

GitHub prévoit d’étendre la prise en charge d’EMA pour la gamme complète d’applications clientes et d’idPs qui implémentent le protocole, notamment Okta, Ping Claudeet Cursor. Si votre entreprise avec utilisateurs managés utilise l’un de ces fournisseurs d’identité, les applications compatibles pourront accéder à GitHub au nom de vos utilisateurs.

Pour en savoir plus sur Enterprise-Managed Authorization, consultez la documentation standard MCP et la spécification ID JAG. Vous pouvez suivre l’élément de la feuille de route et le journal des modifications pour les mises à jour sur ce travail.