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 chaque clé prise en charge, la managed-settings.json valeur est prioritaire sur n’importe quelle configuration basée sur un fichier qu’un utilisateur définit dans son client.

Les paramètres managés sont chargés localement au démarrage du client, même si l’appareil n’a aucune connexion réseau. Cela signifie que les contrôles tels que la allow-all suppression des options d’autorisation et la restriction de la configuration du plug-in s’appliquent toujours avant la connexion ou tout aller-retour de serveur, et restent actifs lorsque les utilisateurs changent de compte.

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.

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, ou immédiatement après le redémarrage du client ou l’utilisateur se reconnecte.

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" }
  }
}
```
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"
  }
}
```
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

Créez ou mettez à jour votre managed-settings.json charge utile à l’aide du même schéma JSON utilisé pour les paramètres gérés par le serveur.
Déployez la charge utile à 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

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 aux machines managées à 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. Par conséquent, le déploiement basé sur les fichiers fournit uniquement une couverture pour les machines auxquelles vous distribuez activement.
Appliquez des autorisations de fichier en fonction des exigences de sécurité de votre entreprise.
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

Une fois la configuration validée, les utilisateurs sur un client pris en charge voient les paramètres spécifiés dans un délai d’environ une heure, car les clients vérifient régulièrement le serveur pour la configuration mise à jour. Pour les déploiements gérés par le serveur, cela inclut copilot/managed-settings.json, copilot/team-mappings.jsonet les fichiers dans copilot/Équipes/.

Le redémarrage du client ou la connexion applique immédiatement les derniers paramètres.

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 via MDM (par exemple Intune ou Jamf) ou un déploiement basé sur des fichiers. Ces méthodes utilisent le même schéma JSON et ne nécessitent pas d’organisation ou .github-private de 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.