Apple MDM: esempi di payload personalizzati

Argomento

Questo articolo illustra alcuni esempi di payload personalizzati per i dispositivi gestiti tramite NinjaOne Mobile Device Management (MDM), che possono essere utilizzati per aggiungere una configurazione mobile a una policy NinjaOne e configurare impostazioni non disponibili direttamente in NinjaOne.

Ambiente

NinjaOne Gestione dei dispositivi mobili (MDM)
Apple iOS
Apple iPadOS
Apple macOS

Descrizione

I tecnici in possesso delle autorizzazioni MDM appropriate possono utilizzare payload personalizzati per i dispositivi Apple MDM per aggiungere una configurazione mobile a una policy NinjaOne e configurare impostazioni non disponibili direttamente nell'interfaccia utente di NinjaOne.

Seleziona una categoria per ulteriori informazioni:

Formato standard per i file di configurazione per dispositivi mobili
Payload per iOS, iPadOS e macOS
Certificati
- Certificato PKCS1
- Certificato PKCS12
Payload per iOS e iPadOS
Risorse aggiuntive

Formato standard per i file di configurazione per dispositivi mobili

I file di configurazione mobile vengono utilizzati per creare payload personalizzati e la documentazione Apple definisce le chiavi di primo livello richieste per questi tipi di file. Per ulteriori informazioni, consultare TopLevel | Documentazione per sviluppatori Apple (link esterno).

L'esempio seguente mostra le chiavi obbligatorie e il formato per ciascun file mobileconfig MDM di Apple:

<DICT>
<KEY>PayloadContent</KEY>
<ARRAY>
…
</ARRAY>
<KEY>PayloadDisplayName</KEY>
<STRING>Nome profilo</STRING>
<KEY>PayloadIdentifier</KEY>
<STRING>Profilo.2DE4CC74-A880-402D-A9CF-6665C87FE12E</STRING>
<KEY>PayloadUUID</KEY>
<STRING>2DE4CC74-A880-402D-A9CF-6665C87FE12E</STRING>
<KEY>PayloadType</KEY>
<STRING>Configurazione</STRING>
<KEY>PayloadVersion</KEY>
<NUMERO intero>1</NUMERO intero>
</DICT>
</PLIST>

Questa struttura contiene diversi campi obbligatori:

Campo	Descrizione
PayloadContent	Questo array di dizionari definisce ogni payload di configurazione inviato al dispositivo. Ogni `mobileconfig` deve avere almeno un dizionario di payload definito entro l'array `PayloadContent`.
PayloadDisplayName	Questo è il nome del payload.
PayloadIdentifier	Questo identificatore è univoco tra tutti i payload MDM inviati a ciascun dispositivo. Una pratica comune consiste nell’utilizzare il formato `[Nome].[UUID]`. Se si tenta di installare due payload con lo stesso identificatore su un dispositivo, in genere l’installazione del secondo payload non andrà a buon fine.
PayloadUUID	Utilizzare una stringa nel formato Globally Unique Identifier (GUID) univoca tra tutti i payload MDM inviati a ciascun dispositivo. Su macOS, è possibile utilizzare il seguente comando nel Terminale per generare un Universally Unique Identifier (UUID) casuale. `uuidgen`
PayloadType	Si tratta di una stringa che corrisponde al tipo di payload. Questo campo deve sempre assumere il valore “Configuration” oppure deve corrispondere a uno dei tipi di payload definiti da Apple.
PayloadVersion	Si tratta della versione del payload. È possibile aggiornare un payload senza incrementare questo campo.

Dopo aver definito il payload personalizzato in una policy, non è possibile modificare i valori di PayloadIdentifier e PayloadUUID. Se è necessario modificare questi valori, è necessario prima definire un nuovo payload personalizzato ed eliminare quello precedente.

Anche i dizionari all’interno dell’array PayloadContent presentano una struttura molto specifica. È necessario includere determinate chiavi standard in ogni dizionario e chiavi univoche per ciascun PayloadType. Per ulteriori informazioni, consultare la documentazione per sviluppatori di Apple(link esterno). Per utilizzare le chiavi standard, fare riferimento al seguente blocco codice:

<PLIST version="1.0">
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         … {chiavi specifiche del PayloadType} …
         <KEY>PayloadDisplayName</KEY>
         <STRING>Restrizione</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>Restrizione.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>
         <NUMERO intero>1</NUMERO intero>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Nome profilo</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>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <NUMERO intero>1</NUMERO intero>
