Zugriff für White Label Solar Manager

[Soardiac]

Dies stammt aus einer Diskussion im Photovoltaikforum. Dort geht es um den Thermondo HEMS, einen White Label Solar Manager und dass die Integration dort nicht (einfach so) funktioniert, weil API-Key-Erstellung und Lokal-Zugriff nicht funktionieren. Ich denke, es gibt für beides Erklärung und Lösung. Ich kenne aber keine White Label Produkte, darum etwas spekulativ hier. Folgendes:

API-Key

„Your user role is not allowed in this app" ist kein Passwortfehler oder sowas. Whitelabel-Kunden liegen offenbar zwar im selben Backend, aber (aus der API Spec abgeleitet) unter einem anderen Mandanten (das User-Objekt der SM-API hat dafür ein Feld oem). web.solar-manager.ch prüft beim Login dann Rolle + App und weist diese Accounts ab. Dein Account ist völlig in Ordnung (die Cloud-API akzeptiert ihn ja, sonst würde die andere Integration nicht laufen). Nur ans Portal-Formular für den Cloud-API-Key-Erstellung kommst du deshalb nicht ran. Dafür wäre dann Thermondo der richtige Ansprechpartner (nicht Solar Manager). Der Bereich „Cloud-API-Schlüssel" wird auch bei SM oft nur auf Anfrage freigeschaltet.

Aber du brauchst den Key aktuell nicht. Meine Integration funktioniert im Cloud-Modus auch mit E-Mail + Passwort + smId, das API-Key-Feld einfach leer lassen. Solar Manager unterstützt diesen Weg offiziell bis 30.06.2027. Weil SM den Wechsel angekündigt hat, habe ich es schon mal in der Integration umgesetzt, aber optional. <-- Der letzte Teil war falsch, ich habe es mit v1.11.0 angepasst, dass es wirklich optional ist.

Die smId bekommst du ohne Portal so:

Zuerst authentifizieren (ganzer Code Block copy&paste&enter in PowerShell, Email/Passwort richtig einsetzen!):

$login = Invoke-RestMethod -Method Post -Uri https://cloud.solar-manager.ch/v1/oauth/login `
  -ContentType 'application/json' `
  -Body (@{ email = 'DeineEmail'; password = 'DeinPasswort' } | ConvertTo-Json)
$h = @{ Authorization = "Bearer $($login.accessToken)" }

Dann Werte auslesen (ganzer Block copy&paste&enter, inkl. letzte Leerzeile, sonst 2x enter):

$user = Invoke-RestMethod -Uri https://cloud.solar-manager.ch/v1/users -Headers $h
$user | Select-Object sm_id, license, oem, firmware_version, status
$smId = @($user)[0].sm_id
$gw = Invoke-RestMethod -Uri "https://cloud.solar-manager.ch/v1/info/gateway/$smId" -Headers $h
$gw.gateway | Select-Object sm_id, ip, mac, firmware, signal
$gw.gateway.localWebServer | Format-List

In der Antwort stehen sm_id (das ist die Gateway-ID für die Integration), license, oem und die lokale IP.

Zum lokalen Modus

Die lokale REST-API ist am Gateway per Default deaktiviert und wird normalerweise im Web-Portal eingeschaltet, welches du als White Label aber eben nicht erreichst. Solange sie aus ist, antwortet auf der Gateway-IP schlicht nichts, daher die Meldung „Verbindung fehlgeschlagen / Gateway erreichbar?". Dazu kommt: In der kostenlosen bzw. Basis-Lizenz ist die lokale API laut Berichten anderer Nutzer gar nicht (mehr) enthalten (<-- das sagt mir Claude, die KI...)

Mit der Abfrage oben wird auch httpEnabled, httpsEnabled und apiKeys angezeigt. Steht dort httpEnabled: false und httpsEnabled: false, ist der lokale Modus bei dir schlicht nicht freigeschaltet, dann hilft nur eine Anfrage bei Thermondo. Oder du kannst das irgendwie aktivieren, ich kenne wie gesagt Thermondo nicht. Steht dort true, dann trag genau die gemeldete IP, das passende Protokoll und ggf. den apiKey in der Integration ein (ein abweichender Port lässt sich in der Integration als zB 192.168.1.100:8080 im Host-Feld mitgeben).

[Soardiac]

Ich habe festgestellt, dass das ohne API-Key doch nicht ging, ich hatte nicht mit White Label gerechnet.... Ich habe in v1.11.0 nun alle Felder optional gestaltet : Email, Passwort, Key. Es sollte damit also gehen, auch ohne ApiKey eine Cloud-Verbindung herzustellen.