Gnista par MDM,
un seul profil.

Avec un abonnement équipe, votre service informatique peut installer la clé de Gnista et verrouiller ses réglages avec un profil de configuration, depuis n’importe quel MDM qui installe des profils personnalisés. Tout ici est facultatif : une équipe sans MDM partage simplement la clé.

Télécharger le profil modèle

Mis à jour le 27 oct. 2026

Comment ça marche

Gnista lit des préférences gérées dans son propre domaine, sh.gnista.Gnista, installées par un profil de configuration avec une charge utile com.apple.ManagedClient.preferences (que certains MDM appellent réglages personnalisés ou fichier de préférences). Les réglages gérés par le profil affichent « Géré par votre organisation » dans Gnista et ne peuvent pas y être modifiés.

Les réglages gérés ne s’appliquent qu’avec une clé équipe. LicenceKey fonctionne avec n’importe quelle clé ; avec une clé personnelle, Gnista ignore le reste et ses Réglages indiquent « La configuration centralisée nécessite un abonnement équipe. » Quand un profil contient à la fois la clé et des réglages, Gnista active d’abord la clé, puis applique les réglages.

Chaque clé, sauf LicenceKey et DisplayMode, ne compte que si le profil l’impose, sous Forced, comme dans le modèle. Chaque clé est facultative, et Gnista ignore celles qu’il ne connaît pas.

Les clés

Clé	Type	Ce qu’elle fait
`LicenceKey`	Chaîne	Active Gnista sans que personne ne saisisse la clé : essayée à chaque lancement tant que le Mac n’a pas de licence. Fonctionne avec n’importe quelle clé.
`EnabledAgents`	Tableau de chaînes	Seuls ces agents peuvent être connectés à Gnista, et seules leurs sessions s’affichent. Noms ci-dessous.
`ApprovalsAllowed`	Booléen	`false` désactive complètement les réponses aux demandes dans Gnista : chaque agent demande dans sa propre invite.
`ApprovalAgents`	Tableau de chaînes	Les agents dont les demandes peuvent recevoir une réponse dans Gnista.
`CrashReportsMode`	Chaîne	Ce que Gnista fait des rapports de plantage : `ask` (il demande après un plantage), `always` ou `never`.
`AutomaticUpdates`	Booléen	`true` active les mises à jour automatiques et verrouille l’interrupteur ; `false` empêche Gnista de chercher lui-même les mises à jour, pour que vous les déployiez vous-même.
`RemoteMachinesAllowed`	Booléen	`false` désactive les machines distantes : Gnista ferme ses tunnels SSH, et personne ne peut connecter de serveur dans les Réglages.
`RemoteConnection`	Chaîne	Comment se connectent les machines distantes : `automatic` (le ssh de Gnista, avec redirection), `relay` (le ssh de Gnista, sans jamais rediriger : une commande ordinaire) ou `manual` (aucun ssh de Gnista : les sessions des utilisateurs s’en chargent, par une ligne dans leur configuration ssh).
`ListSummaryAllowed`	Booléen	`false` désactive Décrire ce que font les agents : Apple Intelligence n’écrit jamais les mots d’une ligne sur ces Mac.
`DisplayMode`	Chaîne	Où Gnista s’affiche : `notch`, `menuBar` ou `both`. Forcé, il est verrouillé ; défini une seule fois, comme dans le modèle, c’est une valeur par défaut que chacun peut changer.

Noms des agents

EnabledAgents et ApprovalAgents désignent les agents comme le fait l’utilitaire de Gnista :

Nom	Agent
`claude`	Claude Code
`cowork`	Claude Cowork
`codex`	Codex
`gemini`	Gemini CLI
`copilot`	GitHub Copilot
`opencode`	OpenCode
`devin`	Devin
`qwen`	Qwen Code
`qwenwork`	QwenWork
`qoder`	Qoder CLI
`qoder-cn`	Qoder CN
`qoderwork`	QoderWork
`droid`	Factory Droid
`cursor`	Cursor
`antigravity`	Antigravity
`vibe`	Mistral Vibe
`codebuddy`	CodeBuddy
`workbuddy`	WorkBuddy
`kimi`	Kimi Code
`kilo`	Kilo Code
`mimocode`	MiMoCode
`zcode`	ZCode
`amp`	Amp
`auggie`	Auggie
`goose`	Goose
`pi`	Pi
`omp`	Oh My Pi
`openhands`	OpenHands
`grok`	Grok Build
`trae`	Trae
`trae-cn`	Trae CN
`codewhale`	Codewhale
`aider`	Aider
`dsh`	DeepSeek Harness

Copilot dans VS Code compte comme copilot. Les agents maison portent le nom de leur fichier. Répondre dans Gnista fonctionne avec claude, codex, devin, opencode, qwen, qoder, qoder-cn, codebuddy, workbuddy, droid, kilo, mimocode et zcode ; les autres noms dans ApprovalAgents ne changent rien.

Le profil