</DICT>
</PLIST>

È necessario includere i seguenti campi per ogni dizionario entro l’array PayloadContent:

Campo	Descrizione
PayloadDisplayName	È il nome leggibile dal utente per il payload del profilo.
PayloadIdentifier	Questo identificatore è univoco tra tutti i payload MDM inviati a ciascun dispositivo. Una pratica comune consiste nell’utilizzare il formato `[Nome].[UUID]`. Se si tenta di installare due payload con lo stesso identificatore su un dispositivo, in genere l’installazione del secondo payload fallirà.
UUID del payload	Questa stringa in formato GUID deve essere univoca tra tutti i payload MDM inviati a ciascun dispositivo. Su macOS, è possibile utilizzare il seguente comando nel Terminale per generare un UUID casuale. `uuidgen`
PayloadType	Si tratta di una stringa che corrisponde al tipo di payload. Deve sempre avere il valore “Configuration” oppure deve corrispondere a uno dei tipi di payload definiti da Apple. Per altre informazioni sui tipi di payload definiti, consultare Chiavi di payload specifiche per profilo \| Documentazione per sviluppatori Apple (link esterno).
PayloadVersion	Si tratta della versione del payload. È possibile aggiornare un payload senza incrementare questo campo.

NinjaOne supporta le seguenti variabili per i payload personalizzati. NinjaOne sostituirà automaticamente la variabile con le informazioni corrispondenti provenienti dal dispositivo o dall’Utente assegnato:

Variabile	Descrizione
${device.location.name}	Questo è il valore del nome della posizione assegnata al dispositivo.
${device.location.id}	Questo è il valore dell'ID della posizione assegnato al dispositivo.
${device.organization.name}	Questo è il valore del nome dell'organizzazione del dispositivo.
${device.organization.id}	Questo è il valore dell'ID dell'organizzazione del dispositivo.
${device.serialNumber}	Questo è il valore del numero di serie del dispositivo.
${device.id}	Questo è il valore GUID (identificatore univoco) del dispositivo.
${device.owner.email}	Questo è l'indirizzo e-mail dell'utente assegnato al dispositivo.
${device.owner.firstName}	Questo è il nome dell'utente assegnato al dispositivo.
${device.owner.lastName}	Questo è il valore del cognome dell'utente assegnato al dispositivo.
${device.owner.displayName}	Questo è il valore del nome visualizzato dell'utente assegnato al dispositivo.

Payload per iOS, iPadOS e macOS

Notifiche

È possibile utilizzare il payload Notifiche per definire le impostazioni di notifica per una o più app. Gli utenti non possono sovrascrivere queste impostazioni. Per altre informazioni, consultare Notifiche | Documentazione per sviluppatori Apple(link esterno).

È possibile modificare le seguenti chiavi per ottenere il comportamento desiderato:

Chiave	Descrizione
NotificationSettings	Si tratta di un array di dizionari, ciascuno dei quali definisce le impostazioni di notifica di una singola app. Contiene tutte le chiavi al di fuori del livello superiore. È possibile aggiungere altri dizionari a questa chiave, secondo necessità, per gestire tutte le app desiderate. Questo campo è obbligatorio.
BundleIdentifier	Si tratta dell’ID del pacchetto di una singola app di cui si gestiscono le impostazioni di notifica. Questo campo è obbligatorio.
NotificheAttive	Questo campo booleano specifica se le notifiche sono attivate o disattivate per questa app. Questo campo è obbligatorio.
AlertType	Impostare su 0 per Nessuno, su 1 per Banner temporaneo e su 2 per Banner persistente.
BadgesEnabled	Imposta se i badge sono attivi.
CriticalAlertEnabled	Imposta se consentire agli avvisi critici di ignorare le impostazioni di "Non disturbare " e della suoneria.
GroupingType	Impostare su 0 per il raggruppamento automatico, su 1 per raggruppare le notifiche da questa app in un unico gruppo e su 2 per non raggruppare le notifiche.
PreviewType	Imposta su 0 per mostrare sempre le anteprime, su 1 per mostrarle solo quando il dispositivo è sbloccato e su 2 per non mostrarle mai.
Mostra su CarPlay	Imposta se le notifiche devono essere mostrate in CarPlay.
Mostra nella schermata di blocco	Imposta se mostrare le notifiche sulla schermata di blocco.
ShowInNotificationCenter	Mostra le notifiche nel Centro Notifiche.
SuoniAttivati	Attiva i suoni per le notifiche.

