Aller au contenu principal

Déployer des agents de codage avec la gestion des appareils mobiles (MDM)

info

Bêta

Cette fonctionnalité est en version bêta. Pour l'utiliser, un administrateur de workspace doit activer la configuration managée de Unity Gateway à partir de la page Aperçus . Consultez Gérer les aperçus Databricks.

Utilisez la gestion des appareils mobiles (MDM) et la CLI Unity Gateway pour distribuer la configuration de l'agent de codage de votre équipe. Les administrateurs publient la configuration dans le workspace, et les développeurs utilisent leurs agents familiers avec les modèles, les serveurs MCP et les compétences configurés.

Logiciels MDM pris en charge :

  • Jamf Pro (macOS), avec un script de provisionnement prêt à l’emploi

Votre outil/solution/technologie/plateforme MDM exécute un script de provisionnement avec des privilèges d'administrateur sur chaque appareil. Le script installe ug, le Databricks CLI et les agents de codage, puis exécute ug configure pour appliquer la configuration de l'agent de codage de votre workspace pour chaque développeur sur l'appareil. Les développeurs lancent ensuite leur agent sans privilèges d'administrateur et se connectent avec leur propre compte Databricks.

remarque

Le provisionnement MDM configure Claude Code et Codex, qui ont des paramètres à l'échelle de la machine. Il ne configure pas GitHub Copilot CLI ou GitHub Copilot dans Visual Studio Code. Les développeurs configurent eux-mêmes GitHub Copilot avec ug configure --agents copilot.

Déployer avec MDM​

Configurer des agents de codage​

Activez les agents utilisés par votre équipe et publiez la configuration dans votre workspace. Voir Configurer des agents de codage.

Chaque agent activé a besoin d'au moins un modèle dans la configuration que le service principal de l'étape suivante peut utiliser. Par exemple, Claude Code a besoin de modèles Claude. ug configure ignore tout agent sans modèles.

Créer un service principal de provisionnement​

La politique MDM utilise un Service Principal uniquement pour lire la configuration publiée pendant son exécution. Les développeurs s'authentifient en tant qu'eux-mêmes. Le script utilise temporairement les identifiants du Service Principal pour que ug puisse se connecter au workspace et download la configuration de l'agent de codage.

  1. Ajoutez un service principal à votre workspace, par exemple ug-mdm-provisioning.

  2. Ne laissez activé que le droit d'accès Workspace access . Le Service Principal n'a pas besoin d'autres droits. Voir Gérer les droits.

  3. Accordez au Service Principal l'accès aux modèles, aux serveurs MCP et aux compétences dans la configuration publiée, y compris les privilèges Unity Catalog requis. Consultez Accorder l'accès aux modèles, aux serveurs MCP et aux compétences.

  4. Sous le Secrets tab du Service Principal, cliquez sur Générer le secret . Choisissez une durée de vie qui correspond à votre politique de rotation. Sous Étendue , cliquez sur Autres APIs , ajoutez les étendues ai-gateway et unity-catalog, et définissez chacune sur Lecture . Consultez Étape 1 : Créer un secret OAuth.

    Boîte de dialogue Générer un secret OAuth avec les scopes ai-gateway et Unity Catalog ajoutés sous Autres APIs, chacun défini sur Lire

  5. Copiez l’ID client et la clé secrète. Vous ne pourrez plus voir la clé secrète après avoir fermé la boîte de dialogue.

Déployer avec votre outil/solution/technologie/plateforme MDM​

important

Install ug in a shared location that every user on the device can run, not in the root user's home directory. ug configure records the path to ug in the machine-wide agent settings, and each developer's agent runs ug from that path to authenticate.

Ces étapes déploient Claude Code et Codex sur les appareils macOS avec Jamf Pro. Chaque appareil nécessite :

  • Accès réseau à l'URL de votre workspace, PyPI (pypi.org et files.pythonhosted.org), GitHub (github.com et raw.githubusercontent.com), astral.sh, nodejs.org et registry.npmjs.org.
  • Outils de ligne de commande pour Xcode, ou l’autorisation pour le script de les installer avec softwareupdate. ug est installé depuis GitHub, ce qui nécessite git.

Ajouter le script​

  1. Dans Jamf Pro, accédez à Settings > Gestion informatique > Scripts > New et nommez le script Unity Gateway provision.

    Page du nouveau script Jamf Pro sur le tab Général avec le nom d’affichage Provisionnement de la passerelle Unity

  2. Sous le Script tab, collez le script suivant :

Afficher le script de provisionnement

Bash
#!/bin/bash
#
# macOS MDM provisioning script, written for Jamf Pro policies: install
# ug, the Databricks CLI, Claude Code and Codex machine-wide and run
# `ug configure` as root, which installs the workspace policy at
# /etc/unitygateway/managed-settings.json. It also adds `claude` and
# `codex` aliases to /etc/zshrc and /etc/bashrc, so users launch with
# `claude` or `codex` in a new terminal, with no sudo.
#
# Jamf parameters ($1-$3 are reserved by Jamf):
# $4 Databricks workspace URL, starting with https://
# $5 Service principal OAuth client id
# $6 Service principal OAuth client secret
#
# The token is used for this run only; developers sign in with their own
# OAuth. Needs access to PyPI, GitHub, astral.sh, nodejs.org and npmjs.org.

