Configuration d’app gérée

Configurez le comportement de Vylos au moyen du canal Apple standard de configuration d’app gérée fourni par votre service de MDM.

Étapes de déploiement

Installez ou attribuez Vylos (io.cbnventures.vylos) en tant qu’app gérée.
Créez un dictionnaire de configuration d’app dans votre service MDM.
Ajoutez uniquement les clés de restriction, de préférence et d’organisation que vous souhaitez gérer.
Attribuez le dictionnaire aux appareils ou utilisateurs concernés.
Lancez Vylos ou remettez l’app au premier plan, puis vérifiez les valeurs dans Configuration gérée.

La suppression d’une clé de préférence facultative rend le contrôle de ce réglage à l’utilisateur. La suppression du dictionnaire complet désactive la configuration d’app gérée après son actualisation par Vylos.

Conditions de distribution

La configuration d’app gérée est un dictionnaire attribué par le MDM à l’app Vylos (io.cbnventures.vylos). Vylos le lit à l’emplacement Apple standard com.apple.configuration.managed.

Ce dictionnaire n’est pas un fichier .mobileconfig installable et ne peut pas être injecté en ouvrant un profil sur l’appareil. Utilisez les profils .mobileconfig lorsque vous devez installer un tunnel VPN géré.

Selon votre MDM, cette fonction peut s’appeler Configuration d’app gérée, Configuration d’app, Réglages d’app personnalisés ou Réglages d’app gérée. Vylos doit être installé ou attribué en tant qu’app gérée pour qu’iOS, macOS ou visionOS puisse lui transmettre le dictionnaire.

Clés prises en charge

Restrictions

Clé	Type	Valeur par défaut	Rôle
`allowManualTunnels`	Booléen	`true`	Autorise les tunnels créés par l’utilisateur et les actions permettant de les créer, modifier ou activer.
`allowSettings`	Booléen	`true`	Autorise l’accès aux réglages Vylos.
`blockJailbrokenDevices`	Booléen	`false`	Bloque complètement Vylos lorsque la détection de jailbreak est positive sous iOS.

Consultez Gérer les restrictions pour le comportement complet de chaque restriction et Appliquer la politique de jailbreak pour le cycle de blocage complet.

Préférences gérées

