Configuration des paramètres gérés par l’entreprise

Avec les paramètres gérés par l’entreprise, les propriétaires d’entreprise peuvent définir et distribuer de manière centralisée les paramètres de configuration aux clients pris en charge pour les utilisateurs sur le plan de Copilot votre entreprise, en garantissant que chaque membre travaille dans les garde-fous que vous définissez, tout en permettant aux équipes de personnaliser les paramètres que vous autorisez.

Les clients suivants sont pris en charge, bien que tous les clients ne prennent pas en charge chaque propriété :

Copilot pour CLI
VS Code
GitHub application Copilot.
Agent cloud Copilot

Ces paramètres appliquent des clés spécifiques aux équipes d’entreprise. Pour la plupart des clés prises en charge, la managed-settings.json valeur est prioritaire sur toute configuration basée sur un fichier qu’un utilisateur définit dans son client. Dans Copilot pour CLI, les paramètres managés sandbox définissent plutôt des restrictions minimales que les utilisateurs peuvent renforcer, mais ne peuvent pas relâcher.

Les paramètres gérés par GPM et basés sur des fichiers sont chargés à partir de l’appareil. Ils peuvent donc s’appliquer avant la connexion ou un aller-retour serveur et rester actifs lorsque les utilisateurs changent de compte. Les paramètres gérés par le serveur sont associés au compte connecté de l’utilisateur.

Définition des paramètres

Pour plus d’informations sur les propriétés et la syntaxe disponibles, consultez Paramètres gérés par l’entreprise.

Utilisez copilot/team-mappings.json et le copilot/Équipes/ répertoire lorsque vous avez besoin d’une ou de plusieurs équipes d’entreprise pour utiliser des paramètres qui diffèrent des valeurs par défaut dans copilot/managed-settings.json. Pour plus d’informations, consultez « Configuration des paramètres gérés par l’entreprise ».

Choix d’une méthode de déploiement

Il existe plusieurs façons de déployer des paramètres gérés par l’entreprise. Utilisez les instructions suivantes pour choisir la méthode appropriée pour vous. Pour toute méthode, pilotez sur un petit groupe d’appareils avant un déploiement étendu.

Géré par le serveur : valeur par défaut pour la plupart des entreprises et meilleure pour passer en revue les flux de travail et l’historique d’audit. S’applique à tous les clients, y compris Agent cloud Copilot.
Gestion des appareils mobiles : mieux quand les équipes informatiques ont besoin d’un ciblage de groupe d’appareils via des outils MDM existants sur macOS et Windows. Clients locaux uniquement.
Basé sur des fichiers : disponible sur toutes les plateformes et utile lorsque le déploiement géré par le serveur et géré par mdm n’est pas disponible, y compris les environnements de développement tels que les conteneurs et Codespaces. Clients locaux uniquement.

Dans Copilot pour CLI, si une demande de paramètres gérés par le serveur échoue et qu’aucune réponse mise en cache n’est disponible, la stratégie gérée par le serveur n’est pas disponible pour cette session. Pour les restrictions qui doivent rester disponibles sans réponse de serveur, utilisez des paramètres gérés par MDM ou basés sur des fichiers.

Il existe des considérations supplémentaires si vous utilisez une entreprise dédiée pour Copilot Business. Consultez conseils pour les entreprises dédiéesCopilot Business.

Déploiement des paramètres gérés par le serveur

Créez et configurez votre .github-private référentiel. Consultez « Création d’un .github-private référentiel ».
Dans le référentiel, créez ou mettez à jour copilot/managed-settings.json.
Ajoutez vos clés et valeurs de stratégie d’entreprise au format JSON.
Validez et envoyez vos modifications à la branche par défaut.
Vérifiez que les utilisateurs d’entreprise exécutent un client pris en charge. Les paramètres mis à jour sont appliqués automatiquement dans environ une heure. Le redémarrage du client ou la connexion déclenche une actualisation immédiate.

Remplacement des paramètres pour des équipes spécifiques

Pour les déploiements gérés par le serveur, utilisez copilot/team-mappings.json et l’annuaire copilot/Équipes/ lorsqu’une ou plusieurs équipes d’entreprise doivent utiliser des paramètres qui diffèrent de vos valeurs par défaut copilot/managed-settings.json . enabledPlugins et extraKnownMarketplaces fonctionnent de façon additive. L’entreprise managed-settings.json définit une base de référence et un fichier d’équipe d’entreprise peut ajouter d’autres plug-ins et des places de marché.

