Einführung von Coding-Agenten mit mobiler Geräteverwaltung (MDM)

Important

Dieses Feature befindet sich in der Betaversion. Um sie zu nutzen, muss ein Workspace-Administrator die Unity Gateway Managed Configuration auf der Seite Previews aktivieren. Siehe Manage Azure Databricks Previews.

Nutzen Sie Mobile Device Management (MDM) und die Unity Gateway CLI, um die Coding-Agenten-Einrichtung Ihres Teams zu verteilen. Administratoren veröffentlichen die Konfiguration im Arbeitsbereich, und Entwickler nutzen ihre vertrauten Agenten mit den konfigurierten Modellen, MCP-Servern und Skills.

Unterstützte MDM-Software:

  • Jamf Pro (macOS), mit einem einsatzbereiten Bereitstellungsskript

Deine MDM-Software führt auf jedem Gerät ein Provisioning-Skript mit Administratorrechten aus. Das Skript installiert ug, die Databricks-CLI und die Coding-Agenten und führt dann ug configure aus, um die Coding-Agent-Konfiguration Ihres Arbeitsbereichs für jeden Entwickler auf dem Gerät anzuwenden. Entwickler starten dann ihren Agenten ohne Administratorrechte und melden sich mit ihrem eigenen Azure Databricks-Konto an.

Note

Die MDM-Bereitstellung konfiguriert Claude Code und Codex, die maschinenweite Einstellungen haben. Es konfiguriert weder GitHub Copilot CLI noch GitHub Copilot in Visual Studio Code. Entwickler richten GitHub Copilot selbst mithilfe von ug configure --agents copilot ein.

Einführung mit MDM

Coding-Agents konfigurieren

Aktivieren Sie die Agenten, die Ihr Team verwendet, und veröffentlichen Sie die Konfiguration in Ihrem Arbeitsbereich. Siehe Codierungsagenten konfigurieren.

Jeder aktivierte Agent benötigt mindestens ein Modell in der Konfiguration, das der Service Principal aus dem nächsten Schritt verwenden kann. Zum Beispiel benötigt Claude Code Claude-Modelle. ug configure Überspringt jeden Agenten ohne Modelle.

Erstellen Sie einen Provisioning Service Principal

Die MDM-Richtlinie verwendet einen Service Principal nur, um die veröffentlichte Konfiguration während der Ausführung zu lesen. Entwickler authentifizieren sich als sie selbst. Das Skript nutzt vorübergehend die Anmeldedaten des Serviceprincipals, damit es ug sich mit dem Arbeitsbereich verbinden und die Konfiguration des Codéierungsagenten herunterladen kann.

  1. ug-mdm-provisioning zu deinem Arbeitsbereich hinzu, zum Beispiel .

  2. Lassen Sie nur das Workspace-Zugriffsrecht aktiviert. Der Service-Principal benötigt keine anderen Berechtigungen. Siehe Verwalten von Berechtigungen.

  3. Gewähren Sie dem Service Principal Zugriff auf die Modelle, MCP-Server und Skills in der veröffentlichten Konfiguration, einschließlich der erforderlichen Unity-Catalog-Rechte. Weitere Informationen finden Sie unter Zugriff auf Modelle, MCP-Server und Skills gewähren.

  4. Auf der Registerkarte Geheimnisse des Dienstprinzipals, klicken Sie auf Geheimnis generieren. Wählen Sie eine Gültigkeitsdauer, die zu Ihrer Rotationsrichtlinie passt. Unter Scope klicken Sie auf Andere APIs, fügen Sie die Scopes ai-gateway und unity-catalog hinzu und setzen Sie alle auf Lesen. Siehe Schritt 1: Erstellen eines OAuth-Schlüssels.

    Generiere OAuth-Secret-Dialog mit den ai-gateway- und Unity-Catalog-Scopes, die unter Other APIs hinzugefügt sind, jeweils auf Read gesetzt

  5. Kopiere die Client-ID und das Secret. Du kannst das Secret nicht mehr ansehen, nachdem du den Dialog geschlossen hast.

