Nest- & Ecobee-Thermostat-OAuth (Betreiber)

Nest- und Ecobee-OAuth in deiner ProbeHarbor-Instanz aktivieren, damit Pro-Haushalte Thermostate als Innenraum-Kontext für Frost- und Leckalarme verbinden.

Nahaufnahme weißer Cat-5e-Ethernet-Kabel mit RJ45-Steckern
Das Fühler-JSON verlässt das LAN meist über Ethernet oder ein nahes Relay, nicht direkt übers öffentliche Internet. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Pro-Haushalte können ein Nest- oder Ecobee-Thermostat verbinden, sodass Innentemperatur und Sollwert im Dashboard neben den Fühlern in Dachboden, Kriechkeller und Werkstatt erscheinen und Frostalarme diesen Zusammenhang mitliefern. Nutzer verbinden sich über Dashboard → Temperature; diese Seite richtet sich an Betreiber, die OAuth auf einer selbst gehosteten oder produktiven Installation aktivieren.

Wann der Verbinden-Button erscheint

Die Thermostat-Karte bleibt ausgeblendet, bis die Installation die Client-Zugangsdaten des Anbieters in den Worker-Secrets hat. Sobald die Secrets hochgeladen sind, sehen Pro-Verwalter für jeden konfigurierten Anbieter Connect.

Nest (Google Device Access)

Weiterleitungs-URI für die Produktion (probeharbor.dev): genau so in die Google Cloud Console kopieren:

https://probeharbor.dev/api/integrations/nest/callback
  1. Lege in der Device Access Console ein Projekt an (einmalige Gebühr).
  2. Erstelle einen Google-Cloud-OAuth-Client (Webanwendung) im selben GCP-Projekt, das mit Device Access verknüpft ist.
  3. Aktiviere in diesem GCP-Projekt die Smart Device Management API (OAuth kann auch ohne sie klappen, Live-Werte liefern aber 403, bis sie aktiv ist).
  4. Trage die Weiterleitungs-URI von oben ein (selbst gehostet: https://YOUR_SITE/api/integrations/nest/callback).
  5. Setze die Worker-Secrets: NEST_CLIENT_ID, NEST_CLIENT_SECRET, NEST_PROJECT_ID (die UUID oben in deinem Device-Access-Projekt, nicht die Google-Cloud-Projektnummer).
  6. Trage die Schlüssel in .env ein und lade sie hoch: pnpm secrets:push

Ecobee

Weiterleitungs-URI für die Produktion:

https://probeharbor.dev/api/integrations/ecobee/callback
  1. Registriere dich im Ecobee-Entwicklerportal.
  2. Erstelle eine App mit der Weiterleitungs-URI von oben (selbst gehostet: https://YOUR_SITE/api/integrations/ecobee/callback).
  3. Setze das Worker-Secret: ECOBEE_CLIENT_ID (Ecobee verwendet kein Client-Secret).
  4. In .env eintragen und pnpm secrets:push ausführen.

Aus Nutzersicht

Jeder Haushalt speichert nach OAuth sein eigenes Refresh-Token; ein gemeinsames globales Thermostat-Token gibt es nicht. Verwalter können die Verbindung im Dashboard trennen; dabei werden die Tokens in der Datenbank widerrufen.

Siehe auch: Integrationsübersicht, ProbeHarbor oder Nest, oder Ecobee.

Häufige Fragen

Welche Thermostate lassen sich mit ProbeHarbor verbinden?
Nest (Google Device Access / SDM), wenn die Worker-Secrets gesetzt sind, und Ecobee, wenn die Entwickler-Registrierung offen ist. Anleitung: probeharbor.dev/about/thermostat-oauth.

Ist Nest für Frostalarme erforderlich?
Nein. Frostalarme nutzen deine Fühler. Nest/Ecobee liefern bei Berechtigung (Pro) zusätzlichen Kontext aus dem Wohnbereich auf Overview.

Was ist, wenn die Entwickler-Registrierung bei Ecobee geschlossen ist?
Nutze Home Assistant → Ingest → Indoor reference unter Dashboard → Devices, damit die Raumtemperatur im Haus trotzdem in deinem Wochendiagramm erscheint.