Sie sind bereits NinjaOne-Kunde? Melden Sie sich an, um weitere Leitfäden und die neuesten Updates zu sehen.

Apple MDM: Beispiele für benutzerdefinierte Nutzdaten

Thema

Dieser Artikel enthält Beispiele für benutzerdefinierte Payloads für NinjaOne Mobile Device Management (MDM)-Geräte, mit denen eine mobile Konfiguration zu einer NinjaOne-Richtlinie hinzugefügt und Einstellungen konfiguriert werden können, die in NinjaOne nicht direkt verfügbar sind.

Umgebung

  • NinjaOne Mobile Device Management (MDM)
  • Apple iOS
  • Apple iPadOS
  • Apple macOS

Beschreibung

Techniker mit den entsprechenden MDM-Berechtigungen können benutzerdefinierte Payloads für Apple-MDM-Geräte verwenden, um einer NinjaOne-Richtlinie eine mobile Konfiguration hinzuzufügen und Einstellungen zu konfigurieren, die nicht direkt in der NinjaOne-Benutzeroberfläche verfügbar sind.

Auswählen Sie eine Kategorie, um mehr zu erfahren:

Standardformat für mobile Konfigurationsdateien

Sie verwenden mobile Konfigurationsdateien, um benutzerdefinierte Payloads zu erstellen. In der Apple-Dokumentation sind die erforderlichen Top-Level-Schlüssel für diese Dateitypen definiert. Weitere Informationen finden Sie unter „TopLevel | Apple Developer Documentation“ (externer Link).

Das folgende Beispiel zeigt die erforderlichen Schlüssel und das Format für jede Apple-MDM-„mobileconfig“-Datei:

<DICT>
<KEY>PayloadContent</KEY>
<ARRAY>
…
</ARRAY>
<KEY>PayloadDisplayName</KEY>
<STRING>Profilname</STRING>
<KEY>PayloadIdentifier</KEY>
<STRING>Profile.2DE4CC74-A880-402D-A9CF-6665C87FE12E</STRING>
<KEY>PayloadUUID</KEY>
<STRING>2DE4CC74-A880-402D-A9CF-6665C87FE12E</STRING>
<KEY>PayloadType</KEY>
<STRING>Konfiguration</STRING>
<KEY>PayloadVersion</KEY>
<INTEGER>1</INTEGER>
</DICT>
</PLIST>

Diese Struktur enthält mehrere erforderliche Felder:

FeldBeschreibung
PayloadContentDieses Array aus Dictionaries definiert jede an das Gerät gesendete Konfigurations-Payload. Jede „mobileconfig“-Datei muss mindestens ein Payload-Dictionary enthalten, das innerhalb des „PayloadContent“-Arrays definiert ist.
PayloadDisplayNameDies ist der Name der Nutzdaten.
PayloadIdentifierDiese Kennung ist unter allen an jedes Gerät gesendeten MDM-Nutzdaten eindeutig. Üblicherweise wird das Format [Name].[UUID] verwendet. Wenn Sie versuchen, zwei Nutzdaten mit derselben Kennung auf einem Gerät zu installieren, schlägt die Installation der zweiten Nutzdaten in der Regel fehl.
PayloadUUID

Verwenden Sie eine Zeichenfolge im Format einer global eindeutigen Kennung (GUID), die unter allen an jedes Gerät gesendeten MDM-Payloads eindeutig ist. Unter macOS können Sie den folgenden Befehl im Terminal verwenden, um eine zufällige universell eindeutige Kennung (UUID) zu generieren.

uuidgen
PayloadTypeDies ist eine Zeichenfolge, die dem Typ der Payload entspricht. Dieses Feld sollte immer den Wert „Konfiguration“ enthalten oder mit einem der von Apple definierten Payload-Typen übereinstimmen.
PayloadVersionDies ist die Version der Nutzlast. Sie können eine Nutzlast aktualisieren, ohne dieses Feld zu erhöhen.
Nachdem Sie die benutzerdefinierte Nutzlast in einer Richtlinie definiert haben, können Sie die Werte für „PayloadIdentifier“ und „PayloadUUID“ nicht mehr ändern. Wenn Sie diese Werte ändern müssen, müssen Sie zunächst eine neue benutzerdefinierte Nutzlast definieren und die alte löschen.

Die Wörterbücher innerhalb des „PayloadContent“-Arrays weisen zudem eine sehr spezifische Struktur auf. Sie müssen in jedem Wörterbuch bestimmte Standardschlüssel sowie Schlüssel enthalten, die für jeden „PayloadType“ spezifisch sind. Weitere Informationen finden Sie in der Apple-Entwicklerdokumentation(Externer Link). Beziehen Sie sich auf den folgenden Code-Block, um die Standardschlüssel zu verwenden:

<PLIST version="1.0">
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         … {für den jeweiligen PayloadType spezifische Schlüssel} …
         <KEY>PayloadDisplayName</KEY>
         <STRING>Beschränkungen</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>Beschränkungen.63FBE224-B91A-4030-8D19-0D8D8883C4B7</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>63FBE224-B91A-4030-8D19-0D8D8883C4B7</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.applicationaccess</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Profilname</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Profile.2DE4CC74-A880-402D-A9CF-6665C87FE12E</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>2DE4CC74-A880-402D-A9CF-6665C87FE12E</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Sie müssen für jedes Wörterbuch innerhalb des „PayloadContent“-Arrays die folgenden Felder angeben:

FeldBeschreibung
PayloadDisplayNameDies ist der für Menschen lesbare Name der Profil-Nutzlast.
PayloadIdentifierDiese Kennung ist unter allen an jedes Gerät gesendeten MDM-Nutzdaten eindeutig. Üblicherweise wird das Format [Name].[UUID] verwendet. Wenn Sie versuchen, zwei Nutzdaten mit derselben Kennung auf einem Gerät zu installieren, schlägt die Installation der zweiten Nutzdaten in der Regel fehl.
PayloadUUID