Stellen Sie mit Ihrer MDM-Software bereit

Important

Installieren Sie ug an einem gemeinsamen Standort, von dem aus jeder Benutzer auf dem Gerät es ausführen kann, nicht im Home-Verzeichnis des Root-Benutzers. ug configure verzeichnet den Pfad zu ug in den maschinenweiten Agent-Einstellungen, und der Agent jedes Entwicklers führt ug von diesem Pfad zur Authentifizierung aus.

Jamf Pro (macOS)

Diese Schritte rollen Claude Code und Codex mit Jamf Pro auf macOS-Geräten aus. Jedes Gerät benötigt:

  • Netzwerkzugriff auf Ihre Workspace-URL, PyPI (pypi.org und files.pythonhosted.org), GitHub (github.com und raw.githubusercontent.com), astral.sh, nodejs.org, und registry.npmjs.org.
  • Kommandozeilen-Tools für Xcode oder die Berechtigung für das Skript, sie mit softwareupdatezu installieren. ug wird von GitHub installiert, was git erfordert.

Fügen Sie das Skript hinzu

  1. In Jamf Pro gehen Sie zu Einstellungen > Computer Management > Skripte > Neu, und benennen Sie das Skript Unity Gateway provision.

    Jamf Pro New Script-Seite auf der Registerkarte Allgemein mit dem Anzeigenamen Unity Gateway Bereitstellung

  2. Fügen Sie im Skript-Tab folgendes Skript ein:

    Sehen Sie das Provisioning-Skript an
    #!/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
    
  3. Beschriften Sie im Options-Tab Parameter 4Workspace URL, Parameter 5Client ID und Parameter 6Client secret.

    Registerkarte Jamf-Pro-Skriptoptionen mit Parameter 4 als Workspace-URL, Parameter 5 mit Client-ID und Parameter 6 mit Client-Geheimnis beschriftet

  4. Klicke auf Speichern.

Das Skript installiert sich bei jedem Lauf neu und installiert die Databricks-CLI nur, wenn sie fehlt. Wenn Node.js oder npm fehlt, installiert das Skript das offizielle Node.js 22.23.5-Paket, nachdem es die angepinnte SHA-256-Checksumme geprüft hat. ug configure verwendet dann bestehende Agenten auf dem gemeinsamen PATH wieder oder installiert Claude Code und Codex über npm mit dem integrierten Installer von Unity Gateway. Agenten, die im Arbeitsbereich nicht aktiviert sind, werden nicht installiert. Das Skript aktualisiert Node.js, die Agenten oder die CLI ansonsten nicht; um sie aktuell zu halten, passen Sie das Skript an die Aktualisierung Ihrer Software auf Ihren Geräten an.

Macs, die mit der früheren Version dieses Skripts provisioniert wurden, behalten ihre nativen Agent-Installationen; das Ausführen des neuen Skripts stellt keine Migration zu NPM dar. Um diese Macs auf npm zu verschieben, entfernen Sie die alten nativen Installationen mit Ihrem Softwareverwaltungsprozess und führen Sie die Richtlinie erneut aus.

