Relution Signet Customer Hub

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

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, 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.

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 visionOS betrifft das Passwort → (com.apple.mobiledevice.passwordpolicy) und Restriktionen → (com.apple.applicationaccess).

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>