homeassistant-stelloauth-addon/stelloauth/DOCS.md

Installation og drift

1. Gå til Indstillinger → Tilføjelser → Tilføjelsesbutik → ⋮ → Repositorier, og tilføj præcis https://git.radixadm.dk/dennis/homeassistant-stelloauth-addon.git.

2. Installér Stelloauth, aktivér Start ved opstart og Watchdog, og start derefter add-onen. Installationen bygger et lokalt image fra kilde til den valgte amd64- eller aarch64-arkitektur. Repositoryet publicerer ikke et prebuilt image.

3. Vent, til loggen i denne rækkefølge viser de fem faste readiness-beskeder:

   Cleaning CloakBrowser profiles
   Starting CloakBrowser
   CloakBrowser ready
   Starting Stelloauth
   Stelloauth listening on 0.0.0.0:8080
   

4. Behold host-porten deaktiveret i normal drift. Ved kortvarig fejlfinding kan 8080/tcp tilknyttes host-port 8080. Kontrollér derefter http://192.168.1.20:8080/ eller worker-endpointet http://192.168.1.20:8080/worker, og deaktivér porttilknytningen igen, når kontrollen er færdig. Worker-endpointet modtager MyOpel-oplysninger og har ingen egen autentificering.

5. Åbn konfigurationen af Stellantis Vehicles. Angiv præcis http://0031621f-stelloauth:8080/worker som Login service URL. Integrationen tilføjer ikke /worker; hele stien skal derfor stå i feltet.

6. Vælg Brand: Opel og Country: DK, og gennemfør derefter integrationens OAuth-opsætning med dine MyOpel-oplysninger.

7. Add-onens tre muligheder er:

   • queue_timeout: hvor længe et loginforsøg må vente på den ene session.
   • rate_limit_count: højeste antal loginforsøg i hver periode.
   • rate_limit_duration: længden af rate limit-perioden.

   CLOAK_MAX_SESSIONS er fastlåst til én session, fordi CloakBrowsers gratis niveau tillader ét samtidigt login. Samtidige forsøg bliver derfor køet.

8. Hvert OAuth-forsøg får en midlertidig profil under /tmp/cloakserve. CloakBrowser rydder inaktive browserprocesser efter 30 sekunder, og process manageren rydder gamle profiler ved opstart. Credentials, cookies, tokens og OAuth-koder gemmes ikke i /data. CDP lytter kun på loopback 127.0.0.1:9222, og logs bruger faste, redigerede hændelser uden email, passwords, URLs, koder eller tokens.

9. De målte resultater fra den reelle linux/amd64-kørsel under Rosetta var:

   • Image: 2,571,693,650 bytes (2.571 GB decimal / 2452.56 MiB).
   • Dokumenteret Task 4-måling: 121,5 MiB.
   • Stop: cirka 9.3 sekunder.
   • amd64 runtime bestod under Rosetta; aarch64 build bestod.
   • Mål-HAOS havde ved inspektionen approximately 4 GB free. Den knappe plads sammenholdt med image- og build-lag kan forhindre installationen; frigør plads først. Der er ikke verificeret en vellykket HAOS-installation.

   Der er ikke gennemført et live MyOpel-login. Login-flow RAM: not measured without real MyOpel credentials.

10. Fejlfinding og fjernelse:

    • Mangler en readiness-besked, så se efter timeout: CloakBrowser har 60 sekunder og Stelloauth 30 sekunder. Ret årsagen og genstart add-onen.
    • Et ugyldigt eller ikke-tilladt authorize-URL giver HTTP 400.
    • For mange loginforsøg giver HTTP 429; vent den konfigurerede periode.
    • Hvis repository-URL eller hostname ændres, ændres Supervisor-repository-ID og dermed 0031621f-stelloauth. Beregn og brug den nye interne URL.
    • Ved disk pressure: kontrollér fri plads og fjern unødvendige images eller backups via de normale Supervisor-funktioner før et nyt build.
    • Hvis den interne URL ikke kan nås, brug kun den midlertidige portkontrol fra trin 4 og deaktivér porttilknytningen bagefter.
    • Fjernelse sker i Indstillinger → Tilføjelser → Stelloauth → Afinstallér. Supervisor stopper containeren og fjerner add-onens lokale data; fjern også repositoryet fra Tilføjelsesbutikken, hvis det ikke længere bruges.

Kilder og licenser

Add-on-version 0.1.0 bygger Stelloauth v0.6.0 fra commit 367d4f8c02a3b072c59142c49dffc129edc8548b og bruger det officielle CloakBrowser 0.5.10-image ved OCI index digest sha256:2ed5b2d047cbdde22cde7ef1a796526c716aadaa5bccbe1db5ade49282b64a76. Repositoryets egne filer og patches er MIT-licenserede. CloakBrowsers proprietære binær er fortsat under den separate CloakBrowser Binary License; den er ikke MIT-licenseret eller redistribueret af dette repository.