Jetons d'accès
Laissez un client IA ou une autre app de votre réseau parler à la maison, dans les limites que vous fixez.
Ce qu'est un jeton
Un jeton est une clé pour une app. Chacun a un nom, un usage, une liste de permissions et une expiration facultative, et se révoque seul sans toucher aux autres. Les jetons fonctionnent uniquement sur votre réseau local, et chaque appel effectué avec l'un d'eux est consigné dans Activity.
En créer un
Réglages › Access › + New token.
- À quoi il sert — An AI assistant (MCP) pour Claude, ChatGPT, Cursor ou tout client MCP ; An integration or app pour Home Assistant, Node‑RED, un script ou l'outil d'un installateur appelant l'API locale. Donnez un nom qui dit qui l'utilisera.
- Ce qu'il peut faire — cochez les permissions :
| Permission | Autorise |
|---|---|
| Read devices | Pièces, appareils et leur état actuel |
| Control devices | Allumer, varier, bouger les volets, régler des températures, verrouiller et déverrouiller |
| Run scenes | Lancer des scènes comme Bonne nuit ou Absent |
| Read workflows | Lister les automatisations et voir si elles sont actives |
| Change workflows | Créer, modifier, activer ou désactiver des automatisations |
| Read trends | Énergie, séries d'historique, coûts et météo |
| Live events | Suivre les changements d'état au fil de l'eau |
- Create token. Le secret s'affiche une seule fois : copiez‑le maintenant. Pour un jeton MCP, vous recevez aussi la configuration prête à coller dans le client.
Ce qu'un jeton ne peut jamais faire
Quelles que soient les permissions cochées, un jeton ne donne aucun accès au système de la passerelle, à ses fichiers, aux réglages réseau, aux mises à jour ni aux comptes utilisateurs. Tout cela reste dans l'application web, derrière votre mot de passe.
Gérer
- Revoke arrête un jeton immédiatement ; il reste dans la liste, marqué Revoked, pour que son historique reste lisible. Remove le supprime.
- Activity montre chaque appel : quel jeton, ce qu'il a demandé, depuis quelle adresse, et s'il a été autorisé.
- Fixez une expiration aux jetons remis à des tiers.
Si un secret fuit
Révoquez‑le et créez‑en un nouveau. Rien d'autre à changer.