Configuración de app gestionada

Configura el comportamiento de Vylos mediante el canal estándar de Apple para la configuración de apps gestionadas que proporciona tu servicio de MDM.

Pasos de despliegue

Instala o asigna Vylos (io.cbnventures.vylos) como app gestionada.
Crea un diccionario de configuración de app en tu servicio MDM.
Añade únicamente las claves de restricciones, preferencias y organización que quieras gestionar.
Asigna el diccionario a los dispositivos o usuarios de destino.
Abre Vylos o tráelo a primer plano y comprueba los valores en Configuración gestionada.

Al eliminar una clave de preferencia opcional, el usuario recupera el control de ese ajuste. Al eliminar el diccionario completo, la configuración de app gestionada se desactiva después de que Vylos la actualice.

Requisitos de entrega

La configuración de app gestionada es un diccionario que el MDM asigna a la app Vylos (io.cbnventures.vylos). Vylos lo lee desde la ubicación estándar de Apple com.apple.configuration.managed.

Este diccionario no es un archivo .mobileconfig instalable y no se puede inyectar abriendo un perfil en el dispositivo. Utiliza perfiles .mobileconfig cuando necesites instalar un túnel VPN gestionado.

Tu MDM puede llamar a esta función Configuración de app gestionada, Configuración de app, Ajustes personalizados de la app o Ajustes de app gestionada. Vylos debe instalarse o asignarse como app gestionada antes de que iOS, macOS o visionOS puedan entregarle el diccionario.

Claves compatibles

Restricciones

Clave	Tipo	Valor predeterminado	Finalidad
`allowManualTunnels`	Booleano	`true`	Permite túneles creados por el usuario y las acciones para crearlos, modificarlos o activarlos.
`allowSettings`	Booleano	`true`	Permite acceder a los ajustes de Vylos.
`blockJailbrokenDevices`	Booleano	`false`	Hace que Vylos se bloquee por completo cuando la detección de jailbreak es positiva en iOS.

Consulta Gestionar restricciones para conocer el comportamiento completo de cada restricción y Aplicar la política de jailbreak para conocer el ciclo de aplicación del bloqueo completo.

Preferencias gestionadas

