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é |
Le jeu de règles porte lui-même trois listes, toutes ordonnées : les contextes (facultatifs), les paramètres (facultatifs) et les règles.
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 libellé lisible et une spécification de SSID. Elle peut porter en plus :
- un contexte, qui la range sous l’un des intitulés que le profil déclare ;
- des paramètres à collecter en plus de ceux que son SSID utilise ;
- une invite d’emplacement, l’intitulé sous lequel demander où la mesure a été prise. Sans elle, Tibius WiFi demande simplement « Emplacement ».
Tout cela est facultatif, et une règle qui ne porte rien de plus qu’un SSID fixe est le cas le plus courant.
Les combinaisons que l’application refuse ne sont pas non plus productibles dans l’éditeur :
- un gabarit qui cite un paramètre que le profil ne déclare pas ;
- un gabarit qui cite un paramètre facultatif — sans valeur, le SSID obtenu ne serait pas celui que la règle décrit ;
- un gabarit dont le texte fixe occupe déjà les 32 octets d’un SSID ;
- un bloc d’emplacement sans intitulé.
Les paramètres
Ce que le profil demande à l’opérateur au démarrage. Ils ont leur propre page : Paramètres d’un profil.
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.