Se aplica a: LOQED Touch y LOQED Pure.
Utilice este artículo para conectar una cerradura inteligente LOQED a Home Assistant. Está destinado a usuarios que ya ejecutan Home Assistant y comprenden las integraciones de redes locales.
Dependiendo de su modelo y configuración, las actualizaciones de estado pueden referirse al LOQED Bridge o puerta de enlace. Es posible que algunas capturas de pantalla más antiguas aún muestren nombres de la era Touch.
Controla tu cerradura inteligente LOQED con Home Assistant (HASS).
Funciones compatibles
Bloquea/desbloquea/abre tu cerradura inteligente LOQED
Tome medidas cuando la cerradura esté bloqueada/desbloqueada/abierta.
Se utilizó por última vez la "identificación de clave local" cuando el bloqueo estaba bloqueado/desbloqueado/abierto. Cada ID corresponde a una clave LOQED única. Tenga en cuenta que cuando elimina una clave y crea una nueva, los ID de clave local se reutilizan.
Futuro: la API en la nube LOQED puede conectar la dirección de correo electrónico de un usuario a una ID de clave local, pero esta función aún no está disponible en la integración.
La integración fue creada por la comunidad y no cuenta con el respaldo oficial de LOQED. Sin embargo, pretendemos ayudarle si tiene alguna pregunta.
Seguridad
Esta integración utiliza la API del puente local. Durante el proceso de configuración, la API web se utiliza para crear una clave. La API web no almacenará su clave.
Cuando el LOQED Bridge envía una actualización de estado a HASS, incluye una firma digital. Incluso si se utiliza una conexión no segura (no HTTPS), como suele ser el caso en una red interna, esto significa que la información no se puede alterar (pero sí se pueden leer los contenidos).
Instalación
1. Asegúrese de estar ejecutando al menos Home Assistant 2023.7.0
Esta versión admite "abrir", "desbloquear" y "bloquear" un candado (en lugar de simplemente "desbloquear" y "bloquear") y es compatible con LOQED.
2. Asegúrese de que no existan webhooks antiguos en LOQED Bridge.
¿Tenías una instalación previa de algún tipo de integración y LOQED? Luego, asegúrese de que no haya webhooks antiguos configurados en el LOQED Bridge que apunten a una instalación HASS antigua. Esto podría hacer que la recepción de actualizaciones de estado desde la cerradura sea más lenta o no funcione en absoluto. Simplemente inicie sesión en app.loqed.com, vaya al encabezado "Webhooks salientes a través de LOQED puente", y haga clic en el botón al lado del puente. Si ve una advertencia sobre la política de red CORS, desactive temporalmente esta bandera en su navegador. reiniciar su navegador e inténtelo de nuevo. Luego, elimine todos los webhooks que vea. Ahora el puente está libre de webhooks y puede instalar la integración HASS nuevamente, lo que creará una nueva entrada.
A continuación se muestra una captura de pantalla de un LOQED Bridge con una entrada de webhook (como debería ser, después la integración LOQED para HASS está instalada correctamente).
3. Asegúrese de que sus URL Home Assistant estén configuradas correctamente
Cuando cambia el estado de bloqueo, LOQED Bridge publica datos en su URL de Home Assistant. La integración prefiere la URL interna a la externa. Puede configurar las URL en Configuración -> Sistema -> Red, bajo el título "Home Assistant URL".
En caso de que se utilice una URL HTTPS, el LOQED Bridge valida el certificado (¡asegúrese de que sea válido!). La integración siempre verifica una firma digital de los datos que publica el puente, por lo que incluso si se utiliza una conexión no segura, nadie puede enviar datos falsos a HASS sobre el estado de la puerta.
Con la siguiente configuración (Home Assistant versión 2023.6.3), las integraciones utilizarán "http://homeassistant.local:8123" como URL. Si configura "Red local" en automática, la integración utiliza 'https://MYSUB.duckdns.org' (lo que tampoco nos parece lógico).
⚠️ Si utiliza HTTPS, le recomendamos encarecidamente que utilice el "proxy SSL NGINX Home Assistant" con "Let's Encrypt". Si instala certificados TLS sin usar un servidor proxy, la URL HASS interna también usará los certificados TLS, pero como el nombre de host interno no está en el certificado TLS, el LOQED Bridge no se conectará por razones de seguridad. TLDR; asegúrese de poder conectarse a su nombre de host interno sin ninguna advertencia de certificado TLS (por lo tanto, sin HTTPS).
4. Genere un token de acceso personal
en el Sitio web del token de acceso personal LOQED, siga los siguientes pasos:
Inicie sesión con su dirección de correo electrónico de la aplicación LOQED (debe ser administrador)
Toca "Crear"
Asigne un nombre a su token de acceso personal (esto no se usará más adelante, pero recomendamos algo como "Home Assistant" para poder reconocerlo como lo usa Home Assistant)
Toca Guardar
Guarde el token de acceso en algún lugar donde pueda copiarlo y pegarlo fácilmente, ya que los necesitará en el siguiente paso (y solo se mostrará una vez). Tenga en cuenta que puede utilizar este token para configurar múltiples bloqueos.
¡Asegúrese de copiar y pegar el token completo! A veces, hacer doble clic solo copia una parte del token.
5. Reinicie Home Assistant
La forma más sencilla de instalar la integración es reiniciar HASS después de la instalación (por lo tanto, reiniciará varias veces). HASS detectará automáticamente el LOQED Bridge (usando Zero Conf) si está dentro de su red local. Actualmente, la integración no admite puentes fuera de su red local.
6. Configurar la integración Home Assistant
Vaya a "Configuración" -> "Dispositivos y servicios". Haga clic en el botón "configurar" de la cerradura inteligente detectada automáticamente. Proporcione el token de acceso personal del paso anterior.
No recomendado: si desea instalar esta integración sin reiniciar, debe ingresar el nombre de la clave de su cerradura exactamente como se muestra en la lista de bloqueo de la aplicación LOQED (nota: este no es el nombre del bloqueo para los administradores, es el nombre que usted elige y está en la primera pantalla de la aplicación LOQED).
También puedes configurar un bloqueo manualmente cuando por algún motivo no se detecta automáticamente. En ese caso, deberá proporcionar tanto la clave API del paso anterior como el nombre del bloqueo tal como se conoce en la aplicación complementaria LOQED.
Más información
Depuración
Primero, prueba si tu token de acceso personal funciona
Ir a reqbin.com
Ingrese "https://integrations.production.loqed.com/api/locks/" como URL con el método "GET".
Ingrese "Autorización: Portador SU-TOKEN-AQUÍ" como token de autorización. Por supuesto, reemplaza la palabra "TU-TOKEN-AQUÍ" con tu token.
Presione "Enviar". Debería obtener una matriz con datos como los que se muestran en la captura de pantalla siguiente.
Depuración en Home Assistant
Habilitar el registro:
servicio: registrador.set_level
datos:
homeassistant.components.loqed: depurar
loqedAPI: depurar