Configuració d’app gestionada

Configura el comportament de Vylos mitjançant el canal estàndard d’Apple per a la configuració d’apps gestionades que proporciona el teu servei de MDM.

Passos de desplegament

Instal·la o assigna Vylos (io.cbnventures.vylos) com a app gestionada.
Crea un diccionari de configuració d’app al servei MDM.
Afegeix només les claus de restricció, preferència i organització que vulguis gestionar.
Assigna el diccionari als dispositius o usuaris de destinació.
Obre Vylos o porta’l al primer pla i comprova els valors a Configuració gestionada.

Si elimines una clau de preferència opcional, l’usuari recupera el control d’aquella configuració. Si elimines tot el diccionari, la configuració d’app gestionada es desactiva després que Vylos l’actualitzi.

Requisits de distribució

La configuració d’app gestionada és un diccionari que l’MDM assigna a l’app Vylos (io.cbnventures.vylos). Vylos el llegeix des de la ubicació estàndard d’Apple com.apple.configuration.managed.

Aquest diccionari no és un fitxer .mobileconfig instal·lable i no es pot injectar obrint un perfil al dispositiu. Utilitza els perfils .mobileconfig quan necessitis instal·lar un túnel VPN gestionat.

El teu MDM pot anomenar aquesta funció Configuració d’app gestionada, Configuració d’app, Configuració personalitzada de l’app o Configuració d’app gestionada. Vylos s’ha d’instal·lar o assignar com a app gestionada abans que iOS, macOS o visionOS puguin lliurar-li el diccionari.

Claus compatibles

Restriccions

Clau	Tipus	Valor per defecte	Finalitat
`allowManualTunnels`	Booleà	`true`	Permet els túnels creats per l’usuari i les accions per crear-los, modificar-los o activar-los.
`allowSettings`	Booleà	`true`	Permet accedir a la configuració de Vylos.
`blockJailbrokenDevices`	Booleà	`false`	Bloqueja completament Vylos quan la detecció de jailbreak és positiva a l’iOS.

Consulta Gestionar les restriccions per conèixer el comportament complet de cada restricció i Aplicar la política de jailbreak per al cicle de bloqueig complet.

Preferències gestionades

