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:

Feld Beschreibung
PayloadContent Dieses 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.
PayloadDisplayName Dies ist der Name der Nutzdaten.
PayloadIdentifier Diese 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
PayloadType Dies 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.
PayloadVersion Dies 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:

Feld Beschreibung
PayloadDisplayName Dies ist der für Menschen lesbare Name der Profil-Nutzlast.
PayloadIdentifier Diese 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
PayloadType Dies 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).
PayloadVersion Dies 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:

Variable Beschreibung
${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üssel Beschreibung
NotificationSettings Dies 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.
BundleIdentifier Dies ist die Bundle-ID einer einzelnen App, deren Benachrichtigungseinstellungen Sie verwalten. Dieses Feld ist erforderlich.
NotificationsEnabled Dieses boolesche Feld gibt an, ob Benachrichtigungen für diese Anwendung eingeschaltet oder ausgeschaltet sind. Dieses Feld ist erforderlich.
AlertType Stellen Sie den Wert auf 0 für „Kein(e)“, 1 für „Temporäres Banner“ und 2 für „Dauerhaftes Banner“ ein.
BadgesEnabled Einstellen, ob Badges aktiv sind.
CriticalAlertEnabled Legen Sie fest, ob kritische Warnungen die Einstellungen für „Nicht stören “ und den Klingelton überschreiben dürfen.
GroupingType Stellen 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.
PreviewType Stellen 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.
ShowInCarPlay Einstellen, ob Benachrichtigungen in CarPlay eingeblendet werden sollen.
AufSperrbildschirmAnzeigen Einstellen, ob Benachrichtigungen auf dem Sperrbildschirm eingeblendet werden sollen.
ShowInNotificationCenter Benachrichtigungen im Benachrichtigungscenter einblenden.
SoundsEnabled Aktivieren 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üssel Beschreibung
PayloadContent Dieser 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üssel Beschreibung
AllowAllAppsAccess Wenn „true“, erlaubt das System Anwendungen den Zugang zum privaten Schlüssel.
KeyIsExtractable Wenn „Wahr“, kann der Nutzer den privaten Schlüssel von dem Schlüsselbund extrahieren.
Passwort Dies ist das Passwort, mit dem Sie auf den privaten Schlüssel des Zertifikats zugreifen.
PayloadContent Dieser 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üssel Beschreibung
Kennung Dies 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.
Optionen Dies ist ein Wörterbuch mit Optionen, mit denen Sie verschiedene Hardware-Verhaltensweisen oder Barrierefreiheitsoptionen aktivieren oder deaktivieren können.
UserEnabledOptions Mithilfe 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üssel Beschreibung
Bezeichnung Dies ist die Bezeichnung für das Icon, das auf dem Gerät angezeigt wird.
URL Dies ist die genaue URL, zu der der Nutzer weitergeleitet wird, wenn er auf das Icon tippt.
IsRemovable Mit diesem Schlüssel können Sie festlegen, ob der Nutzer das Icon von der Startseite entfernen kann.
FullScreen Mit diesem Schlüssel können Sie festlegen, ob die Webseite im Vollbild-Modus angezeigt werden soll oder ob das Browser-Navigationsmenü sichtbar sein soll.
TargetApplicationBundleIdentifier Mit 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>
         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
         </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üssel Beschreibung
FilterType Einstellen Sie diesen Schlüssel immer auf „BuiltIn“.
Erlaubt-Liste Dies 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üssel Beschreibung
FilterType Einstellen Sie diesen Schlüssel immer auf „BuiltIn“.
DenyListURLs Dies 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üssel Beschreibung
PayloadDisplayName Dies ist der Account Name, der auf dem Gerät angezeigt wird.
Host Dies ist der Hostname oder die IP-Adresse des Exchange-Servers. Für Office 365 verwenden Sie outlook.office365.com.
E-Mail-Adresse Dies 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“.
Benutzername Dies 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.
OAuth Mit diesem Schlüssel können Sie festlegen, ob die Konfiguration OAuth für die föderierte Authentifizierung verwendet.
MailNumberOfPastDaysToSync Mit diesem Schlüssel können Sie festlegen, wie viele Tage an E-Mails bei der Ersteinrichtung des Kontos synchronisiert werden sollen.
SSL Erzwingt die Verwendung von Secure Socket Layer (SSL) für die Verbindung.
PreventMove Mit diesem Schlüssel können Sie festlegen, ob Nutzer Nachrichten von diesem Konto in ein anderes Konto verschieben dürfen.
AppSheet-Sperre Mit 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.
EnableCalendars Legen Sie fest, ob Kalender synchronisiert werden sollen.
EnableCalendarsUserOverridable Mit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableCalendars“ verändern darf.
EnableContacts Legen Sie fest, ob Kontakte synchronisiert werden sollen.
EnableContactsUserOverridable Mit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableCalendars“ verändern darf.
EnableMail Legen Sie fest, ob E-Mails synchronisiert werden sollen.
EnableMailUserOverridable Mit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableMail“ verändern darf.
EnableNotes Legen Sie fest, ob die Anmerkungen-App synchronisiert werden soll.
EnableNotesUserOverridable Mit diesem Schlüssel können Sie festlegen, ob der Nutzer die Einstellung „EnableNotes“ verändern darf.
EnableReminders Legen Sie fest, ob die „Reminders“-Anwendung synchronisiert werden soll.
EnableRemindersUserOverridable Mit 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