OAuth des thermostats Nest et Ecobee (opérateurs)

Activez l’OAuth Nest et Ecobee sur votre déploiement ProbeHarbor pour que les foyers Pro relient leurs thermostats et enrichissent les alertes.

Gros plan de câbles Ethernet Cat-5e blancs avec connecteurs RJ45
Le JSON des sondes quitte généralement le LAN par Ethernet ou via un relais proche, pas directement par Internet. Photo : DiscDepotDundee.co.uk. CC BY-SA 4.0

Les foyers Pro peuvent connecter un thermostat Nest ou Ecobee pour afficher la température intérieure et la consigne à côté des sondes des combles, du vide sanitaire et de l’atelier dans le tableau de bord, et enrichir les alertes gel de ce contexte. Les utilisateurs se connectent depuis Dashboard → Temperature ; cette page s’adresse à l’exploitant du site qui active OAuth sur une instance auto-hébergée ou de production.

Quand le bouton de connexion apparaît

La carte du thermostat reste masquée tant que le déploiement ne dispose pas des identifiants client du fournisseur dans les secrets du Worker. Une fois les secrets envoyés, les gestionnaires Pro voient Connect pour chaque fournisseur configuré.

Nest (Google Device Access)

URI de redirection de production (probeharbor.dev) : à copier telle quelle dans Google Cloud Console :

https://probeharbor.dev/api/integrations/nest/callback
  1. Créez un projet dans la Device Access Console (frais uniques).
  2. Créez un client OAuth Google Cloud (application Web) dans le même projet GCP que celui associé à Device Access.
  3. Activez la Smart Device Management API dans ce projet GCP (OAuth peut réussir sans elle, mais les mesures en direct renverront une erreur 403 tant qu’elle n’est pas activée).
  4. Ajoutez l’URI de redirection ci-dessus (auto-hébergé : https://YOUR_SITE/api/integrations/nest/callback).
  5. Définissez les secrets du Worker : NEST_CLIENT_ID, NEST_CLIENT_SECRET, NEST_PROJECT_ID (l’UUID affiché en haut de votre projet Device Access, pas le numéro de projet Google Cloud).
  6. Ajoutez les clés à .env et envoyez-les : pnpm secrets:push

Ecobee

URI de redirection de production :

https://probeharbor.dev/api/integrations/ecobee/callback
  1. Inscrivez-vous sur le portail développeur Ecobee.
  2. Créez une application avec l’URI de redirection ci-dessus (auto-hébergé : https://YOUR_SITE/api/integrations/ecobee/callback).
  3. Définissez le secret du Worker : ECOBEE_CLIENT_ID (Ecobee n’utilise pas de secret client).
  4. Ajoutez-le à .env et lancez pnpm secrets:push.

Côté utilisateur

Chaque foyer conserve son propre jeton d’actualisation après OAuth ; il n’existe pas de jeton de thermostat global partagé. Les gestionnaires peuvent se déconnecter depuis le tableau de bord ; les jetons sont alors révoqués dans la base de données.

Voir aussi : hub des intégrations, ProbeHarbor ou Nest, ou Ecobee.

FAQ

Quels thermostats se connectent à ProbeHarbor ?
Nest (Google Device Access / SDM) quand les secrets du Worker sont définis, et Ecobee quand l’inscription développeur est ouverte. Guide : probeharbor.dev/about/thermostat-oauth.

Nest est-il nécessaire pour les alertes de gel ?
Non. Les alertes de gel s’appuient sur vos sondes. Nest/Ecobee ajoutent le contexte intérieur du logement dans Overview si votre offre l’inclut (Pro).

Et si l’inscription développeur Ecobee est fermée ?
Utilisez Home Assistant → ingestion → Indoor reference dans Dashboard → Devices pour que la température ambiante de la maison continue de s’afficher sur votre graphique hebdomadaire.