Tecnologia #mqtt#ssl#security#pki 5 min

MQTT Broker (Mosquitto) amb certificat de servidor (self-signed)

Traducció de l’original en castellà. Llegeix-lo en: CastellanoEnglish

Part 2 de 5Certificats, PKI i MQTT amb TLS
  1. Gestió de certificats (PKI) - easy-rsa
  2. MQTT Broker (Mosquitto) amb certificat de servidor (self-signed)
  3. MQTT Broker (Mosquitto) amb certificat de servidor (self-signed) i certificat client
  4. MQTT Broker (Mosquitto) amb certificat de servidor (Let's Encrypt)
  5. Formats de certificats: PEM, DER i PKCS#12 i manipulació de claus privades

Descripció de l'escenari

S'explica com muntar un broker d'MQTT fent servir Mosquitto, un dels servidors més ràpids i senzills de desplegar. Es mostrarà el fitxer de configuració més senzill possible per carregar els certificats generats tant per a la connexió TCP com per a Websockets.

Seguidament, es demostrarà amb tot detall com es negocia la connexió xifrada a través del certificat; això ho farem fent servir OpenSSL com a client TCP+SSL/TLS; després s'utilitzaran els clients de Mosquitto per subscriure's i publicar missatges en un topic de demostració. Seguidament, també es mostrarà com consumir el servei amb un simple codi fet en Python. Per acabar, el servei es consumirà amb el client EMQ MQTTX via consola, que ens permetrà consumir el servei via TCP i també via Websockets.

Supòsits

  • Tenim els conceptes bàsics descrits al post Gestió de certificats (PKI) - easy-rsa.

  • Se suposa que tenim una PKI desplegada tal com s'explica a Gestió de certificats (PKI) - easy-rsa. A més, se suposa que la configuració de la mateixa és al fitxer vars.

  • També suposarem que tenim un servidor DNS que resol, com a mínim, a la nostra xarxa privada. Aquest pas també es podria substituir amb les modificacions pertinents de /etc/hosts, però considero que és una mala pràctica si es pot evitar.

  • També se suposa que tenim instal·lat Mosquitto i les seves tools/clients al sistema operatiu que farem servir. Totes les nostres demostracions seran a Linux Ubuntu 22.04

Demostració en vídeo

MQTT Broker (Mosquitto) con certificado servidor (self-signed) · Original a YouTube ↗

Obtenció dels certificats

Creem la petició de certificat

L'objectiu és omplir els camps que tindrà el nostre certificat amb la informació que identifica el nostre servei. El camp més important és el X.509 DN, perquè ha de coincidir amb almenys un dels noms canònics de la màquina (FQDN). Si no, tindrem problemes quan es connectin els clients, ja que aquests es queixaran que no som qui diem ser. El principal objectiu d'un certificat és assegurar que som qui diem ser.

El Common Name (CN), també conegut com a Fully Qualified Domain Name (FQDN), és el valor característic que s'emmagatzema dins del camp DN (Distinguished Name), també conegut com a X.509 DN.

# desde la máquina que queramos con easy-rsa instalado
./easyrsa gen-req mqtt.example.tld
# se genera fichero mqtt.example.tld.req

Signatura de la petició de certificat

Si no es va llançar la petició de certificat (certificate request) des de la mateixa PKI, cal copiar-la a la màquina de la PKI i importar-la. No ho oblidem. Tot i que en solucions domèstiques normalment ho movem tot dins de la mateixa estructura de directoris de la PKI.

# en la PKI:
## importamos el certificado, si no se ha hecho la petición desde aquí
## se asume que se copió el fichero de certificate request en
## /the-path/mqtt.example.tld.req
./easyrsa import-req /the-path/mqtt.example.tld.req mqtt.example.tld
## esto colocará una copia del fichero .req en la PKI y algunos enlaces.

## Se le pide a la PKI que firme el certificado
./easyrsa sign-req server mqtt.example.tld
### esto generará el fichero .key y .crt necesarios para armar el servidor.

Creació i signatura de la petició de certificat

En una sola ordre, en el cas de fer-ho tot des de la PKI (en un sol servidor) podem obtenir: clau privada, request de certificat i certificat signat. Aquest certificat serà de tipus servidor.

./easyrsa build-server-full mqtt.example.tld

# sin cifrado de la clave privada:
./easyrsa build-server-full mqtt.example.tld --no-pass

IMPORTANT, no té sentit fer aquesta ordre si prèviament hem fet la creació de request, (importació) i signatura.

Configuració de Mosquitto amb certificats

Aquesta configuració és molt senzilla i només posarà en marxa un Mosquitto al port TCP/8883, a més del port WSS/8884.

mosquitto.conf

# mqtt secure
listener 8883 0.0.0.0
cafile certs/ca.crt
keyfile certs/mqtt.example.tld.key
certfile certs/mqtt.example.tld.crt
crlfile certs/pki.example.tld.crl
allow_anonymous true
require_certificate false

# websockets secure
listener 8884 0.0.0.0
protocol websockets
cafile certs/ca.crt
keyfile certs/mqtt.example.tld.key
certfile certs/mqtt.example.tld.crt
crlfile certs/pki.example.tld.crl
require_certificate false

Per llançar el servei, simplement hem de fer servir l'ordre:

mosquitto -c mosquitto.conf

Quan llancem el servei se'ns demanarà la passphrase de la clau privada dues vegades, una per a cada un dels listerners que hem posat a la configuració, el TCP i el WSS.

Negociació de la connexió (OpenSSL s_client)

OpenSSL és l'eina que hi ha per sota d'easy-rsa i la llibreria de referència per a SSL/TLS; a més de disposar d'eines que ens permetran depurar enllaços de xifratge. Per a aquest cas d'ús farem servir openssl s_client, que ens permetrà veure tots els detalls de la negociació SSL/TLS amb el servidor d'MQTT.

# self-signed fail chechking
openssl s_client mqtt.example.tld:8883
# using my CA, self-signed succesful checking
openssl s_client -CAfile certs/ca.crt mqtt.example.tld:8883

Al vídeo de demostració pots veure més detalls de com s'analitza la negociació entre el servidor i el client.

Clients Mosquitto

Fent servir mosquitto_sub i mosquitto_pub es demostra com s'intercanvia tràfic a través d'un enllaç xifrat. Res de l'altre món, però que en entorns xifrats i per a evolucions d'aquest escenari veurem que té algunes limitacions.

Em subscric al topic anomenat topic1 i espero que s'hi publiquin missatges:

mosquitto_sub --cafile pki/ca.crt -d -h mqtt.example.tld -p 8883 -t topic1 -v

Publico un missatge al topic amb el contingut: value1

mosquitto_pub --cafile pki/ca.crt -d -h mqtt.example.tld -p 8883 -t topic1 -m message1

Clients desenvolupats en Python

Es tracta d'un parell de scripts molt senzills que només pretenen il·lustrar com n'és de senzill especificar la nostra pròpia CA en la inicialització de la connexió segura amb el servidor MQTT.

# se requiere uv, si no lo tienes instalado:
curl -LsSf https://astral.sh/uv/install.sh | sh
# lanzamos el suscriptor
uv run mqtt_sub.py
# lanzamos el publicador
uv run mqtt_pub.py

Clients MQTTX-cli fent servir TCP i Websockets

En llançar el broker d'MQTT vam exposar l'endpoint en TCP i el de Websockets, però encara no hem fet servir el segon per a res. Així, doncs, aprofitarem la potència del client d'EMQ anomenat MQTTX per repetir les mateixes funcions que abans, però ara fent la subscripció amb Websockets i la publicació amb TCP.

# para no tener que instalar mqttx-cli lo usaremos desde Docker:
alias mqttx-cli='docker run -it --rm --entrypoint /usr/local/bin/mqttx -v ./mosquitto/certs/ca.crt:/tmp/ca.crt emqx/mqttx-cli'

# suscripción
mqttx-cli sub \
  --ca /tmp/ca.crt
  -h mqtt.example.tld \
  -p 8884 -l wss \
  -t topic1

# publicación
mqttx-cli pub \
  --ca /tmp/ca.crt
  -h mqtt.example.tld \
  -p 8883 -l mqtts \
  -t topic1 -m message1

Referències