Clé	Type	Valeurs acceptées	Effet
`notificationsEnabled`	Booléen	`true`, `1`, `false` ou `0`	Remplace le réglage principal des notifications Vylos et celui des quatre types de notification de déconnexion. Ne peut pas accorder l’autorisation système Apple ; si les notifications sont activées alors que les réglages de l’app sont bloqués, Vylos demande cette autorisation depuis l’écran d’accueil.
`appearance`	Chaîne	`system`, `light` ou `dark`	Impose l’apparence sous iOS et macOS. visionOS affiche la valeur fournie pour que l’administrateur puisse la vérifier, mais continue d’utiliser le verre adaptatif du système.
`appIcon`	Chaîne	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest` ou `obsidian`	Impose une autre icône d’app sous iOS. macOS et visionOS affichent la valeur fournie pour que l’administrateur puisse la vérifier, sans modifier leur icône.

Vylos conserve les choix précédents de l’utilisateur et les restaure lorsque l’administrateur supprime le remplacement correspondant. Une clé facultative absente ou incorrecte laisse la préférence sous le contrôle de l’utilisateur, même si d’autres clés gérées restent actives.

La langue n’est pas une préférence gérée par Vylos. Les utilisateurs et administrateurs sélectionnent la langue de l’app avec les commandes de langue par app du système d’exploitation.

Réglages Vylos affichant les préférences gérées Protection de l’app, Icône de l’app, Apparence et Notifications

Informations sur l’organisation

Clé	Type	Libellé affiché
`companyName`	Chaîne	Entreprise
`contactEmail`	Chaîne	E-mail
`contactPhone`	Chaîne	Téléphone
`contactAddress`	Chaîne	Adresse

Vylos supprime les espaces au début et à la fin et masque les valeurs d’organisation vides. Les valeurs fournies apparaissent dans Configuration gérée afin que les utilisateurs sachent qui gère l’app et comment demander de l’aide.

Valeurs booléennes

Vylos accepte des booléens, des nombres ou des chaînes, car les produits MDM sérialisent différemment les valeurs de configuration. Chaque valeur est convertie en chaîne, débarrassée de ses espaces périphériques et comparée sans tenir compte de la casse.

true et 1 signifient vrai.
false et 0 signifient faux.
Une restriction absente utilise sa valeur par défaut documentée.
Une préférence absente ou incorrecte laisse le réglage de l’utilisateur en vigueur.

Par exemple, " False ", "FALSE" et le nombre 0 sont tous interprétés comme faux. Une valeur telle que "yes" est incorrecte et n’active pas silencieusement une clé.

Priorité de la configuration

Une préférence gérée valide remplace le réglage manuel correspondant tant que sa clé est présente. Vylos conserve séparément le choix de l’utilisateur au lieu de l’écraser.

Les restrictions sont évaluées indépendamment. La présence d’une clé gérée ne modifie pas les valeurs par défaut des clés omises.

Toute configuration gérée non vide contourne l’étape d’authentification du verrouillage intégré de Vylos. Les restrictions gérées restent actives : allowManualTunnels=false suspend les tunnels créés par l’utilisateur et refuse leurs raccourcis enregistrés, tandis que allowSettings=false continue de bloquer les réglages.

Moment de l’actualisation

Vylos lit le dictionnaire géré au lancement de l’app et chaque fois que sa scène revient au premier plan ou devient active. La suppression du dictionnaire restaure les préférences contrôlées par l’utilisateur lors de l’actualisation suivante.

Ce moment est indépendant de l’actualisation de l’état et des statistiques des tunnels. Dès qu’un tunnel géré apparaît dans Vylos, sa vue détaillée ouverte actualise les statistiques en direct toutes les secondes, comme pour un tunnel créé par l’utilisateur. Un profil VPN nouvellement installé ou remplacé peut apparaître plus tard, car Apple publie les profils gérés selon son propre calendrier ; consultez Déployer des tunnels gérés pour ce comportement.

Exemple complet

Collez le dictionnaire de liste de propriétés suivant dans l’éditeur de configuration d’app de votre MDM, ou saisissez les clés équivalentes dans son formulaire clé-valeur :

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>

L’exemple applique la stratégie suivante :

Clé	Valeur d’exemple	Résultat dans Vylos
`allowManualTunnels`	`false`	Masque et suspend les tunnels créés par l’utilisateur, puis empêche leur utilisation. Les tunnels gérés restent disponibles.
`allowSettings`	`false`	Bloque la zone Réglages de l’app.
`blockJailbrokenDevices`	`true`	Sous iOS, bloque Vylos et ses tunnels lorsqu’un jailbreak est détecté.
`notificationsEnabled`	`true`	Active le réglage principal des notifications Vylos et les quatre types de notification.
`appearance`	`dark`	Force l’apparence sombre sous iOS et macOS ; visionOS enregistre la valeur, mais conserve le verre adaptatif du système.
`appIcon`	`ocean`	Sélectionne l’icône Ocean sous iOS ; macOS et visionOS affichent uniquement la valeur gérée.
`companyName`	`Example Company`	Nomme l’organisation gestionnaire dans Configuration gérée.
`contactEmail`	`it@example.com`	Affiche l’adresse e-mail d’assistance de l’organisation.
`contactPhone`	`+1 (212) 555-0100`	Affiche le numéro de téléphone d’assistance.
`contactAddress`	Adresse d’exemple	Affiche l’adresse postale de l’organisation.

Supprimez toute clé facultative que votre organisation ne souhaite pas contrôler. N’envoyez pas une chaîne vide pour rendre une préférence à l’utilisateur ; supprimez la clé.

Éditeurs clé-valeur MDM

Respectez exactement l’orthographe et le type indiqués. Par exemple, ajoutez allowSettings comme booléen plutôt que comme texte "false" si votre MDM prend en charge les champs typés. Vylos accepte aussi les formes booléennes textuelles et numériques documentées pour les consoles qui sérialisent les valeurs différemment.

Ce que voient les utilisateurs

Lorsque la configuration est active, Configuration gérée affiche d’abord l’organisation, puis les restrictions et les préférences gérées fournies. Cet écran est uniquement informatif et ne permet pas de modifier les valeurs gérées.

Écran d’information Configuration gérée active affichant les coordonnées de l’organisation, les restrictions et les préférences gérées

Lorsqu’aucun dictionnaire n’est présent, les utilisateurs peuvent ouvrir À propos de la configuration d’app gérée dans les réglages de protection de l’app. Un état désactivé dans cette vue ne signifie pas qu’un profil de configuration VPN manque : les deux canaux de déploiement sont indépendants.