Configurazione app gestita

Configura il comportamento di Vylos tramite il canale Apple standard per la configurazione delle app gestite fornito dal servizio MDM.

Passaggi di distribuzione

Installa o assegna Vylos (io.cbnventures.vylos) come app gestita.
Crea un dizionario di configurazione app nel servizio MDM.
Aggiungi solo le chiavi di restrizione, preferenza e organizzazione che intendi gestire.
Assegna il dizionario ai dispositivi o agli utenti destinatari.
Avvia Vylos o riportalo in primo piano, quindi verifica i valori in Configurazione gestita.

La rimozione di una chiave di preferenza facoltativa restituisce all’utente il controllo di quell’impostazione. La rimozione dell’intero dizionario disattiva la configurazione app gestita dopo il successivo aggiornamento di Vylos.

Requisiti di distribuzione

La configurazione app gestita è un dizionario assegnato da MDM all’app Vylos (io.cbnventures.vylos). Vylos lo legge dalla posizione Apple standard com.apple.configuration.managed.

Questo dizionario non è un file .mobileconfig installabile e non può essere inserito aprendo un profilo sul dispositivo. Usa i profili .mobileconfig quando devi installare un tunnel VPN gestito.

Il servizio MDM potrebbe chiamare questa funzione Configurazione app gestita, Configurazione app, Impostazioni app personalizzate o Impostazioni app gestita. Vylos deve essere installato o assegnato come app gestita prima che iOS, macOS o visionOS possano consegnargli il dizionario.

Chiavi supportate

Restrizioni

Chiave	Tipo	Predefinito	Scopo
`allowManualTunnels`	Booleano	`true`	Consente i tunnel creati dall’utente e le azioni per crearli, modificarli o attivarli.
`allowSettings`	Booleano	`true`	Consente l’accesso alle impostazioni di Vylos.
`blockJailbrokenDevices`	Booleano	`false`	Blocca completamente Vylos quando il rilevamento jailbreak dà esito positivo su iOS.

Consulta Gestire le restrizioni per il comportamento completo di ogni restrizione e Applicare i criteri jailbreak per il ciclo di applicazione del blocco completo.

Preferenze gestite