set -euo pipefail
umask 022
export HOME=/var/root
export PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
WORKSPACE="${4%/}"
PREFIX=/usr/local/unity-gateway
NODE_VERSION=22.23.5
NODE_SHA256=89fadefd7798158d8990ca9ed7dbb58f8ca7593adb92fe3da8a445db99415533
UG_REPO=https://github.com/databricks/unity-gateway
UV_URL=https://astral.sh/uv/install.sh
CLI_URL=https://raw.githubusercontent.com
CLI_URL="$CLI_URL/databricks/setup-cli/main/install.sh"
CLT_MARKER=/tmp/.com.apple.dt.CommandLineTools
CLT_MARKER="$CLT_MARKER.installondemand.in-progress"

# ug must be in a shared path: the machine-wide agent settings
# run it by absolute path for every user.
export UV_TOOL_DIR="$PREFIX/tools"
export UV_TOOL_BIN_DIR=/usr/local/bin
export UV_PYTHON_INSTALL_DIR="$PREFIX/python"
export UV_PYTHON_PREFERENCE=only-managed
# ug's npm installer must put agents on every user's PATH, not in root's home.
export npm_config_prefix=/usr/local
mkdir -p /usr/local/bin

# Get ug from git
if ! xcode-select -p >/dev/null 2>&1; then
touch "$CLT_MARKER"
clt="$(softwareupdate -l 2>/dev/null \
| sed -n 's/^\* Label: \(Command Line Tools.*\)$/\1/p' \
| tail -n1)"
softwareupdate -i "$clt"
rm -f "$CLT_MARKER"
fi

if ! command -v uv >/dev/null; then
curl -LsSf "$UV_URL" \
| env UV_INSTALL_DIR=/usr/local/bin UV_NO_MODIFY_PATH=1 sh
fi
uv tool install --force "git+$UG_REPO"

if [ ! -x /usr/local/bin/databricks ]; then
curl -fsSL "$CLI_URL" | sh
fi

# ug configure installs missing agents with npm; provide a shared Node.js runtime.
if ! command -v node >/dev/null || ! command -v npm >/dev/null; then
tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' EXIT
package="node-v$NODE_VERSION.pkg"
/usr/bin/curl -fsSL -o "$tmp/$package" \
"https://nodejs.org/dist/v$NODE_VERSION/$package"
printf '%s %s\n' "$NODE_SHA256" "$tmp/$package" | /usr/bin/shasum -a 256 -c -
/usr/sbin/installer -pkg "$tmp/$package" -target /
fi

# Get short lived credential; curl reads the client id and secret from
# stdin (-K -) so they don't appear in its arguments.
resp="$(printf 'user = "%s:%s"\n' "$5" "$6" \
| curl -sS -K - \
-d grant_type=client_credentials \
--data-urlencode 'scope=ai-gateway:read unity-catalog:read' \
"$WORKSPACE/oidc/v1/token")"
if ! DATABRICKS_BEARER="$(printf '%s' "$resp" \
| plutil -extract access_token raw -o - -)"; then
echo "Token request to $WORKSPACE failed: $resp" >&2
exit 1
fi
export DATABRICKS_BEARER

/usr/local/bin/ug configure --global --mdm --workspace "$WORKSPACE" \
--agents claude,codex </dev/null
unset DATABRICKS_BEARER resp

# Aliases for every user's interactive zsh and bash shells. The block is
# rewritten on each run, which restores it if a macOS update resets
# the file.
for rc in /etc/zshrc /etc/bashrc; do
[ -f "$rc" ] || continue
sed -i '' '/^# BEGIN unity-gateway/,/^# END unity-gateway/d' "$rc"
cat >>"$rc" <<'ALIASES'
# BEGIN unity-gateway (managed by MDM)
alias claude='UG_SKIP_OS_SETTINGS=1 ug claude'
alias codex='UG_SKIP_OS_SETTINGS=1 ug codex'
# END unity-gateway
ALIASES
done
  1. Sous l’ Options tab, libellez Parameter 4 Workspace URL, Parameter 5 Client ID et Parameter 6 Client secret.

    tab Options du script Jamf Pro avec le Parameter 4 intitulé URL du Workspace, le Parameter 5 intitulé ID client et le Parameter 6 intitulé Secret client

  2. Cliquez sur Enregistrer .

Le script réinstalle ug à chaque exécution et installe la CLI Databricks uniquement lorsqu’elle est manquante. Si Node.js ou npm sont manquants, le script installe le package officiel Node.js 22.23.5 après avoir vérifié sa somme de contrôle SHA-256 pin. ug configure réutilise ensuite les agents existants sur le PATH partagé, ou installe Claude Code et Codex via npm avec l'installateur intégré de Unity Gateway. Les agents que le workspace n'active pas ne sont pas installés. Le script ne met pas à jour Node.js, les agents ou la CLI ; pour les garder à jour, modifiez le script pour qu'il corresponde à la façon dont vous mettez à jour les logiciels sur vos appareils.

