Customer HubApple 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
Die Konfiguration heißt im Portal Apple Configurator 2 Konfiguration. Im Feld Name wird eine Bezeichnung für die Konfiguration vergeben. Über .mobileconfig Datei auswählen wird die Datei hochgeladen. 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.
Im Feld Payload Inhalt können Benutzer-, Geräte- und Zertifikatsplatzhalter verwendet werden. Die verfügbaren Platzhalter werden unterhalb des Formulars angezeigt und beim Übertragen auf das Gerät ersetzt, siehe Erweiterte Platzhalter →.
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,PayloadUUIDundPayloadDisplayNamevorhanden. PayloadContententhä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.
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. 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.
Betroffene Payload-Typen unter macOS
| Payload-Typ in der Datei | Gesperrte Konfiguration |
|---|---|
com.apple.airplay | AirPlay |
com.apple.airprint | AirPrint → |
com.apple.applicationaccess | Restriktionen → |
com.apple.appstore | App Store Restriktionen |
com.apple.AssetCache.managed | Inhaltscaching |
com.apple.desktop | Desktop → |
com.apple.dnsProxy.managed | DNS Proxy |
com.apple.dock | Dock |
com.apple.domains | Administrierte Domänen |
com.apple.finder | Finder-Einstellungen |
com.apple.globalethernet.managed | Globale Ethernet-Einstellungen |
.GlobalPreferences | Globale Einstellungen |
com.apple.MCX | Konten und Stromspareinstellungen |
com.apple.MCX.TimeMachine | Time Machine |
com.apple.mobiledevice.passwordpolicy | Passwort |
com.apple.notificationsettings | Benachrichtigungen |
com.apple.preference.security | Sicherheitseinstellungen |
com.apple.proxy.http.global | Globaler HTTP Proxy |
com.apple.screensaver | Bildschirmschoner |
com.apple.security.firewall | Firewall |
com.apple.SetupAssistant.managed | Setup-Assistent |
com.apple.SoftwareUpdate | System-Updates |
com.apple.syspolicy.kernel-extension-policy | Kernel-Erweiterungen → |
com.apple.system-extension-policy | System-Erweiterungen |
com.apple.SystemConfiguration | Proxies |
com.apple.systempreferences | Systemeinstellungen |
com.apple.universalaccess | Barrierefreiheit |
com.apple.vpn.managed.appmapping | App zu VPN Zuordnung → |
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>