Diese Zeichenfolge im GUID-Format sollte unter allen an jedes Gerät gesendeten MDM-Nutzdaten eindeutig sein. Unter macOS können Sie den folgenden Befehl im Terminal verwenden, um eine zufällige UUID zu generieren.

uuidgen
PayloadTypeDies ist eine Zeichenfolge, die dem Typ der Payload entspricht. Sie sollte immer den Wert „Configuration“ haben oder mit einem der von Apple definierten Payload-Typen übereinstimmen. Weitere Informationen zu den definierten Payload-Typen finden Sie unter „Profil-spezifische Payload-Schlüssel“ | Apple-Entwicklerdokumentation (Externer Link).
PayloadVersionDies ist die Payload-Version. Sie können eine Payload aktualisieren, ohne diesen Wert zu erhöhen.

NinjaOne unterstützt die folgenden Variablen für benutzerdefinierte Payloads. NinjaOne ersetzt die Variable automatisch durch die entsprechenden Informationen vom Gerät oder vom zugewiesenen Benutzer:

VariableBeschreibung
${device.location.name}Dies ist der Wert für den zugewiesenen Ortsnamen des Geräts.
${device.location.id}Dies ist der dem Gerät zugewiesene Wert für die Standort-ID.
${device.organization.name}Dies ist der Name der Organisation, zu der das Gerät gehört.
${device.organization.id}Dies ist die Organisations-ID des Geräts.
${device.serialNumber}Dies ist der Wert für die Seriennummer des Geräts.
${device.id}Dies ist die GUID des Geräts (eindeutige Kennung).
${device.owner.email}Dies ist die dem Gerät zugewiesene E-Mail-Adresse des Benutzers.
${device.owner.firstName}Dies ist der Vorname des dem Gerät zugewiesenen Benutzers.
${device.owner.lastName}Dies ist der Nachname des dem Gerät zugewiesenen Benutzers.
${device.owner.displayName}Dies ist der Anzeigename des dem Gerät zugewiesenen Benutzers.

Payloads für iOS, iPadOS und macOS

Benachrichtigungen

Mit der Nutzlast „Benachrichtigungen“ können Sie die Benachrichtigungseinstellungen für eine oder mehrere Anwendungen festlegen. Benutzer können diese Einstellungen nicht überschreiben. Weitere Informationen finden Sie unter „Benachrichtigungen“ | Apple-Entwicklerdokumentation(Externer Link).

Sie können die folgenden Schlüssel verändern, um das gewünschte Verhalten zu erzielen:

SchlüsselBeschreibung
NotificationSettingsDies ist ein Array aus Dictionaries, von denen jedes die Benachrichtigungseinstellungen einer einzelnen App definiert. Es enthält alle Schlüssel außerhalb der obersten Ebene. Sie können diesem Schlüssel bei Bedarf weitere Dictionaries hinzufügen, um alle gewünschten Anwendungen zu verwalten. Dieses Feld ist erforderlich.
BundleIdentifierDies ist die Bundle-ID einer einzelnen App, deren Benachrichtigungseinstellungen Sie verwalten. Dieses Feld ist erforderlich.
NotificationsEnabledDieses boolesche Feld gibt an, ob Benachrichtigungen für diese Anwendung eingeschaltet oder ausgeschaltet sind. Dieses Feld ist erforderlich.
AlertTypeStellen Sie den Wert auf 0 für „Kein(e)“, 1 für „Temporäres Banner“ und 2 für „Dauerhaftes Banner“ ein.
BadgesEnabledEinstellen, ob Badges aktiv sind.
CriticalAlertEnabledLegen Sie fest, ob kritische Warnungen die Einstellungen für „Nicht stören “ und den Klingelton überschreiben dürfen.
GroupingTypeStellen Sie den Wert auf 0 für automatische Gruppierung, auf 1, um Benachrichtigungen von dieser Anwendung in einer einzigen Gruppe zusammenzufassen, und auf 2, um Benachrichtigungen nicht zu gruppieren.
PreviewTypeStellen Sie den Wert auf 0, um Vorschauen immer anzuzeigen, auf 1, um Vorschauen nur bei ungesperrtem Gerät anzuzeigen, und auf 2, um Vorschauen niemals anzuzeigen.
ShowInCarPlayEinstellen, ob Benachrichtigungen in CarPlay eingeblendet werden sollen.
AufSperrbildschirmAnzeigenEinstellen, ob Benachrichtigungen auf dem Sperrbildschirm eingeblendet werden sollen.
ShowInNotificationCenterBenachrichtigungen im Benachrichtigungscenter einblenden.
SoundsEnabledAktivieren Sie Töne für Benachrichtigungen.
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>NotificationSettings</KEY>
         <ARRAY>
            <DICT>
               <KEY>BundleIdentifier</KEY>
               <STRING>com.ninjaone.assist</STRING>
               <KEY>NotificationsEnabled</KEY>
               <TRUE/>
               <KEY>AlertType</KEY>
               <GANZE Zahl>2</GANZE Zahl>
               <KEY>BadgesEnabled</KEY>
               <TRUE/>
               <KEY>CriticalAlertEnabled</KEY>
               <TRUE/>
               <KEY>GroupingType</KEY>
               <GANZE Zahl>2</GANZE Zahl>
               <KEY>PreviewType</KEY>
               <INTEGER>2</INTEGER>
               <KEY>ShowInCarPlay</KEY>
               <WAHR/>
               <KEY>ShowInLockScreen</KEY>
               <WAHR/>
               <KEY>ShowInNotificationCenter</KEY>
               <WAHR/>
               <KEY>SoundsEnabled</KEY>
               <WAHR/>
           </DICT>
           <DICT>
               <KEY>BundleIdentifier</KEY>
               <STRING>com.apple.tips</STRING>
               <KEY>NotificationsEnabled</KEY>
               <FALSCH/>
           </DICT>
        </ARRAY>
        <KEY>PayloadDisplayName</KEY>
        <STRING>Benachrichtigungen</STRING>
        <KEY>PayloadIdentifier</KEY>
        <STRING>Notifications.8E87A542-1AF1-4DBF-B1FE-645044C84C64</STRING>
        <KEY>PayloadUUID</KEY>
        <STRING>8E87A542-1AF1-4DBF-B1FE-645044C84C64</STRING>
        <KEY>PayloadType</KEY>
        <STRING>com.apple.notificationsettings</STRING>
        <KEY>PayloadVersion</KEY>
        <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Benachrichtigungen</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Notifications.C10A32DE-C782-4374-8D67-968EC168DD7A</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>C10A32DE-C782-4374-8D67-968EC168DD7A</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Zertifikate