<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>
               <VERO/>
               <CHIAVE>AlertType</CHIAVE>
               <NUMERO intero>2</NUMERO intero>
               <CHIAVE>BadgesEnabled</CHIAVE>
               <VERO/>
               <CHIAVE>CriticalAlertEnabled</CHIAVE>
               <VERO/>
               <CHIAVE>GroupingType</CHIAVE>
               <NUMERO intero>2</NUMERO intero>
               <CHIAVE>PreviewType</CHIAVE>
               <INTEGER>2</INTEGER>
               <KEY>ShowInCarPlay</KEY>
               <VERO/>
               <KEY>ShowInLockScreen</KEY>
               <VERO/>
               <KEY>ShowInNotificationCenter</KEY>
               <VERO/>
               <KEY>SoundsEnabled</KEY>
               <VERO/>
           </DICT>
           <DICT>
               <KEY>BundleIdentifier</KEY>
               <STRING>com.apple.tips</STRING>
               <KEY>NotificationsEnabled</KEY>
               <FALSO/>
           </DICT>
        </ARRAY>
        <KEY>PayloadDisplayName</KEY>
        <STRING>Notifiche</STRING>
        <KEY>PayloadIdentifier</KEY>
        <STRING>Notifiche.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>
        <NUMERO intero>1</NUMERO intero>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Notifiche</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Notifiche.C10A32DE-C782-4374-8D67-968EC168DD7A</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>C10A32DE-C782-4374-8D67-968EC168DD7A</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Certificati

Esistono diversi payload che è possibile utilizzare per trasferire certificati su un dispositivo, come ad esempio il payload CertificatePKCS12 o CertificatePKCS1.

In linea generale, si utilizza il payload PKCS12 per i certificati che contengono anche una chiave privata (all’interno del payload si specificherà la password utilizzata per accedere alla chiave privata) e il payload PKCS1 per i certificati senza chiave privata, principalmente per garantire che il dispositivo consideri attendibili i certificati specificati.

In questa sezione forniamo esempi di ciascun payload.

Certificato PKCS1

Da utilizzare per i certificati che non contengono la chiave privata. Si noti la seguente chiave:

Chiave	Descrizione
PayloadContent	Questa chiave contiene il file del certificato convertito in base64. È possibile generare questa chiave su un sistema macOS con il comando `base64 -i {percorso_del_file_del_certificato}`.

<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>
         <NUMERO intero>1</NUMERO intero>
      </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>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Certificato PKCS12

Utilizzare questo payload per i certificati che contengono una chiave privata e richiedono una password specifica per accedervi. Si notino le seguenti chiavi:

Chiave	Descrizione
AllowAllAppsAccess	Se impostata su vera, il sistema consente alle app di accedere alla chiave privata.
KeyIsExtractable	Se vero, l'utente può estrarre la chiave privata dal portachiavi.
Password	Questa è la password utilizzata per accedere alla chiave privata del certificato.
PayloadContent	Questa chiave contiene il file del certificato convertito in base64. Generarlo su un sistema macOS con il comando `base64 -i {percorso_del_file_del_certificato}`.

<PLIST version="1.0">
<DICT>
   <KEY>PayloadContent</KEY>
   <DICT>
      <KEY>AllowAllAppsAccess</KEY>
      <VERO />
      <KEY>KeyIsExtractable</KEY>
      <FALSO />
      <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>
         <NUMERO intero>1</NUMERO intero>
      </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>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <NUMERO intero>1</NUMERO intero>
</DICT>
</PLIST>

Payload per iOS e iPadOS

Leggi le seguenti sottosezioni per conoscere i diversi payload personalizzati per i dispositivi iOS e iPadOS.

Modalità chiosco (payload AppLock)

Utilizza il payload AppLock per bloccare un dispositivo su una singola app. Assicurati di distribuire anche l’app sul dispositivo tramite la policy NinjaOne, altrimenti il dispositivo potrebbe rimanere bloccato in uno stato inutilizzabile fino alla rimozione del payload AppLock. Per ulteriori informazioni, consulta AppLock | Documentazione per sviluppatori Apple (link esterno).

Prendi nota delle seguenti chiavi, che possono essere modificate per ottenere il comportamento desiderato:

Chiave	Descrizione
Identificatore	Si tratta del `bundleID` dell’app su cui si desidera limitare l’uso del dispositivo. Assicurarsi che l’app sia distribuita sul dispositivo.
Opzioni	Si tratta di un dizionario di opzioni che consente di attivare o disattivare vari comportamenti hardware o opzioni di accessibilità.
Opzioni abilitate dall’utente	Utilizzando la scorciatoia di accessibilità sul dispositivo (premere tre volte il pulsante di blocco), è possibile consentire all’utente di modificare determinate impostazioni di accessibilità.

<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>App</KEY>
         <DICT>
            <KEY>Identifier</KEY>
            <STRING>com.ninjaone.assist</STRING>
            <KEY>Opzioni</KEY>
            <DICT>
               <KEY>DisableAutoLock</KEY>
               falso
               <KEY>DisableDeviceRotation</KEY>
               falso
               <KEY>DisableRingerSwitch</KEY>
               falso
               <KEY>DisableSleepWakeButton</KEY>
               falso
               <KEY>DisableTouch</KEY>
               falso
               <KEY>DisableVolumeButtons</KEY>
               falso
               <KEY>EnableAssistiveTouch</KEY>
               falso
               <KEY>EnableInvertColors</KEY>
               falso
               <KEY>EnableMonoAudio</KEY>
               falso
               <KEY>AbilitaLetturaSelezione</KEY>
               falso
               <KEY>AbilitaVoiceOver</KEY>
               falso
               <KEY>AbilitaZoom</KEY>
               falso
               <KEY>AbilitaControlloVocale</KEY>
               falso
            </DICT>
            <KEY>UserEnabledOptions</KEY>
            <DICT>
               <KEY>AssistiveTouch</KEY>
               falso
               <KEY>InvertColors</KEY>
               falso
               <KEY>VoiceOver</KEY>
               falso
               <KEY>Zoom</KEY>
               falso
               <KEY>VoiceControl</KEY>
               <FALSO />
            </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>
         <NUMERO intero>1</NUMERO intero>
      </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>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Web Clip

È possibile utilizzare il payload WebClip per aggiungere icone alla schermata iniziale del dispositivo che rimandano direttamente a una pagina web specificata. Per ulteriori informazioni, consultare WebClip | Documentazione per sviluppatori Apple (link esterno).

Ogni dizionario entro l’array PayloadContent configurerà un singolo Web Clip, ma è possibile definire più dizionari per configurare più Web Clip. Si presti attenzione alle seguenti chiavi, che è possibile modificare per ottenere il comportamento desiderato:

Chiave	Descrizione
Etichetta	Si tratta dell’etichetta dell’icona che apparirà sul dispositivo.
URL	Questo è l'URL esatto che l'utente verrà reindirizzato ad esso quando toccherà l'icona.
IsRemovable	Questa chiave consente di determinare se l'utente può rimuovere l'icona dalla schermata iniziale.
FullScreen	Questa chiave consente di determinare se la pagina web debba essere visualizzata sullo schermo intero o se debba essere visibile il menu di navigazione del browser.
TargetApplicationBundleIdentifier	Questa chiave opzionale consente di specificare il `bundleID` di un browser da utilizzare per avviare il web clip. Se non è inclusa, il dispositivo utilizzerà il browser predefinito.
Icona	Si tratta di una stringa codificata in base64 che contiene il contenuto di un file immagine da utilizzare come icona. Se non è inclusa, il dispositivo utilizzerà un'icona "vuota" predefinita. Su macOS, è possibile generare questa stringa utilizzando il seguente comando nel Terminale: `base64 -i {percorso_dell’icona}`

<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>Etichetta</KEY>
         <STRING>N1</STRING>
         <KEY>URL</KEY>
         <STRING>https://www.ninjaone.com</STRING>
         <KEY>IsRemovable</KEY>
         <FALSE />
         <KEY>FullScreen</KEY>
         <VERO />
         <KEY>Icona</KEY>
         <DATI>
         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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.gestito</STRING>
         <KEY>PayloadVersion</KEY>
         <NUMERO intero>1</NUMERO intero>
      </DICT>
      <DICT>
         <KEY>Etichetta</KEY>
         <STRING>Apple</STRING>
         <KEY>URL</KEY>
         <STRING>https://www.apple.com</STRING>
         <KEY>IsRemovable</KEY>
         <FALSO />
         <KEY>FullScreen</KEY>
         <VERO />
         <KEY>TargetApplicationBundleIdentifier</KEY>
         <STRING>com.apple.mobilesafari</STRING>
         <KEY>Icona</KEY>
         <DATI>
         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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.gestito</STRING>
         <KEY>PayloadVersion</KEY>
         <NUMERO intero>1</NUMERO intero>
      </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>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Elenco degli elementi consentiti nel browser