Chiave	Tipo	Valori accettati	Effetto
`notificationsEnabled`	Booleano	`true`, `1`, `false` o `0`	Sostituisce l’impostazione principale delle notifiche Vylos e tutti e quattro i tipi di notifica di disconnessione. Non può concedere l’autorizzazione di sistema Apple; se le notifiche sono attive e le impostazioni nell’app sono bloccate, Vylos richiede l’autorizzazione dalla schermata Home.
`appearance`	Stringa	`system`, `light` o `dark`	Impone l’aspetto su iOS e macOS. visionOS mostra il valore ricevuto per la verifica amministrativa, ma continua a usare il vetro adattivo del sistema.
`appIcon`	Stringa	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest` o `obsidian`	Impone un’icona alternativa su iOS. macOS e visionOS mostrano il valore ricevuto per la verifica amministrativa, senza modificare l’icona dell’app.

Vylos conserva le scelte precedenti dell’utente e le ripristina quando l’amministratore rimuove la relativa sostituzione. Una chiave facoltativa assente o non valida lascia la preferenza sotto il controllo dell’utente, anche se restano attive altre chiavi gestite.

La lingua non è una preferenza gestita di Vylos. Utenti e amministratori selezionano la lingua dell’app tramite i controlli per-app del sistema operativo.

Impostazioni Vylos con le preferenze gestite Protezione app, Icona app, Aspetto e Notifiche

Informazioni sull’organizzazione

Chiave	Tipo	Visualizzato come
`companyName`	Stringa	Azienda
`contactEmail`	Stringa	E-mail
`contactPhone`	Stringa	Telefono
`contactAddress`	Stringa	Indirizzo

Vylos rimuove gli spazi iniziali e finali e omette i valori vuoti dell’organizzazione. I valori forniti compaiono in Configurazione gestita, così gli utenti sanno chi gestisce l’app e come chiedere assistenza.

Valori booleani

Vylos accetta valori booleani, numeri o stringhe perché i prodotti MDM serializzano i valori di configurazione in modi diversi. Converte ogni valore in stringa, rimuove gli spazi iniziali e finali e lo confronta senza distinguere tra maiuscole e minuscole.

true e 1 equivalgono a vero.
false e 0 equivalgono a falso.
Una restrizione assente usa il valore predefinito documentato.
Una preferenza assente o non valida lascia in vigore l’impostazione dell’utente.

Ad esempio, " False ", "FALSE" e il numero 0 vengono tutti interpretati come falsi. Un valore come "yes" non è valido e non abilita silenziosamente una chiave.

Precedenza della configurazione

Una preferenza gestita valida sostituisce la relativa impostazione manuale finché la chiave rimane presente. Vylos conserva separatamente la scelta salvata dall’utente anziché sovrascriverla.

Le restrizioni vengono valutate in modo indipendente. Fornire una chiave gestita non modifica i valori predefiniti delle chiavi omesse.

Qualsiasi configurazione gestita non vuota ignora il passaggio di autenticazione del blocco app integrato in Vylos. Le restrizioni gestite continuano a essere applicate: allowManualTunnels=false sospende i tunnel creati dall’utente e rifiuta i relativi Comandi Rapidi salvati, mentre allowSettings=false continua a bloccare le impostazioni.

Tempistica di aggiornamento

Vylos legge il dizionario gestito all’avvio dell’app e ogni volta che la sua scena torna in primo piano o diventa attiva. La rimozione del dizionario ripristina le preferenze controllate dall’utente al successivo aggiornamento.

Questa tempistica è distinta dagli aggiornamenti dello stato e delle statistiche dei tunnel. Quando un tunnel gestito compare in Vylos, la sua vista dettagli aperta aggiorna le statistiche in tempo reale ogni secondo, proprio come un tunnel creato dall’utente. Un profilo VPN appena installato o sostituito può comparire più tardi perché Apple pubblica i profili gestiti secondo le proprie tempistiche; consulta Distribuire i tunnel gestiti per questo comportamento.

Esempio completo

Incolla il seguente dizionario plist nell’editor di configurazione app del servizio MDM oppure inserisci le chiavi equivalenti nel modulo chiave-valore:

xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>allowManualTunnels</key>
    <false/>
    <key>allowSettings</key>
    <false/>
    <key>blockJailbrokenDevices</key>
    <true/>
    <key>notificationsEnabled</key>
    <true/>
    <key>appearance</key>
    <string>dark</string>
    <key>appIcon</key>
    <string>ocean</string>
    <key>companyName</key>
    <string>Example Company</string>
    <key>contactEmail</key>
    <string>[email protected]</string>
    <key>contactPhone</key>
    <string>+1 (212) 555-0100</string>
    <key>contactAddress</key>
    <string>100 Example Street, New York, NY</string>
</dict>
</plist>

L’esempio applica i criteri seguenti:

Chiave	Valore di esempio	Risultato in Vylos
`allowManualTunnels`	`false`	Nasconde e sospende i tunnel creati dall’utente e ne impedisce l’uso. I tunnel gestiti rimangono disponibili.
`allowSettings`	`false`	Blocca l’area Impostazioni nell’app.
`blockJailbrokenDevices`	`true`	Su iOS, blocca Vylos e i suoi tunnel quando viene rilevato un jailbreak.
`notificationsEnabled`	`true`	Attiva l’impostazione principale delle notifiche di Vylos e tutti e quattro i tipi di notifica.
`appearance`	`dark`	Impone l’aspetto scuro su iOS e macOS; visionOS registra il valore ma continua a usare il vetro adattivo di sistema.
`appIcon`	`ocean`	Seleziona l’icona Ocean su iOS; macOS e visionOS mostrano solo il valore gestito.
`companyName`	`Example Company`	Indica l’organizzazione responsabile in Configurazione gestita.
`contactEmail`	`[email protected]`	Mostra l’indirizzo e-mail di assistenza dell’organizzazione.
`contactPhone`	`+1 (212) 555-0100`	Mostra il numero di telefono dell’assistenza.
`contactAddress`	Indirizzo di esempio	Mostra l’indirizzo postale dell’organizzazione.

Rimuovi qualsiasi chiave facoltativa che l’organizzazione non intende controllare. Non inviare una stringa vuota per restituire una preferenza all’utente: rimuovi la chiave.

Editor chiave-valore MDM

Usa esattamente l’ortografia e il tipo di valore indicati. Ad esempio, aggiungi allowSettings come valore booleano e non come testo "false" se l’MDM supporta campi tipizzati. Vylos accetta anche le forme booleane testuali e numeriche documentate per le console che serializzano i valori in modo diverso.

Cosa vedono gli utenti

Quando la configurazione è attiva, Configurazione gestita mostra prima l’organizzazione, poi le restrizioni e le preferenze gestite fornite. La schermata è solo informativa e non consente di modificare i valori gestiti.

Schermata informativa Configurazione gestita attiva con contatti dell’organizzazione, restrizioni e preferenze gestite

Quando non è presente alcun dizionario, gli utenti possono aprire Informazioni sulla configurazione app gestita dalle impostazioni di Protezione app. Uno stato disattivato in quella vista non indica che manca un profilo di configurazione VPN: i due canali di distribuzione sono indipendenti.