Es gibt verschiedene Payloads, mit denen Sie Zertifikate auf ein Gerät übertragen können, beispielsweise die Payloads „CertificatePKCS12 “ oder „CertificatePKCS1 “.

Im Allgemeinen verwenden Sie die Payload „PKCS12“ für Zertifikate, die auch einen privaten Schlüssel enthalten (das Passwort für den Zugang zu dem privaten Schlüssel geben Sie innerhalb der Payload an), und die Payload „PKCS1“ für Zertifikate ohne privaten Schlüssel, vor allem um sicherzustellen, dass das Gerät den angegebenen Zertifikaten vertraut.

In diesem Abschnitt stellen wir Beispiele für die einzelnen Payloads vor.

PKCS1-Zertifikat

Verwenden Sie diese für Zertifikate, die keinen privaten Schlüssel enthalten. Beachten Sie den folgenden Schlüssel:

SchlüsselBeschreibung
PayloadContentDieser Schlüssel enthält die in Base64 konvertierte Zertifikatsdatei. Sie können diesen Schlüssel unter macOS mit dem Befehl ` base64 -i {Pfad_zur_Zertifikatsdatei}` generieren.
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>PayloadContent</KEY>
         <DATA>
         LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURFakNDQWZxZ0F3SUJBZ0lCQVRBTkJna3Foa2lHOXcwQkFRc0ZBREFuTVJnd0ZnWURWUVFEREE5VVpYTjAKUTJWeWRHbG1hV05oZEdVeEN6QUpCZ05WQkFZVEFsVlRNQjRYRFRJMU1ESXlNREU1TkRVd05Wb1hEVEkyTURJeQpNREU1TkRVd05Wb3dKekVZTUJZR0ExVUVBd3dQVkdWemRFTmxjblJwWm1sallYUmxNUXN3Q1FZRFZRUUdFd0pWClV6Q0NBU0l3RFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURDQ0FRb0NnZ0VCQU1KNHdJS1BBVXlWVXgyandtZUoKU0lSa0VCOUFLQXN3c2VhMnFMWUNTQlhlcmRxZE5SdDArdmdaQnN5T1lwUEY4TXQ0SEdXVVF3OVNEQ2pLQUl3MQovaFl5MDFrZDgrTUsvdnlXcExSNnhxTDZRQTBKajhnVlVid0JxbDBVanlCb3BabW1wMlZWbTlyYTNtRGpnNEFiCkttQkFIZjhldkJPRFBEZ3RaTm01Snk3MVBBelM3N3B3YjFINU4rUURJQy9uV1NLcTBSUjlNbXZZaTMzZUlJcngKT0hiZEN5dlBGMzEwd2Z1WUM1cGhxcU5oOGRLTUw3SnR2RXZVNHlzSzJoa0loTXYxQUhiM1ZIQisybEFWdjNnOQpoQ3FPbjVNd1VKMzNWNEZHWDN4OXhlVnZCSWlTK3F5MXFKSEdvZVJFbmVVZmN1Z2xUU2pNb1lwVUVSRU84QTMwCjJ3a0NBd0VBQWFOSk1FY3dEZ1lEVlIwUEFRSC9CQVFEQWdXZ01CWUdBMVVkSlFFQi93UU1NQW9HQ0NzR0FRVUYKQndNQk1CMEdBMVVkRGdRV0JCUWh3M3JDVTg2SmhPWWwrdDFrNlF6eXlFcmFDVEFOQmdrcWhraUc5dzBCQVFzRgpBQU9DQVFFQVNRM1dwVTdnZHZhMW05cXk4TFZOUlIralMzdHFBOE02T24rYXBNeTVkT0ZNQ3pjTWNhV2J2c2lSCmNCYVQxdXhxeFJMRmRBTUNtTWs1dW1vTGp1c3FJYjVCcVJlUzJFUVRmYm5MeThSV0lsSjM1K0VuUWNDRW9JWUcKWUhIWDY5ZWh2bFlITExaQ01BK21hTVhVYTlVNURMcy9WNG9UdWllVGZMeE0xOXlOT0dIS0VTbWl0QWNseFl3YgpMTUJoTGY1dmVXOW12ak9jc2lKblc0eWU3MVBtWG5oK2RhWFhoZzFJU0lHeEsyTkFvZFRzWFpRNm5iN200ZHNpCjdGVDRwcFFRcTllQWNJS1dSN3pTSVJMenZ6Wm8rSkRPeTltbVYyZVpYTjhIOFA2UVdlUTRoZmM0QW5RWGsxR1IKZmRGYzhKeUtSVktFcUM4UlE0WGR5UXE3RC9jZ2tBPT0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
         </DATA>
         <KEY>PayloadDisplayName</KEY>
         <STRING>CertificateP1</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>CertificateP1.95B82EE6-B86D-4F00-A152-7CE20F2E2CD4</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>95B82EE6-B86D-4F00-A152-7CE20F2E2CD4</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.security.pkcs1</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>CertificateP1</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>CertificateP1.33A95849-29DE-4F61-BBD5-D5D588B5D698</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>33A95849-29DE-4F61-BBD5-D5D588B5D698</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

