Opsætning med Xiaomi Home-konto

Denne metode bør bruges, hvis robotstøvsugeren i øjeblikket administreres via Xiaomi Home-applikationen. For at sikre kompatibilitet kan det verificeres mod den officielle Xiaomi Home-app, der er tilgængelig for iOS og Android.

Krav

• Legitimationsoplysninger: Skal være det nøjagtige brugernavn og kodeord, der bruges til at logge ind i mobilapplikationen (ikke den officielle hjemmeside).
• Serverregion: Det valgte land skal matche den region, hvor enheden er registreret i appen. Forkerte regioner vil resultere i fejl som "login mislykkedes" eller "enhed ikke fundet".

Tredjepartslogins

Hvis kontoen blev oprettet ved hjælp af en tredjepartstjeneste (såsom Google eller Apple), skal der først genereres en dedikeret adgangskode i applikationens brugerindstillinger. Adgangskoder til tredjepartskonti kan ikke bruges til godkendelse.

Anbefaling til appvalg

Nogle enheder kan konfigureres enten ved hjælp af Dreamehome- eller Xiaomi Home-applikationen. Medmindre en lokal forbindelse er strengt påkrævet, anbefales det kraftigt at bruge Dreamehome-appen i stedet for Xiaomi Home for understøttede enheder:

• Kamerastream: Kamerastream-funktionen er ikke tilgængelig for enheder, der er konfigureret via Xiaomi Home.
• Push-opdateringer: Dreamehome-forbindelsen bruger Cloud Push til opdateringer i realtid, hvilket eliminerer behovet for periodiske forespørgsler.

Foretræk cloudmulighed

Under konfigurationsprocessen er en ekstra Foretræk Cloud-mulighed tilgængelig og er valgt som standard.

• Når markeret (Standard): Tvinger al kommunikation gennem skyen (hvis det understøttes af enheden). Dette er standardadfærden, fordi Xiaomi på nyere enheder har deaktiveret lokal adgang. Desuden, hvis enheden og Home Assistant befinder sig på forskellige subnet, vil lokal kommunikation mislykkes.
• Når ikke markeret (Anbefales for understøttede opsætninger): Integration henter det krævede token fra skyen, men etablerer en direkte lokal forbindelse med enheden (på lignende måde som Lokal forbindelse-metoden). Dette giver fordelen ved automatisk fornyelse af token og IP, samtidig med at al kommunikation (undtagen kortdata) holdes lokal. Hvis denne metode resulterer i en "kan ikke nå enheden" fejl ved det sidste konfigurationstrin, bør konfigurationen forsøges igen med Foretræk Sky-muligheden markeret.

  Krav til subnet

  Af sikkerhedsmæssige årsager svarer enheden kun på forespørgsler, der stammer fra dens eget subnet. Derfor skal robotstøvsugeren og Home Assistant være på præcis samme subnet for, at lokal kommunikation kan fungere. Se denne python-miio artikel for fejlretning af problemer på tværs af subnet.

Captcha-verifikation

Hvis Xiaomi Home-serverne markerer login-forsøget eller IP-adressen som ikke betroet, vil der være behov for et captcha-verifikationstrin. Når dette sker, skal captcha-billedet løses for at fortsætte til næste trin.

To-faktor-godkendelse (2FA)

Ud over en captcha kan et ikke-betroet login-forsøg også udløse to-faktor-godkendelse (2FA). Integration vil automatisk anmode om en 2FA-kode fra Xiaomi Home-serverne, som sendes til det registrerede telefonnummer (prioriteret) eller e-mailadresse.

Denne kode skal hentes og indtastes i konfigurationstrinnet for at fuldføre login.

2FA begrænsninger

• Kode gyldighed: Hvis konfigurationsvinduet lukkes, og der foretages et nyt loginforsøg, vil en ny 2FA-kode blive genereret. Den senest modtagne kode skal altid bruges.
• Begrænsning af forespørgsler: Xiaomi begrænser strengt antallet af 2FA-koder, der kan anmodes om pr. dag. Gentagne loginforsøg kan resultere i en midlertidig blokering.

Periodiske statusopdateringer

I modsætning til andre cloud-forbindelsesmetoder, der understøtter push-notifikationer, er Xiaomi Home-forbindelsen helt afhængig af baggrundspolling for at hente den nyeste status. For at optimere netværksbrug beregnes polling-intervallet dynamisk baseret på den tid, der er gået siden den sidste statusændring; forespørgsler sendes ofte, mens enheden aktivt kører, men intervallet øges gradvist, efterhånden som mere tid går, mens enheden forbliver inaktiv.

Gen-godkendelse

Integrationen gemmer sikkert en godkendelsestoken efter en vellykket login for at kommunikere med cloudserverne. Hvis denne token udløber eller bliver ugyldiggjort af cloudtjenesten af en eller anden grund, vil Home Assistant automatisk starte en gen-godkendelsesproces og bede om, at kontooplysningerne indtastes igen.