Dans le fichier de copilot/managed-settings.json votre entreprise, marquez chaque clé que vous souhaitez rendre éligible au remplacement à l’aide de la { "overridable": <VALUE> } syntaxe. Les json fichiers que vous mappez aux équipes ne peuvent envoyer que des valeurs différentes pour les clés que vous marquez substituables. Une overridable valeur que managed-settings.json vous fournissez est la valeur par défaut lorsque les fichiers Teams ne déclarent pas de valeur différente pour une clé donnée. Par exemple, pour différer les deux model et disableBypassPermissionsMode:
```
{
  "model": { "overridable": "auto" },
  "permissions": {
    "disableBypassPermissionsMode": { "overridable": "disable" }
  },
  "allowedMcpServers": {
    "overridable": [
      { "serverUrl": "https://mcp.company.com/*" }
    ]
  }
}
```
Dans le référentiel de .github-private votre entreprise, créez copilot/team-mappings.json. Mappez chaque fichier de paramètres d’équipe à une ou plusieurs slugs d’équipe d’entreprise. La clé est le nom du fichier de paramètres et la valeur est un tableau de slugs d’équipe. Vous pouvez donc appliquer un fichier à plusieurs équipes.
```
{
  "devs.json": ["developers-all", "finops-dev"],
  "ai-users.json": ["ai-baseline-trained"],
  "frontier.json": ["ai-pioneers"]
}
```
Créez le fichier de paramètres d’équipe sous copilot/Équipes/. Incluez uniquement les clés que vous avez marquées comme substituables. 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/*" }
  ]
}
```
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, ses fichiers d’équipe 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.

Déploiement des paramètres gérés par MDM

La remise GPM native utilise les mêmes clés logiques et valeurs que les paramètres gérés par le serveur, mais elle ne déploie pas de managed-settings.json fichier. Au lieu de cela, votre plateforme MDM déploie des paramètres individuels en tant que valeurs de chaîne gérées par le système d’exploitation.

La remise mdm native est disponible sur Windows et macOS :

Système d'exploitation	Emplacement de la stratégie native
Windows	Valeurs de chaîne (`REG_SZ`) sous `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GitHubCopilot`
macOS	Valeurs de chaîne dans les préférences gérées forcées pour le `com.github.copilot` domaine de préférence
Linux	La remise MDM native n’est pas prise en charge. Utilisez plutôt des paramètres basés sur des fichiers.

Toutes les valeurs MDM natives doivent être des chaînes. Pour les paramètres imbriqués, utilisez une clé séparée par un point, telle que permissions.disableBypassPermissionsMode ou sandbox.enabled. Stockez directement les valeurs de chaîne ordinaires. Stockez des booléens, des tableaux et des objets sous forme de texte JSON dans une valeur de chaîne.

Par exemple:

Key	Valeur de chaîne native
`permissions.disableBypassPermissionsMode`	`disable`
`sandbox.enabled`	`true`
`enabledPlugins`	`{"PLUGIN-NAME@MARKETPLACE-NAME":true}`

Choisissez les paramètres que vous souhaitez appliquer. Consultez « Paramètres gérés par l’entreprise ».
Convertissez chaque paramètre en représentation de la clé native et de la valeur de chaîne.
Déployez les paramètres dans l’emplacement de stratégie native à l’aide de votre plateforme MDM d’entreprise et du processus de déploiement standard.
Affectez la stratégie aux groupes d’appareils cibles.

Les clients n’ont pas besoin de redémarrer et de vérifier les stratégies mises à jour toutes les heures. Dans VS Code, un administrateur peut forcer un test en exécutant la Developer: Sync Account Policy commande.
Vérifiez que les paramètres ont pris effet. Consultez Vérification de l’application de la configuration.

Déploiement des paramètres basés sur des fichiers

Placez-vous managed-settings.json à l’emplacement suivant :

Système d'exploitation	Emplacement du fichier
macOS	`/Library/Application Support/GitHubCopilot/managed-settings.json`
Windows	`%ProgramFiles%\GitHubCopilot\managed-settings.json`
Linux	`/etc/github-copilot/managed-settings.json`

Créez ou mettez à jour un managed-settings.json fichier avec les clés et valeurs de stratégie que vous souhaitez appliquer.
Distribuez le fichier à l’emplacement spécifique à la plateforme à l’aide de votre processus de gestion des appareils standard. Les ordinateurs qui ne reçoivent pas le fichier ne sont pas limités par cette stratégie.
Pour Copilot pour CLI macOS et Linux, faites du fichier un fichier standard appartenant rootà , et assurez-vous qu’il n’est pas accessible en écriture par groupe ou accessible en écriture mondiale. N’utilisez pas de lien symbolique. L’interface CLI rejette les fichiers qui ne répondent pas à ces exigences.
Demandez aux utilisateurs de redémarrer les clients pris en charge afin que la stratégie mise à jour soit chargée au démarrage.
Vérifiez que les paramètres ont pris effet. Consultez Vérification de l’application de la configuration.

Vérification de l’application de la configuration

Pour les déploiements gérés par le serveur, les utilisateurs sur un client pris en charge voient les paramètres spécifiés dans un délai d’environ une heure. Cela inclut copilot/managed-settings.json, copilot/team-mappings.jsonet les fichiers dans copilot/Équipes/. Le redémarrage du client ou la connexion déclenche une actualisation immédiate.

Pour les déploiements gérés par GPM, les clients recherchent les stratégies mises à jour toutes les heures. Pour les déploiements basés sur des fichiers, redémarrez le client pour charger un fichier mis à jour.

Si un utilisateur ne voit pas ces paramètres, assurez-vous qu’il ait accès à Copilot par le biais de votre entreprise ou de l’une de ses organisations. Si un utilisateur reçoit une licence de plusieurs entités de facturation, vérifiez qu’il a sélectionné votre entreprise dans la liste déroulante « Utilisation facturée à » dans ses paramètres personnelsCopilot.

Conseils pour les entreprises dédiées Copilot Business

Si vous disposez d’une entreprise dédiée pour Copilot Business (parfois appelée Copilot autonome), vous pouvez toujours utiliser les paramètres gérés par l’entreprise. La méthode de déploiement que vous choisissez détermine ce que vous devez configurer en premier.

Utilisation des paramètres gérés par le serveur

Les paramètres gérés par le serveur nécessitent une organisation et un .github-private référentiel. Pour les créer, un utilisateur de votre entreprise a besoin d’une GitHub Enterprise licence. Avec cette licence, l’utilisateur peut :

Créez une organisation et un .github-private référentiel. Consultez « Création d’un .github-private référentiel ».
Ajoutez des paramètres au référentiel dans un copilot/managed-settings.json fichier.
Définissez cette organisation comme source de gouvernance pour les normes IA de votre entreprise. Consultez « Création d’un .github-private référentiel ».

À partir de ce moment, tout utilisateur du forfait Copilot de votre entreprise qui utilise Copilot pour CLI ou VS Code est soumis à ces paramètres, qu’il ait ou non accès au référentiel .github-private.

La principale limitation de cette méthode est l’exigence GitHub Enterprise de licence pour créer l’organisation et le référentiel.

Utilisation des paramètres gérés par MDM ou basés sur des fichiers

Si vous ne souhaitez pas ajouter de GitHub Enterprise licence ou créer une organisation, vous pouvez déployer les mêmes paramètres logiques via MDM (par exemple Intune ou Jamf) ou un déploiement basé sur des fichiers. La remise basée sur les fichiers utilise directement le schéma JSON. La remise MDM native utilise des clés plates et des valeurs encodées par chaîne. Aucune des méthodes ne nécessite une organisation ou .github-private un référentiel. Consultez Déploiement de paramètres gérés par MDM et déploiement de paramètres basés sur des fichiers. Pour obtenir des conseils spécifiques à VS Code, consultez Déployer les paramètres gérés de Copilot dans la documentation VS Code.

Considérations relatives à l’accès au plug-in

Les utilisateurs n’ont pas besoin d’avoir accès au dépôt .github-private pour que les clients puissent récupérer les paramètres gérés. Toutefois, si les paramètres managés définissent un plug-in à l’aide enabledPlugins, le client tente automatiquement de l’installer pour chaque utilisateur. L’utilisateur a besoin d’accéder à l’emplacement où les fichiers de plug-in sont hébergés. Si le plug-in est hébergé dans un référentiel privé sur GitHub, l’utilisateur a besoin d’une autorisation pour ce référentiel, ce qui peut nécessiter une licence.