PKCS12-Zertifikat

Verwenden Sie diese Payload für Zertifikate, die einen privaten Schlüssel enthalten und für deren Zugang ein bestimmtes Passwort erforderlich ist. Beachten Sie die folgenden Schlüssel:

SchlüsselBeschreibung
AllowAllAppsAccessWenn „true“, erlaubt das System Anwendungen den Zugang zum privaten Schlüssel.
KeyIsExtractableWenn „Wahr“, kann der Nutzer den privaten Schlüssel von dem Schlüsselbund extrahieren.
PasswortDies ist das Passwort, mit dem Sie auf den privaten Schlüssel des Zertifikats zugreifen.
PayloadContentDieser Schlüssel enthält die in Base64 konvertierte Zertifikatsdatei. Generieren Sie diese auf einem macOS-System mit dem Befehl „base64 -i {Pfad_zur_Zertifikatsdatei}“.
<PLIST version="Version 1">
<DICT>
   <KEY>PayloadContent</KEY>
   <DICT>
      <KEY>AllowAllAppsAccess</KEY>
      <TRUE />
      <KEY>KeyIsExtractable</KEY>
      <FALSE />
      <KEY>Password</KEY>
      <STRING>ninjaone</STRING>
      <KEY>PayloadContent</KEY>
      <DATA>
         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
         </DATA>
         <KEY>PayloadDisplayName</KEY>
         <STRING>CertificateP12</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>CertificateP12.D1351A32-C4B8-4B6E-B225-51E1CCB2AB8A</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>D1351A32-C4B8-4B6E-B225-51E1CCB2AB8A</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.security.pkcs12</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>CertificateP12</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>CertificateP12.5530D661-D71D-4D04-8A79-4CB0F516D8EE</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>5530D661-D71D-4D04-8A79-4CB0F516D8EE</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <GANZE Zahl>1</GANZE Zahl>
</DICT>
</PLIST>

Payloads für iOS und iPadOS

Lesen Sie die folgenden Unterabschnitte, um mehr über verschiedene benutzerdefinierte Payloads für iOS- und iPadOS-Geräte zu erfahren.

Kiosk-Modus (AppLock-Payload)

Verwenden Sie die AppLock-Payload, um ein Gerät auf eine einzige App zu beschränken. Stellen Sie sicher, dass Sie die App auch über die NinjaOne-Richtlinie auf dem Gerät bereitstellen, da das Gerät andernfalls in einem unbrauchbaren Zustand verharren könnte, bis die AppLock-Payload entfernt wird. Weitere Informationen finden Sie unter AppLock | Apple-Entwicklerdokumentation (Externer Link).

Es gibt folgende Schlüssel, die verändert werden können, um das gewünschte Verhalten zu erzielen:

SchlüsselBeschreibung
KennungDies ist die Bundle-ID der App, auf die Sie das Gerät sperren möchten. Stellen Sie sicher, dass die App auf dem Gerät bereitgestellt ist.
OptionenDies ist ein Wörterbuch mit Optionen, mit denen Sie verschiedene Hardware-Verhaltensweisen oder Barrierefreiheitsoptionen aktivieren oder deaktivieren können.
UserEnabledOptionsMithilfe der Barrierefreiheits-Abkürzung auf Ihrem Gerät (dreimaliges Drücken der Sperrtaste) können Sie dem Benutzer erlauben, bestimmte Barrierefreiheitseinstellungen zu verändern.
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>App</KEY>
         <DICT>
            <KEY>Identifier</KEY>
            <STRING>com.ninjaone.assist</STRING>
            <KEY>Optionen</KEY>
            <DICT>
               <KEY>DisableAutoLock</KEY>
               Falsch
               <KEY>DisableDeviceRotation</KEY>
               Falsch
               <KEY>DisableRingerSwitch</KEY>
               Falsch
               <KEY>DisableSleepWakeButton</KEY>
               Falsch
               <KEY>DisableTouch</KEY>
               <FALSCH />
               <KEY>DisableVolumeButtons</KEY>
               <FALSCH />
               <KEY>EnableAssistiveTouch</KEY>
               <FALSCH />
               <KEY>EnableInvertColors</KEY>
               <FALSCH />
               <KEY>EnableMonoAudio</KEY>
               <FALSCH />
               <KEY>Auswahl vorlesen aktivieren</KEY>
               Falsch
               <KEY>VoiceOver aktivieren</KEY>
               Falsch
               <KEY>Zoom aktivieren</KEY>
               Falsch
               <KEY>Sprachsteuerung aktivieren</KEY>
               Falsch
            </DICT>
            <KEY>UserEnabledOptions</KEY>
            <DICT>
               <KEY>AssistiveTouch</KEY>
               <FALSCH />
               <KEY>Farben invertieren</KEY>
               <FALSCH />
               <KEY>VoiceOver</KEY>
               <FALSCH />
               <KEY>Zoom</KEY>
               <FALSCH />
               <KEY>VoiceControl</KEY>
               <FALSCH />
            </DICT>
         </DICT>
         <KEY>PayloadIdentifier</KEY>
         <STRING>com.apple.app.lock.0EB94448-30BA-4CDC-BB8D-6321F60F608E</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>0EB94448-30BA-4CDC-BB8D-6321F60F608E</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.app.lock</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Kiosk</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Kiosk.3E0C188E-AC9E-4AAF-AF4B-943F980B6480</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>3E0C188E-AC9E-4AAF-AF4B-943F980B6480</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <GANZE Zahl>1</GANZE Zahl>