È possibile utilizzare il payload WebContentFilter per definire un elenco di elementi consentiti che contenga tutti i siti web accessibili tramite un browser Internet. Nel browser nativo Safari, questi siti web appariranno anche nei Preferiti. Se si autorizza un dominio, i sottodomini e le sottopagine sono accessibili per impostazione predefinita. Per ulteriori informazioni, consultare WebContentFilter | Documentazione per sviluppatori Apple (link esterno).

Prendere nota delle seguenti chiavi, che è possibile modificare per ottenere il comportamento desiderato:

Chiave	Descrizione
FilterType	Imposta sempre questa chiave su BuiltIn.
Elenco elementi consentiti	Si tratta di un array di dizionari, ciascuno dei quali specifica una pagina web a cui il dispositivo può accedere tramite il browser Internet. Ogni dizionario contiene un titolo (utilizzato per la scheda Preferiti in Safari) e l'URL effettivo. È possibile specificare sottodomini per l'URL, ma non è obbligatorio farlo. È possibile aggiungere dizionari secondo necessità.

<PLIST version="1.0">
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>FilterType</KEY>
         <STRING>BuiltIn</STRING>
         <KEY>AllowListBookmarks</KEY>
         <ARRAY>
            <DICT>
               <KEY>Titolo</KEY>
               <STRING>NinjaOne</STRING>
               <KEY>URL</KEY>
               <STRING>ninjaone.com</STRING>
            </DICT>
            <DICT>
               <KEY>Titolo</KEY>
               <STRING>Apple</STRING>
               <KEY>URL</KEY>
               <STRING>apple.com</STRING>
            </DICT>
         </ARRAY>
         <KEY>PayloadDisplayName</KEY>
         <STRING>Elenco elementi consentiti</STRING>
         <KEY>PayloadIdentifier</KEY>
         <STRING>Elenco elementi consentiti.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>
         <NUMERO intero>1</NUMERO intero>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Elenco elementi consentiti</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Elenco elementi consentiti.129BBAA6-40E8-46E2-92BF-0CDABAD54BA6</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>129BBAA6-40E8-46E2-92BF-0CDABAD54BA6</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Elenco elementi bloccati del browser

È possibile utilizzare il payload WebContentFilter per definire un elenco di siti da bloccare che contiene tutti i siti web inaccessibili tramite browser. Se si blocca un dominio, verranno bloccati anche i sottodomini. Scopri di più sulla Documentazione per sviluppatori Apple (link esterno).

Chiave	Descrizione
FilterType	Imposta sempre questa chiave su BuiltIn.
DenyListURLs	Si tratta di un array di stringhe, ciascuna delle quali specifica una pagina web a cui il dispositivo non può accedere tramite il browser. Facoltativamente, è possibile specificare sottodomini per l'URL. Aggiungi stringhe secondo necessità.

<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>
         <NUMERO intero>1</NUMERO intero>
      </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>Configurazione</STRING>
   <KEY>PayloadVersion</KEY>
   <INTEGER>1</INTEGER>
</DICT>
</PLIST>

Configurazione della posta

È possibile utilizzare il payload ExchangeActiveSync per configurare l’app di posta nativa su un dispositivo in modo che si connetta a un account Exchange ActiveSync (EAS) per la posta elettronica. L’utente deve prima effettuare l’autenticazione all’account EAS prima che i dati vengano sincronizzati. Per ulteriori informazioni, consultare ExchangeActiveSync | Documentazione per sviluppatori Apple (link esterno).

Esistono diverse opzioni configurabili per questo payload, ma prestare particolare attenzione alle seguenti chiavi:

Chiave	Descrizione
PayloadDisplayName	È il nome dell'account che apparirà sul dispositivo.
Host	Si tratta del nome host o dell'indirizzo IP del server Exchange. Per Office 365, utilizzare outlook.office365.com.
EmailAddress	Si tratta dell'indirizzo e-mail dell'utente. Quando si utilizza la variabile `${device.owner.email}`, NinjaOne compilerà automaticamente questo campo con l'indirizzo e-mail del proprietario del dispositivo specificato in NinjaOne. Se si utilizza questa opzione, assicurarsi che al dispositivo sia assegnato un utente. Per informazioni su come assegnare un dispositivo a un utente, consultare NinjaOne Endpoint management: Utente assegnato.
Nome utente	Si tratta del nome utente del proprietario del dispositivo. Quando si utilizza la variabile `${device.owner.email}`, NinjaOne compilerà automaticamente questo campo con l’indirizzo e-mail del proprietario del dispositivo specificato in NinjaOne. Se si utilizza questa opzione, assicurarsi che al dispositivo sia assegnato un utente.
OAuth	Questa chiave consente di determinare se la configurazione utilizza OAuth per l’autenticazione federata.
MailNumberOfPastDaysToSync	Questa chiave consente di determinare il numero di giorni di posta da sincronizzare al momento della prima configurazione dell’account.
SSL	Applica il protocollo Secure Socket Layer (SSL) per la connessione.
PreventMove	Questa chiave consente di stabilire se gli utenti possono spostare i messaggi da questo account a un altro.
PreventAppSheet	Questa chiave consente di stabilire se i proprietari dei dispositivi possono utilizzare un'app diversa da Apple Mail per inviare e-mail.
AbilitaCalendari	Determina se sincronizzare i calendari.
EnableCalendarsUserOverridable	Questa chiave consente di stabilire se l’utente possa modificare l’impostazione `EnableCalendars`.
EnableContacts	Determina se sincronizzare i contatti.
EnableContactsUserOverridable	Questa chiave consente di stabilire se l'utente può modificare l'impostazione `EnableCalendars`.
EnableMail	Determina se la posta è sincronizzata.
EnableMailUserOverridable	Questa chiave consente di stabilire se l'utente può modificare l'impostazione `EnableMail`.
EnableNotes	Determina se sincronizzare l'app Note.
EnableNotesUserOverridable	Questa chiave consente di stabilire se l'utente può modificare l'impostazione `EnableNotes`.
EnableReminders	Determina se sincronizzare l’app Promemoria.
EnableRemindersUserOverridable	Questa chiave consente di stabilire se l'utente può modificare l'impostazione `EnableReminders`.

<PLIST version="1.0">
<DICT>
   <KEY>PayloadContent</KEY>
   <ARRAY>
      <DICT>
         <KEY>PayloadDisplayName</KEY>
         <STRING>Email aziendale</STRING>
         <KEY>Host</KEY>
         <STRING>outlook.office365.com</STRING>
         <KEY>EmailAddress</KEY>
         <STRING>${device.owner.email}</STRING>
         <KEY>Nome utente</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>PreventAppSheet</KEY>
         <VERO />
         <KEY>EnableCalendars</KEY>
         <VERO/>
         <KEY>EnableCalendarsUserOverridable</KEY>
         <FALSO/>
         <KEY>EnableContacts</KEY>
         <VERO/>
         <KEY>EnableContactsUserOverridable</KEY>
         <FALSO/>
         <KEY>EnableMail</KEY>
         <VERO/>
         <KEY>EnableMailUserOverridable</KEY>
         <FALSO/>
         <KEY>EnableNotes</KEY>
         <VERO/>
         <KEY>EnableNotesUserOverridable</KEY>
         <FALSO/>
         <KEY>EnableReminders</KEY>
         <VERO/>
         <KEY>EnableRemindersUserOverridable</KEY>
         falso
         <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>
         <NUMERO intero>1</NUMERO intero>
      </DICT>
   </ARRAY>
   <KEY>PayloadDisplayName</KEY>
   <STRING>Email aziendale</STRING>
   <KEY>PayloadIdentifier</KEY>
   <STRING>Email aziendale.158FBE77-8888-4578-A443-DBF46AD4C937</STRING>
   <KEY>PayloadType</KEY>
   <STRING>Configurazione</STRING>
   <KEY>PayloadUUID</KEY>
   <STRING>158FBE77-8888-4578-A443-DBF46AD4C937</STRING>
   <KEY>PayloadVersion</KEY>
   <NUMERO intero>1</NUMERO intero>
</DICT>
</PLIST>

Risorse aggiuntive

Consulta NinjaOne MDM: Catalogo delle risorse per ulteriori informazioni su Apple MDM in NinjaOne.