Apple Configurator 2 Konfiguration

Mit dieser Richtlinien-Konfiguration können .mobileconfig-Dateien auf Apple-Geräte übertragen werden. Eine solche Datei kann beispielsweise eine WLAN-Verbindung samt zugehörigem Identitätszertifikat (PKCS#12, .p12) enthalten.


Konfiguration

Das Formular trägt den Hinweis Unterstützt Benutzerregistrierung: Die Konfiguration kann auch an Geräte mit Benutzer-Einschreibung → verteilt werden. Welche Payload-Typen solche Geräte annehmen, legt Apple fest.

Im Feld Name wird eine Bezeichnung für die Konfiguration vergeben. Über .mobileconfig Datei auswählen wird die Datei hochgeladen, entweder über die Schaltfläche Auswählen oder per Drag-and-drop auf die Ablagefläche, die beim Ziehen einer Datei in das Browserfenster unter der Schaltfläche erscheint. Danach erscheint ihr Inhalt anstelle der Dateiauswahl im Feld Payload Inhalt und kann dort bearbeitet werden. Der Inhalt muss gültiges XML sein. Signierte Profile sind kein lesbares XML und lassen sich daher nicht verwenden. In Apple Configurator 2 wird die Datei deshalb ohne Signatur gesichert. Wird das Feld Payload Inhalt geleert, kann erneut eine Datei ausgewählt werden.

Name und Payload Inhalt sind Pflichtfelder. Speichern ist erst aktiv, wenn ein Name vergeben ist und Payload Inhalt gültiges XML enthält. Bearbeiten lässt sich die Konfiguration nur im Entwurf einer Richtlinie: In einer veröffentlichten Version sind die Felder schreibgeschützt und Speichern wird nicht angezeigt (siehe Richtlinien-Versionierung →).

Im Feld Payload Inhalt können Benutzer-, Geräte- und Zertifikatsplatzhalter verwendet werden. Die verfügbaren Platzhalter werden unterhalb des Formulars im Bereich Verfügbare Platzhalter angezeigt und beim Übertragen auf das Gerät ersetzt, siehe Erweiterte Platzhalter →. Ein Klick auf einen Platzhalter kopiert ihn in die Zwischenablage.

Pro Richtlinie können mehrere Apple-Configurator-2-Konfigurationen angelegt werden. Auf diese Weise lassen sich mehrere Konfigurationstypen auf getrennte Konfigurationen verteilen.

Anforderungen an die Datei

Beim Speichern wird der Inhalt geprüft. Die Datei muss folgende Bedingungen erfüllen:

  • Auf der obersten Ebene sind die Schlüssel PayloadType, PayloadVersion (als Zahl), PayloadIdentifier, PayloadUUID und PayloadDisplayName vorhanden.
  • PayloadContent enthält genau einen Konfigurationstyp. Zusätzlich dürfen Zertifikat-Payloads enthalten sein.

Dateien, die sich nicht auslesen lassen, denen einer dieser Schlüssel fehlt, die keinen Payload oder mehrere Konfigurationstypen enthalten, werden beim Speichern abgelehnt.

Mit übertragen werden nur Zertifikate im Format PKCS#12 (com.apple.security.pkcs12). PKCS#1-Zertifikate (com.apple.security.pkcs1) werden bei der Prüfung zwar akzeptiert, aber nicht an das Gerät übertragen. Andere Zertifikate wie Root-Zertifikate (com.apple.security.root) zählen als eigener Konfigurationstyp. Zusammen mit einer weiteren Konfiguration führen sie zu einem Fehler beim Speichern und werden daher in einer eigenen Konfiguration hinterlegt.

Die eigentliche Konfiguration muss in PayloadContent an erster Stelle stehen. Enthält die Datei mehrere Payloads desselben Typs, wird nur der erste auf das Gerät übertragen.

Konfigurationen, die nur einmal pro Richtlinie zulässig sind

Enthält die Datei einen Konfigurationstyp, den Relution auch als eigene, nur einmal pro Richtlinie zulässige Konfiguration anbietet, lässt sich diese Konfiguration in derselben Richtlinie nicht mehr hinzufügen. Unter iOS betrifft das folgende Payload-Typen:

Payload-TypGesperrte Konfiguration
com.apple.airplayAirPlay
com.apple.airprintAirPrint →
com.apple.app.lockEinzel-App-Modus → und Relution Shared Device →
com.apple.applicationaccessRestriktionen →
com.apple.cellularMobilfunknetz
com.apple.dnsProxy.managedDNS Proxy
com.apple.domainsAdministrierte Domänen →
com.apple.homescreenlayoutHomescreen Layout →
com.apple.mobiledevice.passwordpolicyPasswort →
com.apple.notificationsettingsBenachrichtigungen →
com.apple.proxy.http.globalGlobaler HTTP Proxy
com.apple.shareddeviceconfigurationNachricht auf Sperrbildschirm
com.apple.vpn.managed.appmappingApp zu VPN Zuordnung →

Umgekehrt wird eine solche Datei beim Speichern abgelehnt, wenn die Richtlinie die entsprechende Konfiguration oder eine weitere aktive Apple-Configurator-2-Konfiguration mit demselben Payload-Typ bereits enthält.

Beispiel

Die folgende Datei überträgt eine WLAN-Verbindung (com.apple.wifi.managed). SSID, Passwort, Bezeichner und UUIDs sind Beispielwerte und werden durch eigene Werte ersetzt. Jede PayloadUUID muss eindeutig sein.

<?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>PayloadContent</key>
 <array>
  <dict>
   <key>AutoJoin</key>
   <true/>
   <key>EncryptionType</key>
   <string>WPA2</string>
   <key>HIDDEN_NETWORK</key>
   <false/>
   <key>Password</key>
   <string>WLAN-Passwort</string>
   <key>PayloadDisplayName</key>
   <string>WLAN</string>
   <key>PayloadIdentifier</key>
   <string>com.example.wifi.payload</string>
   <key>PayloadType</key>
   <string>com.apple.wifi.managed</string>
   <key>PayloadUUID</key>
   <string>8D2E4C1A-3B5F-4A7E-9C6D-1F0B2A3C4D5E</string>
   <key>PayloadVersion</key>
   <integer>1</integer>
   <key>SSID_STR</key>
   <string>Firmen-WLAN</string>
  </dict>
 </array>
 <key>PayloadDescription</key>
 <string>WLAN-Konfiguration für Apple-Geräte</string>
 <key>PayloadDisplayName</key>
 <string>WLAN</string>
 <key>PayloadIdentifier</key>
 <string>com.example.wifi</string>
 <key>PayloadOrganization</key>
 <string>Beispiel GmbH</string>
 <key>PayloadType</key>
 <string>Configuration</string>
 <key>PayloadUUID</key>
 <string>4A7B1C2D-5E6F-4890-A1B2-C3D4E5F60718</string>
 <key>PayloadVersion</key>
 <integer>1</integer>
</dict>
</plist>

Wie hilfreich war dieser Artikel?