</DICT>
</PLIST>

Web-Clips

Mit der WebClip-Nutzlast können Sie Symbole auf dem Startbildschirm des Geräts hinzufügen, die direkt zu einer bestimmten Webseite führen. Weitere Informationen finden Sie unter WebClip | Apple-Entwicklerdokumentation (Externer Link).

Jedes Dictionary innerhalb des „PayloadContent“-Arrays konfiguriert einen einzelnen Web-Clip, Sie können jedoch mehrere Dictionaries definieren, um mehrere Web-Clips zu konfigurieren. Beachten Sie die folgenden Schlüssel, die Sie verändern können, um das gewünschte Verhalten zu erzielen:

SchlüsselBeschreibung
BezeichnungDies ist die Bezeichnung für das Icon, das auf dem Gerät angezeigt wird.
URLDies ist die genaue URL, zu der der Nutzer weitergeleitet wird, wenn er auf das Icon tippt.
IsRemovableMit diesem Schlüssel können Sie festlegen, ob der Nutzer das Icon von der Startseite entfernen kann.
FullScreenMit diesem Schlüssel können Sie festlegen, ob die Webseite im Vollbild-Modus angezeigt werden soll oder ob das Browser-Navigationsmenü sichtbar sein soll.
TargetApplicationBundleIdentifierMit diesem optionalen Schlüssel können Sie die Bundle-ID eines Browsers angeben, der zum Start des Webclips verwendet werden soll. Wenn dieser Schlüssel nicht angegeben wird, verwendet das Gerät den Standardbrowser.
Icon

Dies ist eine Base64-kodierte Zeichenfolge, die den Inhalt einer Bilddatei enthält, die als Symbol verwendet werden soll. Ist sie nicht angegeben, verwendet das Gerät ein standardmäßiges „leeres“ Symbol. Unter macOS können Sie diese Zeichenfolge mit dem folgenden Befehl im Terminal generieren:

base64 -i {Pfad_zum_Symbol}
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>Bezeichnung</KEY>
         <STRING>N1</STRING>
         <KEY>URL</KEY>
         <STRING>https://www.ninjaone.com</STRING>
         <KEY>IsRemovable</KEY>
         <FALSE />
         <KEY>FullScreen</KEY>
         <TRUE />
         <KEY>Icon</KEY>
         <DATA>
         iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAYAAAD0eNT6AAAACXBIWXMAACxKAAAsSgF3enRNAAARPklEQVR4nO3dv2tdZ57H8e8ZZTQoXGExAmOBF4ddZFiYxqqmknurmi3GaXabpErlNDNNXLnabSbNTJU0W8XNbuX08R8gN4EBmyxjJiAj8ODgy5iIEWeLE41/jOxYV1f3nHs/rxeI2EpiPxLYz/s8z3nOaX76y1+3BQBE+UnfAwAAZk8AAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAwNvYWO57BABT9U7fA4BB216r9v3zVVXVfHS/58EATI8AgOPsrFf74UbVhR+u/O+N+x0PwJQJADgyWuom/vfPP5/4ARaUAIDRUjfpXz/fRQBAAAFAro3laq+fr9pZN/H/mK3V5z/eXKl29ZXv18Zy1cbPjv9/976v2jt46VPN08OqB8+ef2L36ZQGCrwtAUCejeVuf//aet8jGY7NlarVd6rdGnUxdPnd7p+bK6f/ta+M/uFT7ev+2wfPqsaHVff/WjU+rGZ3XPX0by/HAjAVAoAcW6vV7vzcxL+12l3FX16p2nx3OpP8tByN5YdoaD944d/dG1ftfV/N/WfdioEogFMRACy+rdXuiv+YK9GFN1rqvv6tUXdVP8/fgyujqiujaq+98Ll746rdp91KgW0EOBEBwOLaWe/2+Id0hTsLmyvVXl2r2l5b/K/9KAo+qG7rYHdczd0nXQy8ct8B8DIBwOJ59Qx/gu21aq+e6yb91BsaR0tV2+eq3T7X/fzBs2ruPK66+0QMwDEEAIvh6CjfznrOxH90T0PypP8mmyvV3rhYdeNiFwO396u+etKtFADV/PSXv37tDbkweLM6w39vPIxHAW8sV7uznhU60/bl42ru/MU9A8SzAsB8SjvKt7Xa3c9wtLzN5K6tV3tt/fmqwJ3HfY8IeiEAmC9pE3/i/QyzsrlS7SeXqj7cqOaLH0LA9gBBBADzIekon0cTz9aF5e5egQ83qm7vdzEgBAggABg2Ez+zMlqq+mCj2p31aj7bszXAwhMADFPa0vf1893Xa+Lv34Xl51sDtx66WZCFJQAYjtFS1dW1rIl/e63ajy/mfL3z5MJytb/frLr7XTWf/tmzBFg4AoD+JS59b65U+/E/ZWxtzLvtc9Vujbptgdv7fY8GpkYA0J+jM+1JE/9R7Hyw0fdIOInRUnej4M56Nbf+5EVELAQBwOylHeU7srVa7c1Llvvn2eZKtf/9r9V8+q3VAOaeAGB2Ul/HO1rqguf6+b5HwpS0Ny5WXV2r5jffODLI3BIAnL2ko3yv2lyp9r/+xVX/IroyqvZ/f1HNb//PSQHmkgDg7Oysd3v8iRN/VXe078bFvkfBWRotVfv7TVsCzCUBwPSlneF/1Wip2pvveW5/kPbGxarLK9X87ltbAswNAcB0jJa6if/987kTf1W35H/zvarNlb5HwqxdW692893urZEigDkgADidxDP8r7O1Wu1//rPvQ7LNle6+gI/uOyrI4AkAJnN0lG97zYRX1a1+fHKp71EwBKOlav9wWQQweAKAk0k9w/8G7Y2LjvjxsqMIuPWw6u6TvkcDx/pJ3wNgjuysV/s/vzD5v6C9ecnkz/FGS92W0I4/LwyTAOCttRvBN/cdo715SQzxo9pPLokABkkAwARM/pyECGCIBACckMmfSbSfXHI8lEERAHACJn9Oo/3DZRHAYAgAeEsmf05ttNS9G8LRWQZAAMDb2Fwx+TMdF5a7lQDomQCAt+GKjWnaXPGiKHonAAD6cP189yRN6IkAAOhJe/NSledr0BMBANCXo1dHQw8EAECfrow8TppeCACAnrUfbtgKYOYEAEDfbAXQAwEAMARXRk4FMFMCAGAg2o8veuYEMyMAAIbiwnK177shkNkQAABDcv28VQBmQgAADMloqdsKgDMmAACG5tq6Y4GcOQEAMEDthxt9D4EFJwAAhsgqAGdMAAAMlFUAzpIAABiq7TUnAjgzAgBgqEZLngvAmREAAEO2s973CFhQAgBgyC4siwDOhAAAGLhWAHAGBADA0F0ZORLI1AkAgDlgFYBpEwAA80AAMGUCAGAeXFiu2lrtexQsEAEAMCfanZ/3PQQWiAAAmBfba32PgAUiAICq8WHVvXH38eBZ36PhdUZLIoCpeafvAQBn6NFB1d5B1e7Tap4ePp/cd5+e7NfZXKlafadqY7najR/2ojeWu31pZqq9eq6au0/6HgYLQADAIrk37ib73fHJJ/k3eWFVoKmqqr3uJ6Olqq3VardGXRRsrkzv9+R4bgRkSgQAzLNHB1VfPekm/D6uCseHVXefPL8i3Viu2l7rzqyLgbNxYbn73tqq4ZQEAMyjLx9X89V3/Uz6b7J3UHV7v5rb+912wfXz3fl1r7SdqvbqWjUCgFMSADAvHh1U3XlczRf73ZX30O0dVPPpt1Wf7XWvtL1+XghMy/Za1Wd7fY+COScAYOgeHVTz2V7Vncd9j2Qy48Nu/F/sdyHwwUbfI5p/mytdTM1DCDJYjgHCUI0Pqz7fq+ZXX8/v5P+iH0Kg+bevu5sVOR03A3JKAgCG6MvH1fzq6+7KedHsHVTz0f1ue8AV7MTaq+f6HgJzzhYADMmjg2puPZzuEb6hur1fze7Tam++58TAJKwAcEpWAGAo7n5Xzb//MWPyP/LgWTUf3bclMIkLy26q5FQEAAxA8+m31fz2m8wl8fFhFwFfLsB9DrNmFYBTEADQp/FhNf/xx6rb+32PpHfNrYci4ITarVHfQ2COCQDoy9Hytwe6/J0IOKHL7/Y9AuaYAIA+mPxfq7n10PflbV2xAsDkBADM2tHkn7jf/5aaj+53Tz7kxzlBwYQEAMySyf/tjA+r+c03fY9iPtgGYEICAGbl6G53k//befCse1gQb9RaAWBCAgBmweQ/mdv7nhHwY6wAMCEBADPQfPqtG9sm1Nz6U99DGDYrAExIAMBZu72/GC/z6cveQdXnC/hOhGkZLVVtLPc9CuaQAICzZB97Kpov9m2fvMnGz/oeAXNIAMAZsnw9JeNDIfUmtgGYgACAs/L5nn3/abrz2CrAa7S2AJiAAICz8Oigms/sW0+ddyYcz0kAJiAA4Aw0tx72PYSF1HwhAI5lBYAJCACYtnvjqt2nfY9iMY0PvSzoOBcEACcnAGDKLP2frebOX/oewjBZBeCEBABMk6v/s7f71IuCjuMoICckAGCKXP3PyFdP+h7B8IyW+h4Bc0YAwLQ8eObqf0YaT1b8B+1lzwLgZAQATEnjiNrsPHhmGwBOSQDANIwPPe9/1qy2vGxrte8RMGcEAEzDXXvSs9bsek0wnIYAgCnwgJoeWAGAUxEAcFqPDjzzvw97B+4DeNGVUd8jYM4IADgtR9L6YxUAJiYA4JSau9/1PYRYzX0rLzApAQCnMT50FdonWy8v8zhgTkAAwGm4E71f9//a9wiGxeOAOQEBAKfQuPrv1/iw+wBOTADAaQiA/tkGgIkIAJjU+NDkMwR73/c9AphLAgAmZfIfhj3PAvg7bwTkBAQATMry/yA0T90DcMQbATkJAQATcgZ9IKzEwEQEAEzK3jMwxwQATMqV5zB4FgBMRADAJEz+w+E5ADARAQCTMOkAc04AwCQsOwNzTgDAJKwADMsjzwKAkxIAMAFHAAfGw4DgxAQATMIKADDnBAAABBIAMAmPAQbmnAAAgEACAAACCQAACCQA4KQ8BhhYAAIATsoRQGABCAAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAgkAAAgEACAAACCQAACCQAACCQAACAQAIAAAIJAAAIJAAAIJAAAIBAAgAAAgkAAAgkAAAg0Dt9D4D50dx5XLU77nsY/Xv6t75HwCua3/25atVfZ7X3fd8jYI74E8Pb2zvoPmBoHjzrewQwd2wBAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAEAgAQAAgQQAAAQSAAAQSAAAQCABAACBBAAABBIAABBIAABAIAEAAIEEAAAEEgAAEEgAAECg/wdsqOIF108fkQAAAABJRU5ErkJggg==
         </DATA>
         <KEY>PayloadDisplayName</KEY>
         <STRING>N1</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>N1.E935A83C-30E0-4F4F-A04B-6CF1B900714D</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>E935A83C-30E0-4F4F-A04B-6CF1B900714D</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.webClip.verwaltet</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
      <DICT>
         <KEY>Bezeichnung</KEY>
         <STRING>Apple</STRING>
         <KEY>URL</KEY>
         <STRING>https://www.apple.com</STRING>
         <KEY>IsRemovable</KEY>
         <FALSE />
         <KEY>FullScreen</KEY>
         <TRUE />
         <KEY>TargetApplicationBundleIdentifier</KEY>
         <STRING>com.apple.mobilesafari</STRING>
         <KEY>Icon</KEY>
         <DATA>
         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
         </DATA>
         <KEY>PayloadDisplayName</KEY>
         <STRING>Apple</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>Apple.D06CCEE5-DD8A-4E00-B6C4-D8F8C64F54E2</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>D06CCEE5-DD8A-4E00-B6C4-D8F8C64F54E2</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.webClip.verwaltet</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>WebClips</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>WebClips.013CE3FD-8844-4334-9506-2EF8693E6C56</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>013CE3FD-8844-4334-9506-2EF8693E6C56</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Browser-Erlaubt-Liste