Clau	Tipus	Valors acceptats	Efecte
`notificationsEnabled`	Booleà	`true`, `1`, `false` o `0`	Substitueix l’interruptor principal de notificacions de Vylos i els quatre tipus d’avís de desconnexió. No pot concedir el permís de notificacions del sistema d’Apple; si les notificacions estan activades i la configuració de l’app està bloquejada, Vylos demana el permís des de la pantalla d’inici.
`appearance`	Cadena	`system`, `light` o `dark`	Força l’aparença a l’iOS i al macOS. visionOS mostra el valor rebut perquè l’administrador el pugui comprovar, però continua utilitzant el vidre adaptatiu del sistema.
`appIcon`	Cadena	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest` o `obsidian`	Força una icona alternativa a l’iOS. macOS i visionOS mostren el valor rebut perquè l’administrador el pugui comprovar, però no canvien la icona de l’app.

Vylos conserva les opcions anteriors de l’usuari i les restaura quan l’administrador elimina la substitució corresponent. Una clau opcional absent o mal formada deixa la preferència sota el control de l’usuari, encara que altres claus gestionades continuïn actives.

L’idioma no és una preferència gestionada per Vylos. Els usuaris i administradors seleccionen l’idioma de l’app amb els controls d’idioma per app del sistema operatiu.

Configuració de Vylos amb les preferències gestionades Protecció de l’app, Icona de l’app, Aparença i Notificacions

Informació de l’organització

Clau	Tipus	Es mostra com
`companyName`	Cadena	Empresa
`contactEmail`	Cadena	Correu
`contactPhone`	Cadena	Telèfon
`contactAddress`	Cadena	Adreça

Vylos elimina els espais inicials i finals i omet els valors buits de l’organització. Els valors proporcionats apareixen a Configuració gestionada perquè els usuaris sàpiguen qui gestiona l’app i com poden demanar ajuda.

Valors booleans

Vylos accepta booleans, números o cadenes perquè els productes MDM serialitzen els valors de configuració de maneres diferents. Converteix cada valor en una cadena, elimina els espais inicials i finals i el compara sense distingir entre majúscules i minúscules.

true i 1 signifiquen cert.
false i 0 signifiquen fals.
Si falta una restricció, s’utilitza el valor per defecte documentat.
Si falta una preferència o té un format incorrecte, continua vigent la configuració de l’usuari.

Per exemple, " False ", "FALSE" i el número 0 s’interpreten com a fals. Un valor com "yes" no és vàlid i no activa la clau silenciosament.

Prioritat de la configuració

Una preferència gestionada vàlida substitueix la configuració manual corresponent mentre la clau sigui present. Vylos conserva per separat l’opció desada de l’usuari en lloc de sobreescriure-la.

Les restriccions s’avaluen de manera independent. Proporcionar una clau gestionada no canvia els valors per defecte de les claus omeses.

Qualsevol configuració gestionada no buida omet el pas d’autenticació del bloqueig de l’app integrat a Vylos. Les restriccions gestionades continuen aplicant-se: allowManualTunnels=false suspèn els túnels creats per l’usuari i rebutja les seves Dreceres desades, mentre que allowSettings=false continua bloquejant la configuració.

Moment de l’actualització

Vylos llegeix el diccionari gestionat quan s’inicia l’app i cada vegada que la seva escena torna al primer pla o s’activa. Si s’elimina el diccionari, les preferències controlades per l’usuari es restauren a l’actualització següent.

Aquest moment és independent de les actualitzacions d’estat i estadístiques dels túnels. Quan un túnel gestionat apareix a Vylos, la vista de detalls oberta actualitza les estadístiques en directe cada segon, com en un túnel creat per l’usuari. Un perfil VPN acabat d’instal·lar o substituït pot aparèixer més tard perquè Apple publica els perfils gestionats segons el seu propi calendari; consulta Desplegar túnels gestionats per entendre aquest comportament.

Exemple complet

Aquest exemple inclou totes les claus compatibles i serveix com a referència completa que pots copiar. Enganxa el diccionari de llista de propietats en un editor MDM que accepti XML o introdueix les mateixes claus i tipus individualment en un editor de clau i valor:

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’exemple produeix la política següent:

Clau	Valor de l’exemple	Resultat a Vylos
`allowManualTunnels`	`false`	Amaga, suspèn i impedeix utilitzar els túnels creats per l’usuari. Els túnels gestionats continuen disponibles.
`allowSettings`	`false`	Bloqueja l’àrea d’ajustos de l’app.
`blockJailbrokenDevices`	`true`	A iOS, bloqueja Vylos i els seus túnels quan es detecta un jailbreak.
`notificationsEnabled`	`true`	Activa l’ajust principal de notificacions de Vylos i els quatre tipus de notificació.
`appearance`	`dark`	Força l’aparença fosca a iOS i macOS; visionOS registra el valor però manté el vidre adaptatiu del sistema.
`appIcon`	`ocean`	Selecciona la icona Ocean a iOS; macOS i visionOS només mostren el valor gestionat.
`companyName`	`Example Company`	Identifica l’organització gestora a Configuració gestionada.
`contactEmail`	`[email protected]`	Mostra l’adreça electrònica de suport.
`contactPhone`	`+1 (212) 555-0100`	Mostra el telèfon de suport.
`contactAddress`	Adreça d’exemple	Mostra l’adreça postal de l’organització.

Elimina qualsevol clau opcional que l’organització no vulgui controlar. No enviïs una cadena buida per retornar una preferència al control de l’usuari; elimina la clau.

Editors de clau i valor de l’MDM

Utilitza exactament l’ortografia i el tipus de valor indicats. Per exemple, afegeix allowSettings com a booleà i no com al text "false" quan l’MDM admeti camps tipats. Vylos també accepta les formes booleanes de text i numèriques documentades per als sistemes que serialitzen els valors de manera diferent.

Què veuen els usuaris

Quan la configuració està activa, Configuració gestionada mostra primer l’organització i, després, les restriccions i les preferències gestionades proporcionades. La pantalla és informativa i no permet canviar els valors gestionats.

Pantalla informativa de Configuració gestionada activa amb el contacte de l’organització, les restriccions i les preferències gestionades

Quan no hi ha cap diccionari, els usuaris poden obrir Quant a la configuració d’app gestionada des de la configuració de Protecció de l’app. Un estat desactivat en aquesta vista no significa que falti un perfil de configuració VPN; els dos canals de desplegament són independents.