Clave	Tipo	Valores aceptados	Efecto
`notificationsEnabled`	Booleano	`true`, `1`, `false` o `0`	Anula el ajuste principal de notificaciones de Vylos y los cuatro tipos de aviso de desconexión. No puede conceder el permiso de notificaciones del sistema de Apple; si se activan las notificaciones mientras los ajustes de la app están bloqueados, Vylos solicita el permiso desde la pantalla de inicio.
`appearance`	Cadena	`system`, `light` o `dark`	Fuerza la apariencia en iOS y macOS. visionOS muestra el valor recibido para que el administrador pueda comprobarlo, pero sigue utilizando el cristal adaptativo del sistema.
`appIcon`	Cadena	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest` u `obsidian`	Fuerza un icono alternativo en iOS. macOS y visionOS muestran el valor recibido para que el administrador pueda comprobarlo, pero no cambian el icono de la app.

Vylos conserva las opciones anteriores del usuario y las restaura cuando el administrador elimina la anulación correspondiente. Una clave opcional ausente o con formato incorrecto deja esa preferencia bajo el control del usuario, aunque otras claves gestionadas sigan activas.

El idioma no es una preferencia gestionada por Vylos. Los usuarios y administradores seleccionan el idioma de la app mediante los controles de idioma por app del sistema operativo.

Ajustes de Vylos con las preferencias gestionadas de Protección de la app, Icono de la app, Apariencia y Notificaciones

Información de la organización

Clave	Tipo	Se muestra como
`companyName`	Cadena	Empresa
`contactEmail`	Cadena	Correo
`contactPhone`	Cadena	Teléfono
`contactAddress`	Cadena	Dirección

Vylos elimina los espacios iniciales y finales y omite los valores de organización vacíos. Los valores proporcionados aparecen en Configuración gestionada para que los usuarios sepan quién gestiona la app y cómo solicitar ayuda.

Valores booleanos

Vylos acepta booleanos, números o cadenas porque los productos MDM serializan los valores de configuración de formas distintas. Convierte cada valor en una cadena, elimina los espacios iniciales y finales y lo compara sin distinguir entre mayúsculas y minúsculas.

true y 1 significan verdadero.
false y 0 significan falso.
Si falta una restricción, se utiliza su valor predeterminado documentado.
Si falta una preferencia o su valor tiene un formato incorrecto, permanece vigente el ajuste del usuario.

Por ejemplo, " False ", "FALSE" y el número 0 se interpretan como falso. Un valor como "yes" no es válido y no activa la clave de forma silenciosa.

Prioridad de la configuración

Una preferencia gestionada válida anula el ajuste manual correspondiente mientras la clave siga presente. Vylos conserva por separado la opción guardada por el usuario en lugar de sobrescribirla.

Las restricciones se evalúan de forma independiente. Proporcionar una clave gestionada no cambia los valores predeterminados de las claves omitidas.

Cualquier configuración gestionada no vacía omite el paso de autenticación del bloqueo de la app integrado en Vylos. Las restricciones gestionadas siguen aplicándose: allowManualTunnels=false suspende los túneles creados por el usuario y rechaza sus Atajos guardados, mientras que allowSettings=false continúa bloqueando los ajustes.

Momento de actualización

Vylos lee el diccionario gestionado cuando se abre la app y cada vez que su escena vuelve al primer plano o se activa. Al eliminar el diccionario, las preferencias controladas por el usuario se restauran en la siguiente actualización.

Este momento es independiente de las actualizaciones del estado y las estadísticas de los túneles. Cuando un túnel gestionado aparece en Vylos, las estadísticas en directo de su vista de detalles abierta se actualizan cada segundo, igual que las de un túnel creado por el usuario. Un perfil VPN recién instalado o sustituido puede tardar más en aparecer porque Apple publica los perfiles gestionados según su propio calendario; consulta Desplegar túneles gestionados para conocer este comportamiento.

Ejemplo completo

Pega el siguiente diccionario de lista de propiedades en el editor de configuración de apps de tu MDM o introduce las claves equivalentes en su formulario de pares clave-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>it@example.com</string>
    <key>contactPhone</key>
    <string>+1 (212) 555-0100</string>
    <key>contactAddress</key>
    <string>100 Example Street, New York, NY</string>
</dict>
</plist>

El ejemplo aplica la política siguiente:

Clave	Valor de ejemplo	Resultado en Vylos
`allowManualTunnels`	`false`	Oculta, suspende e impide usar los túneles creados por el usuario. Los túneles gestionados siguen disponibles.
`allowSettings`	`false`	Bloquea el área de ajustes de la app.
`blockJailbrokenDevices`	`true`	En iOS, bloquea Vylos y sus túneles cuando se detecta un jailbreak.
`notificationsEnabled`	`true`	Activa el ajuste principal de notificaciones de Vylos y los cuatro tipos de notificación.
`appearance`	`dark`	Fuerza la apariencia oscura en iOS y macOS; visionOS registra el valor, pero mantiene el cristal adaptativo del sistema.
`appIcon`	`ocean`	Selecciona el icono Ocean en iOS; macOS y visionOS solo muestran el valor gestionado.
`companyName`	`Example Company`	Identifica a la organización gestora en Configuración gestionada.
`contactEmail`	`it@example.com`	Muestra el correo electrónico de soporte.
`contactPhone`	`+1 (212) 555-0100`	Muestra el teléfono de soporte.
`contactAddress`	Dirección de ejemplo	Muestra la dirección postal de la organización.

Elimina cualquier clave opcional que tu organización no quiera controlar. No envíes una cadena vacía para devolver una preferencia al usuario; elimina la clave.

Editores de clave y valor del MDM

Usa exactamente la ortografía y el tipo indicados. Por ejemplo, añade allowSettings como booleano y no como texto "false" cuando tu MDM admita campos tipados. Vylos también acepta las formas booleanas de texto y numéricas documentadas para consolas que serializan los valores de otra forma.

Lo que ven los usuarios

Cuando la configuración está activa, Configuración gestionada muestra primero la organización y, a continuación, las restricciones y preferencias gestionadas proporcionadas. La pantalla es informativa y no permite modificar los valores gestionados.

Pantalla informativa de Configuración gestionada activa con los datos de contacto de la organización, las restricciones y las preferencias gestionadas

Cuando no hay ningún diccionario, los usuarios pueden abrir Acerca de la configuración de app gestionada desde los ajustes de Protección de la app. Que esa vista muestre un estado desactivado no significa que falte un perfil de configuración VPN; ambos canales de despliegue son independientes.