Mit der „WebContentFilter“-Payload können Sie eine Erlaubt-Liste definieren, die alle Websites enthält, auf die über einen Internetbrowser zugegriffen werden kann. Im nativen Safari-Browser werden diese Websites außerdem in den Favoriten angezeigt. Wenn Sie eine Domain zulassen, sind die Subdomains und Unterseiten standardmäßig zugänglich. Weitere Informationen finden Sie unter „WebContentFilter | Apple Developer Dokumentation“ (externer Link).

Es gibt folgende Schlüssel, die Sie verändern können, um das gewünschte Verhalten zu erzielen:

SchlüsselBeschreibung
FilterTypeEinstellen Sie diesen Schlüssel immer auf „BuiltIn“.
Erlaubt-ListeDies ist ein Array aus Dictionaries, von denen jedes eine Webseite angibt, auf die das Gerät über den Internetbrowser zugreifen kann. Jedes Dictionary enthält einen Titel (der für die Registerkarte „Favoriten“ in Safari verwendet wird) und die eigentliche URL. Sie können Subdomains für die URL angeben, dies ist jedoch nicht erforderlich. Sie können nach Bedarf weitere Dictionaries hinzufügen.
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>FilterType</KEY>
         <STRING>BuiltIn</STRING>
         <KEY>AllowListBookmarks</KEY>
         <ARRAY>
            <DICT>
               <KEY>Title</KEY>
               <STRING>NinjaOne</STRING>
               <KEY>URL</KEY>
               <STRING>ninjaone.com</STRING>
            </DICT>
            <DICT>
               <KEY>Titel</KEY>
               <STRING>Apple</STRING>
               <KEY>URL</KEY>
               <STRING>apple.com</STRING>
            </DICT>
         </ARRAY>
         <KEY>PayloadDisplayName</KEY>
         <STRING>Erlaubt-Liste</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>Erlaubt-Liste.8ADB4E90-A490-4C8E-BBFE-0DE3BD923923</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>8ADB4E90-A490-4C8E-BBFE-0DE3BD923923</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.webcontent-filter</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Erlaubt-Liste</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Erlaubt-Liste.129BBAA6-40E8-46E2-92BF-0CDABAD54BA6</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>129BBAA6-40E8-46E2-92BF-0CDABAD54BA6</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Browser-Blockiert-Liste

Mit der „WebContentFilter“-Payload können Sie eine Sperrliste definieren, die alle Websites enthält, auf die über einen Browser nicht zugegriffen werden kann. Wenn Sie eine Domain blockieren, werden auch deren Subdomains verweigert. Mehr erfahren Sie unter „WebContentFilter | Apple Developer Dokumentation“ (Externer Link).

SchlüsselBeschreibung
FilterTypeEinstellen Sie diesen Schlüssel immer auf „BuiltIn“.
DenyListURLsDies ist ein Array aus Zeichenfolgen, von denen jede eine Webseite angibt, auf die das Gerät über den Browser nicht zugreifen darf. Optional können Sie Subdomains für die URL angeben. Fügen Sie nach Bedarf Zeichenfolgen hinzu.
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>FilterType</KEY>
         <STRING>BuiltIn</STRING>
         <KEY>DenyListURLs</KEY>
         <ARRAY>
            <STRING>facebook.com</STRING>
            <STRING>reddit.com</STRING>
         </ARRAY>
         <KEY>PayloadDisplayName</KEY>
         <STRING>Denylist</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>DenyList.3CF8F060-E776-4950-8B64-2A6080BBB694</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>3CF8F060-E776-4950-8B64-2A6080BBB694</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.webcontent-filter</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Denylist</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Denylist.C72D246D-F2D6-4D41-B83D-592D195B7A79</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>C72D246D-F2D6-4D41-B83D-592D195B7A79</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

E-Mail-Konfiguration

Mit der „ExchangeActiveSync“-Nutzlast können Sie die native E-Mail-App auf einem Gerät so konfigurieren, dass sie eine Verbindung zu einem Exchange ActiveSync (EAS)-Konto für E-Mails herstellt. Der Benutzer muss sich zunächst beim EAS-Konto authentifizieren, bevor Daten synchronisiert werden. Weitere Informationen finden Sie unter „ExchangeActiveSync | Apple Developer Documentation“ (externer Link).

