Secrets
Le coffre de l’organisation — jetons, mots de passe et clés d’API, chiffrés au repos et jamais réaffichés
Réglages › Secrets est le coffre de l’organisation : jetons, mots de passe et clés d’API, chiffrés au repos. La page liste chaque secret avec ce qui l’utilise, mais une valeur n’est plus jamais affichée une fois enregistrée : on ne peut que la remplacer.
Ce qui va dans le coffre
Tout identifiant dont PneX a besoin pour appeler un service en votre nom :
- les clés d’API des fournisseurs LLM, utilisées par l’assistant IA et par les nœuds IA des flows ;
- les identifiants des canaux de notification : jetons ntfy, bots Telegram, URL de webhook Slack et Discord, mots de passe SMTP, secrets de webhook (Notifications) ;
- les clés d’API des fournisseurs géo : fond de carte, géocodeur, calcul d’itinéraire (Carte) ;
- l’authentification et le proxy des nœuds Requête HTTP des flows ;
- les mots de passe WiFi utilisés pour compiler le firmware des appareils ;
- les secrets d’accès des flux audio : en-têtes ou
utilisateur:mot de passed’une radio, d’un flux en direct ou d’une caméra IP (Flux audio).
Un flow conserve une référence au secret, jamais sa valeur. Les nœuds Fonction (JavaScript ou Starlark) n’ont pas accès aux secrets.
La page Secrets
- Nouveau secret : un Nom (par exemple
telegram-astreinte), une Description facultative et la Valeur. - Modifier : renommer, changer la description, ou saisir une Nouvelle valeur (laisser vide pour conserver l’actuelle).
- Supprimer, puis Confirmer ?. La suppression est refusée tant que le secret est utilisé : retirez-le d’abord de ce qui s’en sert.
- Rechercher un secret… filtre la liste.
- La colonne Utilisé par renvoie vers chaque usage : un canal de notification, un flow, un WiFi, un fournisseur LLM, un flux média, un fournisseur géo. Inutilisé veut dire que rien n’y fait référence.
Les champs secrets des autres formulaires
Les formulaires qui demandent un identifiant affichent un champ secret à deux modes :
- Saisir une valeur : crée ou remplace un secret dédié, nommé d’après son emplacement ;
- Choisir un secret existant : réutilise un secret de l’organisation.
Un Member qui ouvre un tel formulaire voit « Non défini — seul un owner ou un admin peut attacher un secret à ce champ. » ou le nom du secret déjà attaché, qu’il conserve en enregistrant.
Rôles
| Rôle | Ce qu’il peut faire |
|---|---|
| Owner, Admin | Créer, modifier, supprimer et attacher des secrets |
| Member | Conserver les secrets déjà attachés à ce qu’il modifie ; jamais en choisir ni en attacher |
| Viewer | Voir les noms seulement |
Personne, Owners compris, ne peut relire une valeur.
Un secret est aussi lié à sa destination. Une fois attaché à un nœud HTTP, un webhook, un serveur ntfy ou un serveur SMTP, un Member ne peut ni faire pointer ce nœud ou ce canal vers une autre adresse (hôte, port ou schéma), ni attacher le secret ailleurs, ni le copier dans un autre flow. Changer seulement le chemin ou les paramètres d’une URL reste permis. Un Owner ou un Admin fait le déplacement, et le secret suit.
Bon à savoir
- Une valeur modifiée atteint les flows à leur prochain déploiement, pas en direct.
- Changer un mot de passe WiFi ne recompile pas les firmwares : les appareils déjà flashés gardent l’ancien jusqu’à leur reflash.
- La clé d’un fond de carte fait exception au « jamais réaffiché » : le navigateur charge lui-même les tuiles, la clé part donc dans le navigateur de chaque membre. Restreignez-la à votre adresse PneX dans la console du fournisseur. Les clés de géocodage et d’itinéraire ne quittent jamais le serveur.