Přeskočit na hlavní obsah

Integrace ChirpStack MQTT přes TLS

Tento návod vysvětluje, jak platformu HARDWARIO ThingsBoard připojit k brokeru MQTT serveru ChirpStack šifrovaným spojením TLS. Postup využívá obecnou integraci MQTT, která data přenáší bezpečně díky klientským certifikátům.

Předpoklady​

Než integraci v ThingsBoard nastavíte, vygenerujte a stáhněte v uživatelském rozhraní ChirpStack tyto tři soubory (v části Applications -> Integrations -> MQTT Certificate):

  • Certifikát CA (ca.pem)
  • Certifikát TLS (client-cert.pem)
  • Klíč TLS (client-key.pem)

Poznámka: Broker MQTT (Mosquitto) musí mít na portu 8883 listener s TLS a integrace MQTT v ChirpStack musí mít nastavené json=true.

Postup nastavení v ThingsBoard​

Zabezpečenou integraci MQTT nastavíte takto:

1. Vytvořte integraci​

  1. Přihlaste se do své instance ThingsBoard.
  2. V levém menu přejděte na Integrations.
  3. Klikněte na Add integration a jako typ zvolte MQTT.

2. Nastavení připojení​

Na záložce Connection nastavte tyto parametry:

PoleHodnota
HostIP adresa vašeho serveru ChirpStack (například 10.0.0.52)
Port8883
Enable SSL/TLSZapnuto
Credentials typePEM (certificate based)

3. Nahrání přihlašovacích údajů​

Nahrajte tři soubory získané z rozhraní ChirpStack do odpovídajících polí:

  • CA certificate: nahrajte ca.pem.
  • Certificate: nahrajte client-cert.pem.
  • Private key: nahrajte client-key.pem.

4. Konfigurace topicu​

Nastavte Topic filter, aby integrace přijímala uplinky ze zařízení: application/+/device/+/event/up

Kontrola a řešení problémů​

Po uložení ThingsBoard naváže zabezpečené připojení MQTT přes TLS. Broker připojení ověří klientským certifikátem, který podepsala certifikační autorita (CA) vašeho serveru ChirpStack.

Jak to zkontrolovat:​

  • Logy integrace: V ThingsBoard otevřete u integrace záložku Logs. Pokud je konfigurace správná, měli byste vidět úspěšné události připojení.
  • Kontrola na straně serveru: Pokud se připojení nezdaří, ověřte na serveru tímto příkazem, že Mosquitto skutečně naslouchá na portu 8883: ss -tlnp | grep mosquitto

Časté chyby:​

  • Záměna certifikátů: Zkontrolujte, že jste nezaměnili soubory Certificate a Private key.
  • Formát JSON: Pokud se připojení jeví jako aktivní, ale nepřicházejí žádná data, zkontrolujte, že má integrace MQTT v ChirpStack zapnuté json=true.