Remplacement des paramètres gérés par l’entreprise pour les équipes d’entreprise

Avec un déploiement géré par le serveur, vous pouvez configurer le fichier de managed-settings.json votre entreprise pour appliquer différents paramètres de gouvernance aux groupes d’utilisateurs en fonction de leur appartenance à l’équipe d’entreprise. L’entreprise définit tous les paramètres dans un emplacement central et l’appartenance à l’équipe d’entreprise détermine les utilisateurs qui reçoivent un ensemble de valeurs donné. Si vous n’avez pas encore créé le managed-settings.json fichier, consultez Prise en main des paramètres gérés par l’entreprise.

Pour permettre aux équipes d’entreprise de remplacer la valeur par défaut de l’entreprise, marquez la clé comme overridable dans managed-settings.json. Une clé remplaçable utilise la valeur de l’équipe d’entreprise lorsqu’elle est définie, ou revient à la valeur par défaut de votre entreprise lorsque l’équipe d’entreprise la laisse non définie.

Clés prises en charge

La syntaxe { "overridable": <VALUE> } s’applique aux touches model, permissions.deny, fusionTier, permissions.ask, permissions.allow, permissions.disableBypassPermissionsMode, autoTier, deniedMcpServers, extraKnownMarketplaces, allowedMcpServers, strictKnownMarketplaces et sandbox.

enabledPlugins fonctionne de manière additive. L’entreprise managed-settings.json définit une configuration de base, et un fichier d’équipe de l’entreprise peut y ajouter d’autres plug-ins.

Pour obtenir une description complète de ces clés et de leur syntaxe, consultez Paramètres gérés par l’entreprise.

Surcharge des paramètres pour des équipes d’entreprise spécifiques

Ces instructions s’appliquent aux déploiements gérés par le serveur (hébergés managed-settings.json sur GitHub). Les autres méthodes de déploiement ne prennent pas en charge les dérogations de l’équipe d’entreprise et vous obligeraient à déployer des paramètres différents à différents groupes d’utilisateurs via votre plateforme MDM.

Vous allez utiliser copilot/team-mappings.json et le copilot/teams/ répertoire pour configurer les équipes d’entreprise qui doivent utiliser les paramètres qui diffèrent de vos valeurs par défaut copilot/managed-settings.json .

Une fois cette section terminée, votre .github-private référentiel aura la structure suivante :

• .github-private/
  • copilot/

    ---

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

Steps

1. Dans le fichier copilot/managed-settings.json de votre entreprise, marquez chaque clé que vous souhaitez rendre remplaçable à l’aide de la syntaxe { "overridable": <VALUE> }. Les json fichiers que vous mappez aux équipes d’entreprise peuvent uniquement envoyer des valeurs différentes pour les clés que vous marquez substituables.

   La valeur overridable que vous fournissez dans managed-settings.json est la valeur par défaut lorsque les fichiers d’équipe d’entreprise ne déclarent pas de valeur différente pour une clé donnée.

   Par exemple, pour attribuer model, disableBypassPermissionsMode et allowedMcpServers aux équipes d’entreprise :

   {
     "model": { "overridable": "auto" },
     "permissions": {
       "disableBypassPermissionsMode": { "overridable": "disable" }
     },
     "allowedMcpServers": {
       "overridable": [
         { "serverUrl": "https://mcp.company.com/*" }
       ]
     }
   }
   

2. Dans le dépôt .github-private de votre entreprise, créez copilot/team-mappings.json. Mappez chaque fichier de paramètres d’équipe d’entreprise à un ou plusieurs slugs d’équipe d’entreprise. La clé est le nom du fichier de paramètres et la valeur est un tableau d’identifiants slug des équipes Enterprise. Vous pouvez donc utiliser le même fichier pour plusieurs équipes Enterprise.

   {
     "devs.json": ["developers-all", "finops-dev"],
     "ai-users.json": ["ai-baseline-trained"],
     "frontier.json": ["ai-pioneers"]
   }
   

3. Créez le fichier de paramètres de l’équipe Enterprise sous copilot/teams/. Vous pouvez inclure toutes les clés que vous avez marquées comme surchargeables, plus les valeurs plus restrictives pour autoTier, ainsi que la clé additive enabledPlugins. Toutes les autres clés restent régies par la valeur par défaut de votre entreprise.

   {
     "model": "unmanaged",
     "permissions": {
       "disableBypassPermissionsMode": "unmanaged"
     },
     "allowedMcpServers": [
       { "serverUrl": "https://team-specific-mcp.company.com/*" }
     ]
   }
   

4. Validez et envoyez vos modifications à la branche par défaut.

GitHub évalue l’appartenance à l’équipe d’entreprise et applique les paramètres correspondants pour chaque personne. Si un utilisateur appartient à plusieurs équipes d’entreprise, ses fichiers d’équipe d’entreprise sont combinés à l’aide de la valeur la moins restrictive pour chaque clé, puis appliqués sous les paramètres d’entreprise, où les décisions de plateforme gagnent toujours.