Les Mac ayant fait l’objet d’un provisionnement avec l’ancienne version de ce script conservent leurs installations d’agent natif ; l’exécution du nouveau script ne constitue pas une migration vers npm. Pour migrer ces Mac vers npm, supprimez les anciennes installations natives avec votre processus de gestion de software, puis exécutez à nouveau la politique.

Créer la politique​

  1. Accédez à Informatique > Politiques > Nouveau .

  2. Dans Général , définissez Trigger sur Check-in récurrent et Fréquence d'exécution sur Une fois par jour . Chaque appareil exécute ug configure quotidiennement, ce qui applique les mises à jour de configuration que vous publiez dans le workspace.

    Options générales de la nouvelle politique de Jamf Pro avec le trigger Vérification récurrente sélectionné et Fréquence d&#39;exécution définie sur Une fois par jour

  3. Dans Scripts , ajoutez Unity Gateway provision avec Priorité réglée sur Après . Saisissez les paramètres :

parameter

Valeur

4 (URL de workspace)

L'URL de votre workspace, commençant par https://.

5 (Identifiant client)

L'ID client du Service Principal.

6 (Secret du client)

Secret du Service Principal.

parameter

Valeur

4 (URL de workspace)

L'URL de votre workspace, commençant par https://.

5 (Identifiant client)

L'ID client du Service Principal.

6 (Secret du client)

Secret du Service Principal.

Les options de scripts de stratégie Jamf Pro affichant le script de provisionnement Unity Gateway avec la priorité définie sur Après et les valeurs d&#39;espace réservé pour l&#39;URL du workspace, l&#39;ID client et le secret client 4. Dans Portée , sélectionnez les appareils à cibler. start avec un petit groupe d’appareils pilotes.

  1. Cliquez sur Enregistrer . Jamf Pro exécute la politique sur chaque appareil ciblé lors de son prochain check-in.

Informez vos développeurs​

Après l'exécution de la politique sur un appareil, les développeurs ouvrent un nouveau terminal et exécutent claude ou codex comme d'habitude. Le premier lancement ouvre un navigateur où le développeur se connecte à Databricks. L'activité de l'agent de codage est alors attribuée au développeur individuel, et non au service principal.

Déployer l’application de bureau Claude​

La même exécution de ug configure configure également l'application de bureau Claude pour chaque utilisateur sur l'appareil. Pour prendre en charge Claude Desktop, installez-le dans votre script de provisionnement avant que le script ne s’exécute ug configure. Le script Jamf Pro ci-dessus n'installe pas Claude Desktop.

Lorsqu’un utilisateur ouvre Claude desktop pour la première fois, il se connecte avec son propre compte Databricks. Les utilisateurs peuvent également importer leurs projets et chats claude.ai.

Vérifier le déploiement​

Sur un appareil pilote, connectez-vous avec le compte du système d'exploitation du développeur et vérifiez que :

  • L'agent s'ouvre et répond à l'aide d'un modèle configuré.
  • Les serveurs et compétences MCP configurés sont disponibles, et le développeur peut les utiliser.
  • Les requêtes apparaissent dans le suivi de l'utilisation de Unity Gateway, et les traces apparaissent si le traçage est activé. Consultez Surveiller l'activité des agents de codage.

Répétez ces vérifications après avoir modifié le script de provisionnement ou la configuration publiée.

Maintenir les identifiants et la configuration​

Pour faire pivoter le secret du Service Principal :

  1. Générez un nouveau secret pour le service principal.
  2. Mettez à jour le secret dans votre politique MDM.
  3. Une fois la politique exécutée sur vos appareils, supprimez l'ancien secret.

Pour mettre à jour la configuration, publiez les modifications dans le workspace. Les appareils les appliquent la prochaine fois que la politique s'exécute. Voir Synchroniser les mises à jour de configuration.

Dépannage​

Erreur

Cause

Token request to ... failed: {"error":"invalid_client"...}

L’ID client ou le secret dans la stratégie MDM est incorrect, ou le secret a expiré.

Token request ... failed: ... Scopes ... are not assigned to the client

Le secret n'a pas les portées ai-gateway:read et unity-catalog:read.

None of the coding agents enabled by your workspace configuration are available

Aucun agent activé ne dispose de modèles que le Service Principal peut utiliser, par exemple Claude Code configuré sans modèles Claude.

Erreur

Cause

Token request to ... failed: {"error":"invalid_client"...}

L’ID client ou le secret dans la stratégie MDM est incorrect, ou le secret a expiré.

Token request ... failed: ... Scopes ... are not assigned to the client

Le secret n'a pas les portées ai-gateway:read et unity-catalog:read.

None of the coding agents enabled by your workspace configuration are available

Aucun agent activé ne dispose de modèles que le Service Principal peut utiliser, par exemple Claude Code configuré sans modèles Claude.