Un profil complet, avec toutes les clés. Le modèle est identique, avec un commentaire sur chaque clé. Gardez les clés que vous voulez gérer, mettez-y votre clé de licence, et donnez vos propres valeurs aux deux PayloadUUID (lancez uuidgen dans Terminal).

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>PayloadDisplayName</key>
  <string>Gnista</string>
  <key>PayloadDescription</key>
  <string>Gnista's licence key and settings for your team.</string>
  <key>PayloadIdentifier</key>
  <string>sh.gnista.Gnista.profile</string>
  <key>PayloadOrganization</key>
  <string>Your organisation</string>
  <key>PayloadScope</key>
  <string>System</string>
  <key>PayloadType</key>
  <string>Configuration</string>
  <key>PayloadUUID</key>
  <string>00000000-0000-4000-8000-000000000001</string>
  <key>PayloadVersion</key>
  <integer>1</integer>
  <key>PayloadContent</key>
  <array>
    <dict>
      <key>PayloadDisplayName</key>
      <string>Gnista settings</string>
      <key>PayloadIdentifier</key>
      <string>sh.gnista.Gnista.profile.preferences</string>
      <key>PayloadType</key>
      <string>com.apple.ManagedClient.preferences</string>
      <key>PayloadUUID</key>
      <string>00000000-0000-4000-8000-000000000002</string>
      <key>PayloadVersion</key>
      <integer>1</integer>
      <key>PayloadContent</key>
      <dict>
        <key>sh.gnista.Gnista</key>
        <dict>
          <key>Forced</key>
          <array>
            <dict>
              <key>mcx_preference_settings</key>
              <dict>
                <key>LicenceKey</key>
                <string>GNISTA-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</string>
                <key>EnabledAgents</key>
                <array>
                  <string>claude</string>
                  <string>codex</string>
                </array>
                <key>ApprovalsAllowed</key>
                <true/>
                <key>ApprovalAgents</key>
                <array>
                  <string>claude</string>
                </array>
                <key>CrashReportsMode</key>
                <string>never</string>
                <key>AutomaticUpdates</key>
                <false/>
                <key>RemoteMachinesAllowed</key>
                <true/>
                <key>RemoteConnection</key>
                <string>relay</string>
              </dict>
            </dict>
          </array>
          <key>Set-Once</key>
          <array>
            <dict>
              <key>mcx_data_timestamp</key>
              <date>2026-10-15T00:00:00Z</date>
              <key>mcx_preference_settings</key>
              <dict>
                <key>DisplayMode</key>
                <string>notch</string>
              </dict>
            </dict>
          </array>
        </dict>
      </dict>
    </dict>
  </array>
</dict>
</plist>

Ciblez les Mac (au niveau de l’appareil, comme dans le modèle), pas les utilisateurs.

Jamf Pro

Dans Jamf Pro, allez dans Computers, puis Configuration Profiles, et choisissez Upload. Sélectionnez votre gnista.mobileconfig modifié.
Vérifiez la charge utile General : niveau Computer, méthode de distribution Install Automatically.
Ciblez les ordinateurs ou les smart groups qui utilisent Gnista, et enregistrez.

Vous préférez le construire dans Jamf ? Créez un nouveau profil, ajoutez Application & Custom Settings, importez une liste de propriétés contenant seulement les clés, et indiquez sh.gnista.Gnista comme domaine de préférences.

Kandji

Dans Kandji, ouvrez la Library et ajoutez un Custom Profile.
Importez votre gnista.mobileconfig modifié et vérifiez qu’il s’installe sur Mac.
Attribuez-le aux Blueprints qui contiennent les Mac utilisant Gnista, et enregistrez.

Microsoft Intune

Dans le centre d’administration Intune, allez dans Devices, puis macOS, puis Configuration, et créez une nouvelle stratégie.
Choisissez Templates comme type de profil, puis Custom.
Donnez-lui un nom, choisissez le canal de l’appareil, et importez votre gnista.mobileconfig modifié.
Attribuez-le aux groupes d’appareils qui contiennent les Mac utilisant Gnista, et créez-le.

Le modèle Preference file d’Intune fonctionne aussi : indiquez sh.gnista.Gnista comme domaine de préférences et importez une liste de propriétés contenant seulement les clés.

Mosyle

Dans Mosyle, allez dans Management, puis Custom Profiles, et ajoutez un nouveau profil.
Importez votre gnista.mobileconfig modifié.
Attribuez-le aux appareils ou groupes d’appareils qui utilisent Gnista, et enregistrez.

Vérifier sur un Mac

Le profil apparaît dans Réglages Système, Général, Gestion des appareils. Ses réglages arrivent dans les préférences gérées du Mac :

defaults read "/Library/Managed Preferences/sh.gnista.Gnista"

Dans Gnista, les Réglages affichent les réglages gérés comme « Géré par votre organisation », et Réglages ▸ À propos ▸ Licence affiche la licence équipe. Pour essayer un profil avant de le déployer, double-cliquez dessus sur un Mac de test et installez-le dans Réglages Système.