Home Assistant pide la clave de cifrado de un dispositivo ESPHome

Al añadir un dispositivo ESPHome, Home Assistant pide una «clave de cifrado» que no sabes cuál es.

Por Kike · revisada en octubre de 2026 · Nivel: Básico · Cómo verificamos

Por qué pasa (diagnóstico)

• La API nativa está cifrada con una clave (api: → encryption: → key:) que está en el YAML del dispositivo.
• Las contraseñas de API antiguas están obsoletas.

Solución paso a paso

1. Abre el YAML del dispositivo en el panel de ESPHome y copia el valor de key de api: encryption:.
2. Pégalo en Home Assistant.
3. Si no tiene, añade una clave base64 de 32 bytes (el panel de ESPHome la genera al crear el dispositivo) y vuelve a subir el firmware.

Requisitos

• ESPHome
• Home Assistant

Compatibilidad

• ESPHome 2024.x–2026.x

Verificación

Basado en la documentación oficial citada; aún no probado en este laboratorio.

Fuentes

• ESPHome — Componente API nativa (en inglés)
• Home Assistant — Integración ESPHome (en inglés)

Guías relacionadas

• Primer dispositivo ESPHome en Home Assistant
• ESPHome: el dispositivo sale «offline» y la OTA no encuentra la IP
• Ver los logs de un dispositivo ESPHome para saber qué le pasa
• ESP32: «Brownout detector was triggered» y se reinicia
• ESP32: «Wrong boot mode detected» al flashear
• El ESP32 no conecta al Wi-Fi o se desconecta (ESPHome)

Más guías de ESP32 / ESPHome.