Structure générale d'un profil
Les blocs qui composent un fichier de profil, ce qui est obligatoire et ce qui ne l'est pas.
Vous n’avez pas besoin de cette page pour utiliser l’éditeur : il produit un fichier correct sans que vous ayez à en connaître la forme. Elle sert à relire un fichier reçu, ou à comprendre un message d’erreur.
L’enveloppe
Un fichier de profil est un objet JSON qui porte deux choses : la version du format et le profil lui-même.
Le profil
| Bloc | Obligatoire | Rôle |
|---|---|---|
| identifiant | non, mais déterminant | décide si l’import crée ou met à jour |
| nom | oui | ce qui s’affiche dans la liste des profils |
| type | non | purement descriptif |
| description | non | texte libre |
| identité visuelle | non | nom d’affichage, logo, couleurs |
| jeu de règles | oui | ce qui est réellement surveillé |
Un profil sans nom est refusé. Un profil sans jeu de règles est refusé — mais un jeu de règles vide est accepté : il produit un profil qui s’importe, sans qu’aucune surveillance puisse être démarrée. L’éditeur le signale comme conseil, jamais comme erreur.
Une règle
Chaque règle porte un identifiant unique dans le profil, un contexte, un libellé lisible, une spécification de SSID et un mode d’emplacement. Elle peut porter une saisie d’opérateur.
Les combinaisons que l’application refuse ne sont pas non plus productibles dans l’éditeur :
- un mode « préfixe » sans saisie ;
- une saisie facultative sur un mode « préfixe » ;
- un emplacement « véhicule » sans saisie.
L’identité visuelle
Tout y est facultatif. Les couleurs s’écrivent #RRGGBB ou #AARRGGBB — le
dièse est obligatoire, et les formes courtes comme #ABC sont refusées.
Le logo voyage dans le profil, encodé en texte. C’est ce qui permet d’envoyer un profil en un seul fichier.
| Contrainte du logo | Valeur |
|---|---|
| formats | PNG, JPEG, WebP |
| taille | 256 Kio au maximum |
| cohérence | le contenu doit correspondre au format annoncé |
L’éditeur ne recompresse ni ne redimensionne rien : le faire changerait silencieusement l’image que vous avez choisi de livrer. Une image trop lourde est signalée pour que vous la réduisiez vous-même.
Le fichier de référence
Le dépôt Tibius WiFi contient un profil d’exemple générique, qui exerce chaque variante du format. Le plus simple, pour voir la structure, est de l’ouvrir dans l’éditeur.