Geldt voor: LOQED Touch en LOQED Pure.
Gebruik dit artikel om een LOQED slim slot te verbinden met de Home Assistant. Het is bedoeld voor gebruikers die Home Assistant al gebruiken en lokale netwerkintegraties begrijpen.
Afhankelijk van uw model en configuratie kunnen statusupdates betrekking hebben op de LOQED Bridge of gateway. Sommige oudere schermafbeeldingen laten mogelijk nog steeds de naam uit het Touch-tijdperk zien.
Bedien uw LOQED smart lock met Home Assistant (HAS).
Ondersteunde functies
Vergrendel/ontgrendel/open uw LOQED slimme slot
Onderneem actie wanneer het slot vergrendeld/ontgrendeld/geopend is.
Laatst gebruikte "lokale sleutel-ID" toen het slot vergrendeld/ontgrendeld/geopend was. Elke ID komt overeen met een unieke LOQED-sleutel. Houd er rekening mee dat wanneer u een sleutel verwijdert en een nieuwe maakt, de lokale sleutel-ID's opnieuw worden gebruikt.
Toekomst: de LOQED cloud API kan het e-mailadres van een gebruiker koppelen aan een lokale sleutel-ID, maar deze functie is nog niet beschikbaar in de integratie.
De integratie is gemaakt door de community en wordt niet officieel ondersteund door LOQED. Wij willen u echter wel helpen als u vragen heeft.
Beveiliging
Deze integratie maakt gebruik van de lokale bridge-API. Tijdens het installatieproces wordt de web-API gebruikt om een sleutel te maken. De web-API slaat uw sleutel niet op.
Wanneer de LOQED Bridge een statusupdate naar HASS verzendt, wordt deze voorzien van een digitale handtekening. Zelfs als er gebruik wordt gemaakt van een onbeveiligde verbinding (niet-HTTPS), zoals meestal het geval is op een intern netwerk, betekent dit dat de informatie niet kan worden gewijzigd (maar de inhoud wel kan worden gelezen).
Installatie
1. Zorg ervoor dat u minimaal Home Assistant 2023.7.0 gebruikt
Deze versie ondersteunt het 'openen', 'ontgrendelen' en 'vergrendelen' van een slot (in plaats van alleen 'ontgrendelen' en 'vergrendelen'), en heeft ondersteuning voor LOQED.
2. Zorg ervoor dat er geen oude webhooks in de LOQED Bridge bestaan
Had u een eerdere installatie van enige vorm van integratie en LOQED? Zorg er dan voor dat er geen oude webhooks zijn ingesteld in de LOQED Bridge, die verwijzen naar een oude HASS-installatie. Hierdoor kan het ontvangen van de statusupdate van het slot langzamer of helemaal niet werken. Log eenvoudig in op app.loqed.com en ga naar het kopje "Uitgaande webhooks via LOQED Brug", en klik op de knop naast de brug. Als u een waarschuwing ziet over het CORS-netwerkbeleid, schakel dan tijdelijk deze vlag uit in uw browser, opnieuw opstarten uw browser en probeer het opnieuw. Verwijder vervolgens alle webhooks die u ziet. Nu is de bridge vrij van webhooks en kun je de HASS-integratie opnieuw installeren, waardoor er één nieuwe entry ontstaat.
Hieronder ziet u een screenshot van een LOQED Bridge met één webhook-invoer (zoals het zou moeten zijn, na de LOQED-integratie voor HASS correct is geïnstalleerd).
3. Zorg ervoor dat uw Home Assistant-URL's correct zijn ingesteld
Wanneer de vergrendelingsstatus verandert, plaatst de LOQED Bridge gegevens naar uw Home Assistant-URL. De integratie geeft de voorkeur aan de interne URL boven de externe. U kunt de URL's instellen via Instellingen -> Systeem -> Netwerk, onder het kopje "Home Assistant URL".
Als een HTTPS-URL wordt gebruikt, valideert de LOQED Bridge het certificaat (zorg ervoor dat het geldig is!). De integratie verifieert altijd een digitale handtekening van de gegevens die de brug plaatst, dus zelfs als er een onbeveiligde verbinding wordt gebruikt, kan niemand valse gegevens naar HASS sturen over de status van de deur.
Met de onderstaande instellingen (Home Assistant versie 2023.6.3) zullen de integraties gebruik maken van "http://homeassistant.local:8123" als URL. Als u "Lokaal netwerk" instelt op automatisch, gebruikt de integratie 'https://MYSUB.duckdns.org' (wat ons ook niet logisch lijkt).
⚠️ Als u HTTPS gebruikt, raden wij u ten zeerste aan de "NGINX Home Assistant SSL-proxy" met "Let's Encrypt" te gebruiken. Als u TLS-certificaten installeert zonder gebruik te maken van een proxyserver, zal de interne HASS-URL ook de TLS-certificaten gebruiken, maar aangezien de interne hostnaam niet op het TLS-certificaat staat, zal de LOQED Bridge om veiligheidsredenen geen verbinding maken. TLDR; Zorg ervoor dat u verbinding kunt maken met uw interne hostnaam zonder waarschuwingen voor TLS-certificaten (dus zonder HTTPS).
4. Genereer een persoonlijk toegangstoken
Op de LOQED persoonlijke toegangstokenwebsite, volg dan de volgende stappen:
Log in met uw LOQED App-e-mailadres (u moet admin zijn)
Tik op "Maken"
Geef uw persoonlijke toegangstoken een naam (dit wordt verderop niet gebruikt, maar we raden iets als "Home Assistant" aan om het te kunnen herkennen zoals gebruikt door Home Assistant)
Tik op Opslaan
Bewaar het toegangstoken ergens waar u het gemakkelijk kunt kopiëren/plakken, aangezien u het in de volgende stap nodig heeft (en het wordt slechts één keer weergegeven). Houd er rekening mee dat u dit token kunt gebruiken voor het instellen van meerdere sloten.
Zorg ervoor dat u het volledige token kopieert en plakt! Dubbelklikken kopieert soms slechts een deel van het token.
5. Start Home Assistant opnieuw op
De eenvoudigste manier om de integratie te installeren is door HASS na de installatie opnieuw op te starten (u bent dus meerdere keren opnieuw aan het opstarten). HASS zal de LOQED Bridge automatisch detecteren (met behulp van Zero Conf) als deze zich binnen uw lokale netwerk bevindt. De integratie ondersteunt momenteel geen bruggen buiten uw lokale netwerk.
6. Configureer de Home Assistant-integratie
Ga naar "Instellingen" -> "Apparaten en diensten". Klik op de knop "Configureren" van het automatisch gedetecteerde slimme slot. Geef het persoonlijke toegangstoken uit de vorige stap op.
Niet aanbevolen: als u deze integratie wilt installeren zonder opnieuw op te starten, moet u de sleutelnaam van uw slot invoeren precies zoals weergegeven in de vergrendelingslijst van de LOQED App (let op: dit is niet de naam van het slot voor beheerders, het is de naam die je zelf kiest en staat op het allereerste scherm van de LOQED App).
U kunt een vergrendeling ook handmatig instellen als deze om een of andere reden niet automatisch wordt gedetecteerd. In dat geval moet u zowel de API-sleutel uit de vorige stap opgeven als de naam van het slot zoals deze bekend staat in de bijbehorende LOQED-app.
Meer informatie
Foutopsporing
Test eerst of uw persoonlijke toegangstoken werkt
Ga naar reqbin.com
Voer in "https://integrations.production.loqed.com/api/locks/" als URL met de "GET"-methode.
Voer "Autorisatie: Bearer YOUR-TOKEN-HERE" in als autorisatietoken. Vervang uiteraard het woord "UW-TOKEN-HIER" door uw token.
Druk op "Verzenden". U zou een array met gegevens terug moeten krijgen, zoals in de onderstaande schermafbeelding.
Foutopsporing in Home Assistant
Logboekregistratie inschakelen:
service: logger.set_level
gegevens:
homeassistant.components.loqed: debuggen
loqedAPI: debuggen