Gilt für: LOQED Touch und LOQED Pure.
Verwenden Sie diesen Artikel, um ein LOQED Smart Lock mit Home Assistant zu verbinden. Es richtet sich an Benutzer, die Home Assistant bereits ausführen und sich mit lokalen Netzwerkintegrationen auskennen.
Abhängig von Ihrem Modell und Setup beziehen sich Statusaktualisierungen möglicherweise auf den LOQED Bridge oder das Gateway. Einige ältere Screenshots zeigen möglicherweise noch Namen aus der Touch-Ära.
Steuern Sie Ihr LOQED Smart Lock mit Home Assistant (HASS).
Unterstützte Funktionen
Sperren/entsperren/öffnen Sie Ihr LOQED Smart Lock
Ergreifen Sie Maßnahmen, wenn das Schloss verriegelt/entriegelt/geöffnet ist.
Zuletzt verwendete „lokale Schlüssel-ID“, wenn das Schloss gesperrt/entsperrt/geöffnet ist. Jede ID entspricht einem eindeutigen LOQED-Schlüssel. Beachten Sie, dass beim Löschen eines Schlüssels und beim Erstellen eines neuen Schlüssel-IDs die lokalen Schlüssel-IDs wiederverwendet werden.
Zukunft: Die LOQED-Cloud-API kann die E-Mail-Adresse eines Benutzers mit einer lokalen Schlüssel-ID verbinden, diese Funktion ist jedoch noch nicht in der Integration verfügbar.
Die Integration wurde von der Community erstellt und wird von LOQED nicht offiziell unterstützt. Wir möchten Ihnen jedoch gerne weiterhelfen, wenn Sie Fragen haben.
Sicherheit
Diese Integration verwendet die lokale Bridge-API. Während des Einrichtungsprozesses wird die Web-API verwendet, um einen Schlüssel zu erstellen. Die Web-API speichert Ihren Schlüssel nicht.
Wenn LOQED Bridge eine Statusaktualisierung an HASS sendet, enthält diese eine digitale Signatur. Selbst wenn eine unsichere Verbindung (nicht HTTPS) verwendet wird, wie es in einem internen Netzwerk normalerweise der Fall ist, können die Informationen nicht verändert (die Inhalte jedoch gelesen) werden.
Installation
1. Stellen Sie sicher, dass Sie mindestens Home Assistant 2023.7.0 ausführen
Diese Version unterstützt das „Öffnen“, „Entsperren“ und „Sperren“ eines Schlosses (anstatt nur „Entsperren“ und „Sperren“) und unterstützt LOQED.
2. Stellen Sie sicher, dass keine alten Webhooks im LOQED Bridge vorhanden sind
Hatten Sie zuvor eine Integration jeglicher Art und LOQED installiert? Stellen Sie dann sicher, dass im LOQED Bridge keine alten Webhooks festgelegt sind, die auf eine alte HASS-Installation verweisen. Dies könnte dazu führen, dass der Empfang von Statusaktualisierungen vom Schloss langsamer wird oder überhaupt nicht funktioniert. Melden Sie sich einfach bei app.loqed.com an und gehen Sie zur Überschrift „Ausgehende Webhooks über LOQED“. Brücke", und klicken Sie auf die Schaltfläche neben der Brücke. Wenn Sie eine Warnung zur CORS-Netzwerkrichtlinie sehen, deaktivieren Sie diese Markierung vorübergehend in Ihrem Browser. neu starten Ihren Browser und versuchen Sie es erneut. Löschen Sie dann alle angezeigten Webhooks. Jetzt ist die Bridge frei von Webhooks und Sie können die HASS-Integration erneut installieren, wodurch ein neuer Eintrag erstellt wird.
Unten ist ein Screenshot eines LOQED Bridge mit einem Webhook-Eintrag (wie es sein sollte, danach die LOQED-Integration für HASS ist ordnungsgemäß installiert).
3. Stellen Sie sicher, dass Ihre Home Assistant-URLs richtig eingestellt sind
Wenn sich der Sperrstatus ändert, sendet LOQED Bridge Daten an Ihre Home Assistant-URL. Die Integration bevorzugt die interne URL gegenüber der externen. Sie können die URLs unter Einstellungen -> System -> Netzwerk unter der Überschrift „Home Assistant URL“ festlegen.
Falls eine HTTPS-URL verwendet wird, validiert LOQED Bridge das Zertifikat (stellen Sie sicher, dass es gültig ist!). Die Integration verifiziert immer eine digitale Signatur der von der Bridge geposteten Daten, sodass selbst bei Verwendung einer unsicheren Verbindung niemand gefälschte Daten über den Türstatus an HASS senden kann.
Mit den folgenden Einstellungen (Home Assistant Version 2023.6.3) verwenden die Integrationen „http://homeassistant.local:8123" als URL. Wenn Sie „Lokales Netzwerk“ auf „Automatisch“ einstellen, verwendet die Integration „https://MYSUB.duckdns.org' (was uns auch nicht logisch erscheint).
⚠️ Wenn Sie HTTPS verwenden, empfehlen wir Ihnen dringend, den „NGINX Home Assistant SSL-Proxy“ mit „Let’s Encrypt“ zu verwenden. Wenn Sie TLS-Zertifikate installieren, ohne einen Proxyserver zu verwenden, verwendet die interne HASS-URL auch die TLS-Zertifikate. Da sich der interne Hostname jedoch nicht auf dem TLS-Zertifikat befindet, stellt LOQED Bridge aus Sicherheitsgründen keine Verbindung her. TLDR; Stellen Sie sicher, dass Sie sich ohne TLS-Zertifikatwarnungen (also ohne HTTP) mit Ihrem internen Hostnamen verbinden könnenS).
4. Generieren Sie ein persönliches Zugriffstoken
Auf der LOQED Website für persönliche Zugriffstoken, befolgen Sie bitte die folgenden Schritte:
Melden Sie sich mit Ihrer LOQED-App-E-Mail-Adresse an (Sie müssen Administrator sein)
Tippen Sie auf „Erstellen“
Geben Sie Ihrem persönlichen Zugriffstoken einen Namen (dieser wird im Folgenden nicht mehr verwendet, wir empfehlen jedoch etwas wie „Home Assistant“, damit Sie ihn als von Home Assistant verwendet erkennen können)
Tippen Sie auf Speichern
Speichern Sie das Zugriffstoken an einem Ort, von dem Sie es einfach kopieren/einfügen können, da Sie es im nächsten Schritt benötigen (und es wird nur einmal angezeigt). Beachten Sie, dass Sie diesen Token zum Einrichten mehrerer Sperren verwenden können.
Stellen Sie sicher, dass Sie das vollständige Token kopieren und einfügen! Durch einen Doppelklick wird manchmal nur ein Teil des Tokens kopiert.
5. Starten Sie Home Assistant neu
Der einfachste Weg, die Integration zu installieren, besteht darin, HASS nach der Installation neu zu starten (Sie führen also mehrere Neustarts durch). HASS erkennt LOQED Bridge automatisch (mittels Zero Conf), wenn es sich in Ihrem lokalen Netzwerk befindet. Die Integration unterstützt derzeit keine Bridges außerhalb Ihres lokalen Netzwerks.
6. Konfigurieren Sie die Home Assistant-Integration
Gehen Sie zu „Einstellungen“ -> „Geräte & Dienste“. Klicken Sie auf die Schaltfläche „Konfigurieren“ des automatisch erkannten Smart Locks. Geben Sie das persönliche Zugriffstoken aus dem vorherigen Schritt an.
Nicht empfohlen: Wenn Sie diese Integration ohne Neustart installieren möchten, müssen Sie den Schlüsselnamen Ihres Schlosses eingeben genau wie in der Sperrenliste der LOQED-App angezeigt (Hinweis: Dies ist nicht der Name der Sperre für Administratoren, sondern der Name, den Sie selbst wählen und der auf dem allerersten Bildschirm der LOQED-App angezeigt wird).
Sie können eine Sperre auch manuell einrichten, wenn sie aus irgendeinem Grund nicht automatisch erkannt wird. In diesem Fall müssen Sie sowohl den API-Schlüssel aus dem vorherigen Schritt als auch den Namen der Sperre angeben, wie er in der Begleit-App LOQED bekannt ist.
Weitere Informationen
Debuggen
Testen Sie zunächst, ob Ihr persönlicher Zugangstoken funktioniert
Gehe zu reqbin.com
Geben Sie „https://integrations.production.loqed.com/api/locks/" als URL mit der Methode „GET“.
Geben Sie als Autorisierungstoken „Authorization: Bearer YOUR-TOKEN-HERE“ ein. Ersetzen Sie natürlich das Wort „YOUR-TOKEN-HERE“ durch Ihren Token.
Drücken Sie „Senden“. Sie sollten ein Array mit Daten wie im folgenden Screenshot zurückerhalten.
Debuggen in Home Assistant
Protokollierung aktivieren:
Dienst: logger.set_level
Daten:
homeassistant.components.loqed: debuggen
loqedAPI: debuggen