S'applique à : LOQED Touch et LOQED Pure.
Utilisez cet article pour connecter une serrure intelligente LOQED à Home Assistant. Il est destiné aux utilisateurs qui exécutent déjà Home Assistant et comprennent les intégrations de réseaux locaux.
Selon votre modèle et votre configuration, les mises à jour d'état peuvent faire référence au LOQED Bridge ou à la passerelle. Certaines captures d'écran plus anciennes peuvent encore afficher la dénomination de l'ère Touch.
Contrôlez votre serrure intelligente LOQED avec Home Assistant (HASS).
Fonctionnalités prises en charge
Verrouillez/déverrouillez/ouvrez votre serrure intelligente LOQED
Prenez des mesures lorsque le verrou est verrouillé/déverrouillé/ouvert.
"ID de clé locale" utilisé pour la dernière fois lorsque le verrou est verrouillé/déverrouillé/ouvert. Chaque ID correspond à une clé LOQED unique. Notez que lorsque vous supprimez une clé et en créez une nouvelle, les identifiants de clé locale sont réutilisés.
Futur : l'API cloud LOQED peut connecter l'adresse e-mail d'un utilisateur à un identifiant de clé locale, mais cette fonctionnalité n'est pas encore disponible dans l'intégration.
L'intégration a été créée par la communauté et n'est pas officiellement prise en charge par LOQED. Cependant, nous avons l'intention de vous aider si vous avez des questions.
Sécurité
Cette intégration utilise l'API du pont local. Pendant le processus de configuration, l'API Web est utilisée pour créer une clé. L'API Web ne stockera pas votre clé.
Lorsque le LOQED Bridge envoie une mise à jour d'état au HASS, il inclut une signature numérique. Même si une connexion non sécurisée (non HTTPS) est utilisée, comme c'est généralement le cas sur un réseau interne, cela signifie que les informations ne peuvent pas être modifiées (mais que le contenu peut être lu).
Mise en place
1. Assurez-vous que vous exécutez au moins Home Assistant 2023.7.0
Cette version prend en charge « l'ouverture », le « déverrouillage » et le « verrouillage » d'un verrou (au lieu de simplement « déverrouiller » et « verrouiller ») et prend en charge LOQED.
2. Assurez-vous qu'aucun ancien webhook n'existe dans le LOQED Bridge.
Avez-vous déjà installé une quelconque intégration et LOQED ? Veuillez ensuite vous assurer qu'il n'y a pas d'anciens webhooks définis dans le LOQED Bridge, pointant vers une ancienne installation HASS. Cela pourrait rendre la réception de la mise à jour de l'état du verrou plus lente, voire ne pas fonctionner du tout. Connectez-vous simplement sur app.loqed.com, rendez-vous dans la rubrique « Webhooks sortants via LOQED » Pont", et cliquez sur le bouton à côté du pont. Si vous voyez un avertissement concernant la politique réseau CORS, désactivez temporairement cet indicateur dans votre navigateur, redémarrer votre navigateur et réessayez. Ensuite, supprimez tous les webhooks que vous voyez. Le pont est désormais exempt de webhooks et vous pouvez réinstaller l'intégration HASS, ce qui créera une nouvelle entrée.
Vous trouverez ci-dessous une capture d'écran d'un LOQED Bridge avec une entrée de webhook (comme il se doit, après l'intégration LOQED pour HASS est correctement installée).
3. Assurez-vous que vos URL Home Assistant sont correctement définies
Lorsque l'état du verrouillage change, le LOQED Bridge publie des données sur votre URL Home Assistant. L'intégration préfère l'URL interne à l'URL externe. Vous pouvez définir les URL dans Paramètres -> Système -> Réseau, sous la rubrique « URL Home Assistant ».
Dans le cas où une URL HTTPS est utilisée, le LOQED Bridge valide le certificat (assurez-vous qu'il est valide !). L'intégration vérifie toujours une signature numérique des données publiées par le pont. Ainsi, même si une connexion non sécurisée est utilisée, personne ne peut envoyer de fausses données au HASS sur l'état de la porte.
Avec les paramètres ci-dessous (Home Assistant version 2023.6.3), les intégrations utiliseront "http://homeassistant.local:8123" comme URL. Si vous définissez "Réseau local" sur automatique, l'intégration utilise 'https://MYSUB.duckdns.org» (ce qui ne nous semble pas logique non plus).
⚠️ Si vous utilisez HTTPS, nous vous recommandons fortement d'utiliser le « proxy SSL NGINX Home Assistant » avec « Let's Encrypt ». Si vous installez des certificats TLS sans utiliser de serveur proxy, l'URL HASS interne utilisera également les certificats TLS, mais comme le nom d'hôte interne ne figure pas sur le certificat TLS, le LOQED Bridge ne se connectera pas pour des raisons de sécurité. TLDR ; assurez-vous que vous pouvez vous connecter à votre nom d'hôte interne sans aucun avertissement de certificat TLS (donc sans HTTPS).
4. Générez un jeton d'accès personnel
Sur le Site Web de jeton d'accès personnel LOQED, veuillez suivre les étapes suivantes :
Connectez-vous avec votre adresse e-mail de l'application LOQED (vous devez être administrateur)
Appuyez sur "Créer"
Donnez un nom à votre token d'accès personnel (celui-ci ne sera pas utilisé plus loin, mais nous vous recommandons quelque chose comme "Home Assistant" pour pouvoir le reconnaître tel qu'utilisé par Home Assistant)
Appuyez sur Enregistrer
Stockez le jeton d'accès dans un endroit où vous pouvez facilement copier/coller, car vous en aurez besoin à l'étape suivante (et il ne sera affiché qu'une seule fois). Notez que vous pouvez utiliser ce jeton pour configurer plusieurs verrous.
Assurez-vous de copier-coller le jeton complet ! Parfois, le double-clic ne copie qu'une partie du jeton.
5. Redémarrez Home Assistant
Le moyen le plus simple d'installer l'intégration consiste à redémarrer HASS après l'installation (vous redémarrez donc plusieurs fois). HASS détectera automatiquement le LOQED Bridge (en utilisant Zero Conf) s'il se trouve dans votre réseau local. L'intégration ne prend actuellement pas en charge les ponts en dehors de votre réseau local.
6. Configurez l'intégration Home Assistant
Allez dans « Paramètres » -> « Appareils et services ». Cliquez sur le bouton « configurer » de la serrure intelligente détectée automatiquement. Fournissez le jeton d’accès personnel de l’étape précédente.
Non recommandé : Si vous souhaitez installer cette intégration sans redémarrage, vous devez saisir le nom de la clé de votre serrure exactement comme indiqué dans la liste des verrous de l'application LOQED (remarque : ce n'est pas le nom du verrou pour les administrateurs, c'est le nom que vous choisissez vous-même et qui se trouve sur le tout premier écran de l'application LOQED).
Vous pouvez également configurer un verrou manuellement lorsque, pour une raison quelconque, il n'est pas automatiquement détecté. Dans ce cas, vous devez fournir à la fois la clé API de l'étape précédente et le nom du verrou tel qu'il est connu dans l'application compagnon LOQED.
Plus d'informations
Débogage
Tout d’abord, testez si votre jeton d’accès personnel fonctionne
Aller à reqbin.com
Entrez "https://integrations.production.loqed.com/api/locks/" comme URL avec la méthode "GET".
Saisissez « Autorisation : Porteur VOTRE-TOKEN-ICI » comme jeton d'autorisation. Bien sûr, remplacez le mot « VOTRE-TOKEN-ICI » par votre token.
Appuyez sur "Envoyer". Vous devriez récupérer un tableau avec des données telles que dans la capture d'écran ci-dessous.
Débogage dans Home Assistant
Activer la journalisation :
service : logger.set_level
données :
homeassistant.components.loqed : débogage
loqedAPI : débogage