🔐 Misco-LB

Latch + Blink: Integración de Seguridad para Cámaras Blink

Este proyecto permite automatizar y securizar la activación y desactivación de una cámara Blink mediante Latch y Alexa.

---

🚀 Flujo de Funcionamiento

1️⃣ Mediante Herramienta de Localización detecto que llegaste o te fuiste de casa y envía un webhook a Misco-LB.
2️⃣ Misco-LB llama a Latch para bloquear/desbloquear la operación.
3️⃣ Latch notifica a Misco-LB el cambio de estado.
4️⃣ Misco-LB llama al Ayudante Binario de Home Assistant, que a través de Alexa activa o desactiva la cámara.

---

📌 Requisitos Previos

✅ Cuenta en Latch y acceso al portal de desarrolladores.
✅ Home Assitant con un Interruptor detectado con Alexa.
✅ Alexa configurada con una rutina que arma y desarma la cámara Blink con los cambios del Interruptor.
✅ Python 3 y Ngrok instalado en tu sistema.

---

🛠 Configuración Paso a Paso

1️⃣ Configurar Latch

🔹 Crear una Aplicación en Latch

1. Accede a Latch Developer Portal.
2. Crea una nueva aplicación y obtén:
   • LATCH_APP_ID
   • LATCH_SECRET_KEY
3. Añade una operación llamada "Control Cámara" y guarda su CONTROL_CAMARA_ID.

🔹 Configurar el Webhook en Latch

1. En el panel de desarrolladores de Latch, busca la opción "Webhooks".
2. Introduce la URL del Misco-LB: https://TU_DOMINIO_O_IP/latch_webhook

• Si estás en localhost, usa ngrok para exponer Misco-LB:

  ngrok http 3000

---

2️⃣ Configurar Herramienta de localización

🔹 En este caso, puedes usar Automate o IFTTT para que me geolocalice, y llamar al webhook.

1. En tu herramienta de localización, configura el siguiente webhook cuando salgas de la zona de tu casa:

curl -X POST "http://TU_DOMINIO_O_IP/webhook" -H "Content-Type: application/json" -d '{"action": "left"}'

2. En tu herramienta de localización, configura el siguiente webhook cuando entres en la zona de tu casa:

curl -X POST "http://TU_DOMINIO_O_IP/webhook" -H "Content-Type: application/json" -d '{"action": "arrived"}'

---

3️⃣ Configurar Home Assistant

🔹 Necesitas un Access Token de Home Asitant para autenticarte.

1. Dentro de Home Assistant, ve a Configuracion, Usuarios, y obtén un Token de larga duración
   • HOMEASSISTANT_TOKEN
2. Crea un Ayudante Binario llamado activate_cam, para usar como activador de la Rutina de Alexa que activa la camara y apunta sus URLs
   • HOMEASSISTANT_URL_ACTIVATE = "http://URL_HOMEASSISTANT:8123/api/services/input_boolean/turn_on"
   • HOMEASSISTANT_URL_DEACTIVATE = "http://URL_HOMEASSISTANT:8123/api/services/input_boolean/turn_off"

---

4️⃣ Configurar el Proyecto

🔹 Clona el repositorio y entra en la carpeta

git clone https://github.com/JoaquinRuiz/misco-lb.git
cd misco-lb

🔹 Instala las dependencias

pip install -r requirements.txt

🔹 Crea el archivo .env y añade tus credenciales

touch .env
nano .env

📌 Ejemplo de .env

LATCH_APP_ID = "" 
LATCH_SECRET_KEY = ""
ACCOUNT_ID = ""
CONTROL_CAMARA_ID = ""
HOMEASSISTANT_TOKEN = ""
HOMEASSISTANT_URL_ACTIVATE = ""
HOMEASSISTANT_URL_DEACTIVATE = ""

Cómo Ejecutar el Proyecto

python miscolb.py

Si es la primera vez, Latch pedirá un código de pareado. Genera un código en la app móvil de Latch y parealo con:

curl -X POST "http://localhost:3000/pair" -H "Content-Type: application/json" -d '{"pair_code": "ABC123"}'

🚀 Cómo Probarlo

🔹 Simular que Alexa detecta que has llegado

curl -X POST "http://localhost:3000/webhook" -H "Content-Type: application/json" -d '{"action": "arrived"}'

✔️ Debería bloquear Latch y apagar Blink.

🔹 Simular que Alexa detecta que te has ido

curl -X POST "http://localhost:3000/webhook" -H "Content-Type: application/json" -d '{"action": "left"}'

✔️ Debería activar Latch y encender Blink.

🔹 Simular que Latch cambia de estado

curl -X POST "http://localhost:3000/latch_webhook" -H "Content-Type: application/json" -d '{
    "t": XXX,
    "accounts": {
        "TU_ACCOUNT_ID": [
            {
                "type": "UPDATE",
                "source": "DEVELOPER_UPDATE",
                "id": "XXX",
                "new_status": "off"
            }
        ]
    }
}'

✔️ Alexa debería recibir el evento y desactivar Blink.

🛠 Estructura del Código

/alexa-latch-blink
│── miscolb.py         # Código principal de Misco-LB
│── .env               # Archivo con credenciales
│── requirements.txt   # Librerías necesarias
│── README.md          # Este archivo
│── account_id.txt     # ID pareado de Latch (se genera tras el pareo)

📜 Explicación del Código

📌 Archivo miscolb.py

• /pair → Realiza el pareado con Latch usando un código de la App móvil.

• load_account_id() → Carga tu account_id pareado con Latch

• save_account_id(account_id) → Guarda el account_id que acabas de parear

• /webhook → Alexa avisa al Misco-LB cuando llegas o te vas.

• lock_latch() → Bloquea Latch cuando llegas.

• unlock_latch() → Desbloquea Latch cuando te vas.

• /latch_webhook → Latch avisa al Misco-LB cuando cambia de estado.

• trigger_homeassistant_routine(activate) → Llama a Home Assistant.

🚀 Mejoras Futuras

✅ Añadir soporte para múltiples cámaras en una misma cuenta de Latch. ✅ Ampliar la compatibilidad a otras cámaras o sistemas de seguridad.

🏆 Créditos

🔹 Desarrollado por: Joaquín Ruiz Web
🔹 GitHub: Profile
🔹 Fecha: Febrero 2025

⚠️ Notas de Seguridad

⚠️ No subas el archivo .env a GitHub.
⚠️ Usa gitignore para excluir .env y account_id.txt.

echo ".env" >> .gitignore
echo "account_id.txt" >> .gitignore