Richtlinie erstellen

  1. Gehe zu Computer > Richtlinien > Neu.

  2. Im Allgemein sollten Sie den Trigger auf Wiederkehrender Check-in‑ und Ausführungshäufigkeit auf einmal pro Tag einstellen. Jedes Gerät führt ug configure täglich aus, wodurch Konfigurationsupdates angewendet werden, die du im Arbeitsbereich publizierst.

    Jamf Pro New Policy Allgemeine Optionen mit ausgewähltem Wiederkehrenden Check-in-Trigger und Ausführungsfrequenz auf Einmal täglich eingestellt

  3. In Scripts fügen Sie Unity Gateway provision mit Priorität auf Danach hinzu. Geben Sie die Parameter ein:

    Parameter Wert
    4 (Workspace-URL) Deine URL zum Arbeitsbereich, beginnend mit https://.
    5 (Client-ID) Die Client-ID des Dienstprinzipals.
    6 (Geheimer Clientschlüssel) Das Geheimnis des Service-Prinzipals.

    Jamf Pro-Richtlinien-Skriptoptionen, die das Unity Gateway-Bereitstellungsskript mit Priorität auf After und Platzhalterwerte für die Workspace-URL, die Client-ID und das Client-Geheimnis anzeigen

  4. Wählen Sie in Scope die zu anvisierenden Geräte aus. Beginnen Sie mit einer kleinen Gruppe von Pilotgeräten.

  5. Klicke auf Speichern. Jamf Pro führt die Richtlinie auf jedem Zielgerät beim nächsten Check-in aus.

Sag deinen Entwicklern Bescheid

Nachdem die Richtlinie auf einem Gerät ausgeführt wurde, öffnen die Entwickler ein neues Terminal und führen wie üblich claude oder codex aus. Der erste Start öffnet einen Browser, in dem sich der Entwickler bei Azure Databricks anmeldet. Die Aktivität des Coding-Agenten wird dann dem einzelnen Entwickler zugeschrieben, nicht dem Dienstprinzipal.

Einführung von Claude Desktop

Derselbe ug configure Durchlauf konfiguriert auch die Claude Desktop-App für jeden Nutzer auf dem Gerät. Um Claude Desktop zu unterstützen, installiere es in deinem Provisioning-Skript, bevor das Skript ug configure ausgeführt wird. Das oben beschriebene Jamf Pro-Skript installiert Claude Desktop nicht.

Wenn ein Nutzer Claude Desktop zum ersten Mal öffnet, meldet er sich mit seinem eigenen Azure Databricks-Konto an. Nutzer können auch ihre claude.ai Projekte und Chats importieren.

Überprüfen Sie den Rollout

Auf einem Pilotgerät melden Sie sich mit dem Betriebssystemkonto des Entwicklers an und prüfen Sie, ob:

  • Der Agent arbeitet und antwortet mit einem konfigurierten Modell.
  • Die konfigurierten MCP-Server und -Fähigkeiten sind verfügbar, und der Entwickler kann sie nutzen.
  • Anfragen erscheinen in der Nutzungsverfolgung des Unity Gateway, und Traces erscheinen, wenn Tracing aktiviert ist. Siehe Aktivität von Codierungsagenten überwachen.

Wiederholen Sie diese Prüfungen, nachdem Sie das Provisioning-Skript oder die veröffentlichte Konfiguration geändert haben.

Pflege von Zugangsdaten und Konfiguration

Um das Secret des Service Principals zu rotieren:

  1. Generiere ein neues Geheimnis für den Service Principal.
  2. Aktualisieren Sie den Geheimschlüssel in Ihrer MDM-Richtlinie.
  3. Nachdem die Richtlinie auf deinen Geräten ausgeführt wurde, lösche das alte Secret.

Um die Konfiguration zu aktualisieren, veröffentlichen Sie Änderungen im Arbeitsbereich. Geräte wenden diese das nächste Mal an, wenn die Richtlinie ausgeführt wird. Siehe Sync-Konfigurationsupdates.

Troubleshooting

Error Cause
Token request to ... failed: {"error":"invalid_client"...} Die Client-ID oder der geheime Schlüssel in der MDM-Richtlinie ist falsch, oder der geheime Schlüssel ist abgelaufen.
Token request ... failed: ... Scopes ... are not assigned to the client Das Secret hat nicht die Scopes ai-gateway:read und unity-catalog:read.
None of the coding agents enabled by your workspace configuration are available Kein aktivierter Agent hat Modelle, die der Service Principal verwenden kann, zum Beispiel Claude Code, der ohne Claude Models konfiguriert ist.