Add-on Mosquitto Broker: Connection Refused: not authorised (Code 5) ed errore autenticazione MQTT

1. A cosa serve

La guida risolve l'errore di rifiuto della connessione (Code 5 / not authorised) dell'Add-on Mosquitto Broker MQTT in Home Assistant, riconfigurando le credenziali utente dedicate.

2. Specifiche e compatibilità

Add-on: Mosquitto Broker MQTT. Porta: 1883 (TCP). Protocollo: MQTT 3.1.1 / 5.0. Piattaforme: Home Assistant OS.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Add-on Mosquitto Broker installato. 2. Accesso ad Impostazioni > Persone e Utenti su Home Assistant.

Fase 1: Preparazione

Crea un utente dedicato all'interno di Home Assistant denominato mqtt-user con una password alfanumerica complessa priva di caratteri speciali per evitare errori di escape YAML.

[SCHEMA GRAFICO: Autenticazione Mosquitto: Dispositivo Client MQTT (Username/Password) ---> Mosquitto Broker Add-on ---> Validazione Utenti HA Core]

Non usare l'account Amministratore principale di Home Assistant per collegare i client MQTT: crea sempre un utente separato con spinta Solo accesso locale!

Abilita sempre l'autenticazione su Mosquitto Broker per evitare che dispositivi non autorizzati iniettino comandi falsi sulla tua rete domestica.

Fase 2: Configurazione

• Vai su Impostazioni > Persone > scheda Utenti e clicca su Aggiungi Utente. 2. Crea l'utente mqtt-user impostando una password sicura. 3. Apri l'Add-on Mosquitto Broker > Scheda Configurazione e lascia logins vuoto. 4. Riavvia l'Add-on Mosquitto.

Credenziali MQTT: Broker 127.0.0.1, Porta 1883, User mqtt-user.

Fase 3: Automazione / Uso pratico

Configurazione MQTT manuale in configuration.yaml:

mqtt:
  broker: 127.0.0.1
  port: 1883
  username: "mqtt-user"
  password: "PasswordSicura123!"

Automazione YAML per verificare la riconnessione MQTT:

alias: "System - Monitoraggio MQTT Broker"
trigger:
  - platform: homeassistant
    event: start
action:
  - service: mqtt.publish
    data:
      topic: "homeassistant/status/check"
      payload: "online"

Verifica e test operativo

Apri lo Strumento Sviluppatori > scheda MQTT in Home Assistant ed effettua l'ascolto sul tema #: vedrai fluire in tempo reale tutti i messaggi trasmessi dai dispositivi.

L'Add-on Mosquitto mostra il log verde Client mqtt-user connected from 127.0.0.1.

Cosa fare se qualcosa non funziona

• Code 5 persiste: Verificare che l'utente non abbia la spunta Disabilitato. 2. Connessione chiusa: Verificare che la porta 1883 non sia occupata da un altro Add-on. 3. Errore Zigbee2MQTT: Aggiornare le credenziali nel file data/configuration.yaml di Z2M.

9. Sicurezza e privacy

Il broker Mosquitto esegue il dispatching dei messaggi interamente nella memoria RAM del server locale.

10. Requisiti e Risorse Ufficiali

Questa guida risolve una problematica tecnica di configurazione o sistema domotico. Di seguito i riferimenti alle documentazioni ufficiali:

* 🌐 Documentazione Ufficiale Home Assistant: [home-assistant.io/help](https://www.home-assistant.io/help/)

* 📦 Repository GitHub Troubleshooting: [github.com/home-assistant/core/issues](https://github.com/home-assistant/core/issues)

* 🛠️ Prerequisiti di sistema: Server Home Assistant OS aggiornato, connessione di rete LAN locale ed accesso Amministratore.