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.
Wählen Sie eine Kategorie aus, um mehr zu erfahren:
- Standardformat für mobile Konfigurationsdateien
- Payloads für iOS, iPadOS und macOS
- Zertifikate
- Payloads für iOS und iPadOS
- Weitere Ressourcen
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:
<plist version="1.0">
<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 Pflichtfelder:
| 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 im „PayloadContent“-Array 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. |
| PayloadType | Dies ist eine Zeichenfolge, die dem Typ der Payload entspricht. Dieses Feld sollte immer den Wert „Configuration“ enthalten oder mit einem der von Apple definierten Payload-Typen übereinstimmen. |
| PayloadVersion | Dies ist die Payload-Version. Sie können eine Payload aktualisieren, ohne diesen Wert zu erhöhen. |
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). Im folgenden Codeblock sehen Sie die Verwendung der Standardschlüssel:
<plist version="1.0">
<dict>
<key>PayloadContent</key>
<array>
<dict>
… {für den jeweiligen PayloadType spezifische Schlüssel} …
<key>PayloadDisplayName</key>
<string>Restriction</string>
<key>PayloadIdentifier</key>
<string>Restriction.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>
<integer>1</integer>
</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 ein 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. |
| 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 „Profilspezifische 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 Standortnamen des Geräts. |
| ${device.location.id} | Dies ist der dem Gerät zugewiesene Standort-ID-Wert. |
| ${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 Payload „Benachrichtigungen“ können Sie die Benachrichtigungseinstellungen für eine oder mehrere Apps 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 anpassen, 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 Apps zu verwalten. Dieses Feld ist erforderlich. |
| BundleIdentifier | Dies ist die Bundle-ID einer einzelnen App, deren Benachrichtigungseinstellungen Sie verwalten. Dieses Feld ist ein Pflichtfeld. |
| NotificationsEnabled | Dieses boolesche Feld gibt an, ob Benachrichtigungen für diese App aktiviert oder deaktiviert sind. Dieses Feld ist ein Pflichtfeld. |
| AlertType | Setzen Sie den Wert auf 0 für „Keine“, auf 1 für „Temporäres Banner“ und auf 2 für „Dauerhaftes Banner“. |
| BadgesEnabled | Legen Sie fest, ob Badges aktiv sind. |
| CriticalAlertEnabled | Legen Sie fest, ob kritische Benachrichtigungen die Einstellungen für „Nicht stören “ und den Klingelton außer Kraft setzen dürfen. |
| GroupingType | Stellen Sie den Wert auf 0 für automatische Gruppierung, auf 1, um Benachrichtigungen dieser App in einer einzigen Gruppe zusammenzufassen, und auf 2, um Benachrichtigungen nicht zu gruppieren. |
| PreviewType | Stellen Sie den Wert auf 0 ein, um Vorschauen immer anzuzeigen, auf 1, um Vorschauen nur anzuzeigen, wenn das Gerät entsperrt ist, und auf 2, um Vorschauen nie anzuzeigen. |
| ShowInCarPlay | Legen Sie fest, ob Benachrichtigungen in CarPlay angezeigt werden sollen. |
| AufSperrbildschirmAnzeigen | Legen Sie fest, ob Benachrichtigungen auf dem Sperrbildschirm angezeigt werden sollen. |
| ShowInNotificationCenter | Benachrichtigungen im Benachrichtigungscenter anzeigen. |
| SoundsEnabled | Aktivieren Sie Töne für Benachrichtigungen. |
<plist version="1.0">
<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>
<integer>2</integer>
<key>BadgesEnabled</key>
<true/>
<key>CriticalAlertEnabled</key>
<true/>
<key>GroupingType</key>
<integer>2</integer>
<key>PreviewType</key>
<integer>2</integer>
<key>ShowInCarPlay</key>
<true/>
<key>ShowInLockScreen</key>
<true/>
<key>ShowInNotificationCenter</key>
<true/>
<key>SoundsEnabled</key>
<true/>
</dict>
<dict>
<key>BundleIdentifier</key>
<string>com.apple.tips</string>
<key>NotificationsEnabled</key>
<false/>
</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>
<integer>1</integer>
</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 Zugriff auf den 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. |
<plist version="1.0">
<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>
<integer>1</integer>
</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>Configuration</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 Zugriff ein bestimmtes Passwort erforderlich ist. Beachten Sie die folgenden Schlüssel:
| Schlüssel | Beschreibung |
|---|---|
| AllowAllAppsAccess | Wenn „true“, erlaubt das System Apps den Zugriff auf den privaten Schlüssel. |
| KeyIsExtractable | Wenn „true“, kann der Benutzer den privaten Schlüssel aus 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. Erstellen Sie diese auf einem macOS-System mit dem Befehl `base64 -i {Pfad_zur_Zertifikatsdatei}`. |
<plist version="1.0">
<dict>
<key>PayloadContent</key>
<array>
<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>
<integer>1</integer>
</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>Configuration</string>
<key>PayloadVersion</key>
<integer>1</integer>
</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 in der NinjaOne-Richtlinie auf dem Gerät bereitstellen, da das Gerät andernfalls in einem unbrauchbaren Zustand verbleiben könnte, bis die AppLock-Payload entfernt wird. Weitere Informationen finden Sie unter AppLock | Apple-Entwicklerdokumentation (externer Link).
Beachten Sie die folgenden Schlüssel, die angepasst 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 beschränken 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-Schnellfunktion auf Ihrem Gerät (dreimaliges Drücken der Sperrtaste) können Sie dem Benutzer erlauben, bestimmte Barrierefreiheitseinstellungen zu ändern. |
<plist version="1.0">
<dict>
<key>PayloadContent</key>
<array>
<dict>
<key>App</key>
<dict>
<key>Identifier</key>
<string>com.ninjaone.assist</string>
<key>Options</key>
<dict>
<key>DisableAutoLock</key>
<false />
<key>DisableDeviceRotation</key>
<false />
<key>DisableRingerSwitch</key>
<false />
<key>DisableSleepWakeButton</key>
<false />
<key>DisableTouch</key>
<false />
<key>DisableVolumeButtons</key>
<false />
<key>EnableAssistiveTouch</key>
<false />
<key>EnableInvertColors</key>
<false />
<key>EnableMonoAudio</key>
<false />
<key>Auswahl vorlesen aktivieren</key>
<false />
<key>VoiceOver aktivieren</key>
<false />
<key>Zoom aktivieren</key>
<false />
<key>Sprachsteuerung aktivieren</key>
<false />
</dict>
<key>UserEnabledOptions</key>
<dict>
<key>AssistiveTouch</key>
<false />
<key>InvertColors</key>
<false />
<key>VoiceOver</key>
<false />
<key>Zoom</key>
<false />
<key>VoiceControl</key>
<false />
</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>
<integer>1</integer>
</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>
<integer>1</integer>
</dict>
</plist>Web-Clips
Mit der WebClip-Nutzlast können Sie dem Startbildschirm des Geräts Symbole 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 anpassen können, um das gewünschte Verhalten zu erzielen:
| Schlüssel | Beschreibung |
|---|---|
| Label | Dies ist die Bezeichnung für das Symbol, das auf dem Gerät angezeigt wird. |
| URL | Dies ist die genaue URL, zu der der Benutzer weitergeleitet wird, wenn er auf das Symbol tippt. |
| IsRemovable | Mit diesem Schlüssel können Sie festlegen, ob der Benutzer das Symbol vom Startbildschirm entfernen kann. |
| FullScreen | Mit diesem Schlüssel können Sie festlegen, ob die Webseite im Vollbildmodus 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 Starten des Webclips verwendet werden soll. Wird er nicht angegeben, 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. Wird 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: |
<plist version="1.0">
<dict>
<key>PayloadContent</key>
<array>
<dict>
<key>Label</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.managed</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
<dict>
<key>Label</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.managed</string>
<key>PayloadVersion</key>
<integer>1</integer>
</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>Configuration</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
</plist>Browser-Whitelist
Mit der „WebContentFilter“-Payload können Sie eine Zulassungsliste definieren, die alle über einen Internetbrowser zugänglichen Websites enthält. Im nativen Safari-Browser werden diese Websites auch 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 Documentation“ (externer Link).
Beachten Sie die folgenden Schlüssel, die Sie anpassen können, um das gewünschte Verhalten zu erzielen:
| Schlüssel | Beschreibung |
|---|---|
| FilterType | Setzen Sie diesen Schlüssel immer auf „BuiltIn“. |
| AllowList | Dies ist ein Array aus Dictionaries, von denen jedes eine Webseite angibt, auf die das Gerät über den Internetbrowser zugreifen darf. 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, sind jedoch nicht dazu verpflichtet. Sie können nach Bedarf weitere Dictionaries hinzufügen. |
<plist version="1.0">
<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>Title</key>
<string>Apple</string>
<key>URL</key>
<string>apple.com</string>
</dict>
</array>
<key>PayloadDisplayName</key>
<string>Allowlist</string>
<key>PayloadIdentifier</key>
<string>Allowlist.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>
<integer>1</integer>
</dict>
</array>
<key>PayloadDisplayName</key>
<string>Allowlist</string>
<key>PayloadIdentifier</key>
<string>Allowlist.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-Sperrliste
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 sperren, werden auch die Subdomains gesperrt. Weitere Informationen finden Sie unter „WebContentFilter | Apple Developer Documentation“ (externer Link).
| Schlüssel | Beschreibung |
|---|---|
| FilterType | Setzen 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. |
<plist version="1.0">
<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>
<integer>1</integer>
</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>Configuration</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 Kontoname, 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ätebesitzers 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 Endpoint Management: Zugewiesener Benutzer“. |
| Benutzername | Dies ist der Benutzername des Gerätebesitzers. Wenn Sie die Variable ${device.owner.email} verwenden, füllt NinjaOne dieses Feld automatisch mit der in NinjaOne angegebenen E-Mail-Adresse des Gerätebesitzers aus. Wenn Sie diese Variable verwenden, stellen Sie sicher, dass dem Gerät ein 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 erstmaligen Einrichtung 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 Benutzer Nachrichten aus diesem Konto in ein anderes Konto verschieben dürfen. |
| AppSheet-Sperre | Mit diesem Schlüssel können Sie festlegen, ob Gerätebesitzer zum Versenden von E-Mails eine andere App 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 Benutzer die Einstellung „EnableCalendars“ ändern darf. |
| EnableContacts | Legen Sie fest, ob Kontakte synchronisiert werden sollen. |
| EnableContactsUserOverridable | Mit diesem Schlüssel können Sie festlegen, ob der Benutzer die Einstellung „EnableCalendars“ ändern darf. |
| EnableMail | Legen Sie fest, ob E-Mails synchronisiert werden sollen. |
| EnableMailUserOverridable | Mit diesem Schlüssel können Sie festlegen, ob der Benutzer die Einstellung „EnableMail“ ändern darf. |
| EnableNotes | Legen Sie fest, ob die Notes-App synchronisiert werden soll. |
| EnableNotesUserOverridable | Mit diesem Schlüssel können Sie festlegen, ob der Benutzer die Einstellung „EnableNotes“ ändern darf. |
| EnableReminders | Legen Sie fest, ob die „Reminders“-App synchronisiert werden soll. |
| EnableRemindersUserOverridable | Mit diesem Schlüssel können Sie festlegen, ob der Benutzer die Einstellung „EnableReminders“ ändern darf. |
<plist version="1.0">
<dict>
<key>PayloadContent</key>
<array>
<dict>
<key>PayloadDisplayName</key>
<string>Unternehmens-E-Mail</string>
<key>Host</key>
<string>outlook.office365.com</string>
<key>EmailAddress</key>
<string>${device.owner.email}</string>
<key>UserName</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>
<true />
<key>Kalender aktivieren</key>
<true/>
<key>Kalender vom Benutzer überschreibbar machen</key>
<false/>
<key>Kontakte aktivieren</key>
<true/>
<key>Kontakte vom Benutzer überschreibbar machen</key>
<false/>
<key>EnableMail</key>
<true/>
<key>EnableMailUserOverridable</key>
<false/>
<key>EnableNotes</key>
<true/>
<key>EnableNotesUserOverridable</key>
<false/>
<key>EnableReminders</key>
<true/>
<key>EnableRemindersUserOverridable</key>
<false/>
<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>
<integer>1</integer>
</dict>
</array>
<key>PayloadDisplayName</key>
<string>Unternehmens-E-Mail</string>
<key>PayloadIdentifier</key>
<string>Unternehmens-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>
<integer>1</integer>
</dict>
</plist>Weitere Ressourcen
Weitere Informationen zu Apple MDM in NinjaOne finden Sie unter „NinjaOne MDM: Ressourcenkatalog “.