Für diesen Payload gibt es mehrere konfigurierbare Optionen, beachten Sie jedoch insbesondere die folgenden Schlüssel:

SchlüsselBeschreibung
PayloadDisplayNameDies ist der Account Name, der auf dem Gerät angezeigt wird.
HostDies ist der Hostname oder die IP-Adresse des Exchange-Servers. Für Office 365 verwenden Sie outlook.office365.com.
E-Mail-AdresseDies ist die E-Mail-Adresse des Benutzers. Wenn Sie die Variable ${device.owner.email} verwenden, füllt NinjaOne dieses Feld automatisch mit der E-Mail-Adresse des in NinjaOne angegebenen Geräteeigentümers aus. Wenn Sie diese Option nutzen, stellen Sie sicher, dass dem Gerät ein Benutzer zugewiesen ist. Informationen dazu, wie Sie einem Benutzer ein Gerät zuweisen, finden Sie unter „NinjaOne Endpunkt-Management: Zugewiesener Benutzer“.
BenutzernameDies ist der Benutzername des Geräteeigentümers. Wenn Sie die Variable ${device.owner.email} verwenden, füllt NinjaOne dieses Feld automatisch mit der in NinjaOne angegebenen E-Mail-Adresse des Geräteeigentümers aus. Wenn Sie diese Variable verwenden, stellen Sie sicher, dass dem Gerät ein zugewiesener Benutzer zugewiesen ist.
OAuthMit diesem Schlüssel können Sie festlegen, ob die Konfiguration OAuth für die föderierte Authentifizierung verwendet.
MailNumberOfPastDaysToSyncMit diesem Schlüssel können Sie festlegen, wie viele Tage an E-Mails bei der Ersteinrichtung des Kontos synchronisiert werden sollen.
SSLErzwingt die Verwendung von Secure Socket Layer (SSL) für die Verbindung.
PreventMoveMit diesem Schlüssel können Sie festlegen, ob Nutzer Nachrichten von diesem Konto in ein anderes Konto verschieben dürfen.
AppSheet-SperreMit diesem Schlüssel können Sie festlegen, ob Geräteeigentümer zum Versenden von E-Mails eine andere Anwendung als Apple Mail verwenden dürfen.
EnableCalendarsLegen Sie fest, ob Kalender synchronisiert werden sollen.
EnableCalendarsUserOverridableMit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableCalendars“ verändern darf.
EnableContactsLegen Sie fest, ob Kontakte synchronisiert werden sollen.
EnableContactsUserOverridableMit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableCalendars“ verändern darf.
EnableMailLegen Sie fest, ob E-Mails synchronisiert werden sollen.
EnableMailUserOverridableMit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableMail“ verändern darf.
EnableNotesLegen Sie fest, ob die Anmerkungen-App synchronisiert werden soll.
EnableNotesUserOverridableMit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableNotes“ verändern darf.
EnableRemindersLegen Sie fest, ob die „Reminders“-Anwendung synchronisiert werden soll.
EnableRemindersUserOverridableMit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableReminders“ verändern darf.
<PLIST version="Version 1">
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>PayloadDisplayName</KEY>
         <STRING>Firmen-E-Mail</STRING>
         <KEY>Host</KEY>
         <STRING>outlook.office365.com</STRING>
         <KEY>EmailAddress</KEY>
         <STRING>${device.owner.email}</STRING>
         <KEY>Benutzername</KEY>
         <STRING>${device.owner.email}</STRING>
         <KEY>OAuth</KEY>
         <TRUE/>
         <KEY>MailNumberOfPastDaysToSync</KEY>
         <INTEGER>7</INTEGER>
         <KEY>SSL</KEY>
         <TRUE/>
         <KEY>PreventMove</KEY>
         <TRUE />
         <KEY>AppSheet verhindern</KEY>
         <WAHR />
         <KEY>Kalender aktivieren</KEY>
         <WAHR/>
         <KEY>Kalender vom Benutzer überschreibbar machen</KEY>
         <FALSCH/>
         <KEY>Kontakte aktivieren</KEY>
         <WAHR/>
         <KEY>Kontakte vom Benutzer überschreibbar machen</KEY>
         <FALSCH/>
         <KEY>EnableMail</KEY>
         <WAHR/>
         <KEY>EnableMailUserOverridable</KEY>
         <FALSCH/>
         <KEY>EnableNotes</KEY>
         <WAHR/>
         <KEY>EnableNotesUserOverridable</KEY>
         <FALSCH/>
         <KEY>EnableReminders</KEY>
         <WAHR/>
         <KEY>EnableRemindersUserOverridable</KEY>
         <FALSCH/>
         <KEY>PayloadIdentifier</KEY>
         <STRING>com.apple.eas.account.9B232C94-3E0A-4E4B-BF88-64370E3BA105</STRING>
         <KEY>PayloadUUID</KEY>
         <STRING>9B232C94-3E0A-4E4B-BF88-64370E3BA105</STRING>
         <KEY>PayloadType</KEY>
         <STRING>com.apple.eas.account</STRING>
         <KEY>PayloadVersion</KEY>
         <GANZE Zahl>1</GANZE Zahl>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Firmen-E-Mail</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Firmen-E-Mail.158FBE77-8888-4578-A443-DBF46AD4C937</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Konfiguration</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>158FBE77-8888-4578-A443-DBF46AD4C937</STRING>
   <KEY>PayloadVersion</KEY>
   <GANZE Zahl>1</GANZE Zahl>
</DICT>
</PLIST>

Zusätzliche Ressourcen

Um mehr über Apple MDM in NinjaOne zu erfahren, besuchen Sie „NinjaOne MDM: Ressourcenkatalog “.

FAQ

Nächste Schritte