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

Die Konfiguration heißt im Portal Apple Configurator 2 Konfiguration. Das Formular trägt den Hinweis Unterstützt Benutzerregistrierung: Die Konfiguration kann auch an Macs 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.

Unter macOS weist das Portal darauf hin, dass diese Konfiguration nur verwendet werden sollte, wenn die Datei keinen der folgenden Konfigurationstypen enthält: CardDAV, CalDAV, LDAP, Exchange, E-Mail und Web Clip. Relution überträgt die Apple-Configurator-2-Konfiguration auf Macs über den Gerätekanal, Konfigurationen dieser Typen dagegen über den Benutzerkanal in das Profil des angemeldeten Benutzers. Für CardDAV, CalDAV, Exchange, E-Mail und Web Clip stehen eigene Konfigurationen zur Verfügung: Kontakt, Kalender (CalDAV) →, Exchange →, E-Mail und Weblink. Eine eigene LDAP-Konfiguration bietet das Portal nicht an.

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.

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 DateiGesperrte Konfiguration
com.apple.airplayAirPlay
com.apple.airprintAirPrint →
com.apple.applicationaccessRestriktionen →
com.apple.appstoreApp Store Restriktionen
com.apple.AssetCache.managedInhaltscaching
com.apple.desktopDesktop →
com.apple.dnsProxy.managedDNS Proxy
com.apple.dockDock
com.apple.domainsAdministrierte Domänen
com.apple.finderFinder-Einstellungen
com.apple.globalethernet.managedGlobale Ethernet-Einstellungen
.GlobalPreferencesGlobale Einstellungen
com.apple.MCXKonten und Stromspareinstellungen
com.apple.MCX.TimeMachineTime Machine
com.apple.mobiledevice.passwordpolicyPasswort
com.apple.notificationsettingsBenachrichtigungen
com.apple.preference.securitySicherheitseinstellungen
com.apple.proxy.http.globalGlobaler HTTP Proxy
com.apple.screensaverBildschirmschoner
com.apple.security.firewallFirewall
com.apple.SetupAssistant.managedSetup-Assistent
com.apple.SoftwareUpdateSystem-Updates
com.apple.syspolicy.kernel-extension-policyKernel-Erweiterungen →
com.apple.system-extension-policySystem-Erweiterungen
com.apple.SystemConfigurationProxies
com.apple.systempreferencesSystemeinstellungen
com.apple.universalaccessBarrierefreiheit
com.apple.vpn.managed.appmappingApp 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>

Wie hilfreich war dieser Artikel?