MQTT Broker (Mosquitto) amb certificat de servidor (self-signed) i certificat client
Traducció de l’original en castellà. Llegeix-lo en: CastellanoEnglish
Part 3 de 5Certificats, PKI i MQTT amb TLS
- Gestió de certificats (PKI) - easy-rsa
- MQTT Broker (Mosquitto) amb certificat de servidor (self-signed)
- MQTT Broker (Mosquitto) amb certificat de servidor (self-signed) i certificat client
- MQTT Broker (Mosquitto) amb certificat de servidor (Let's Encrypt)
- Formats de certificats: PEM, DER i PKCS#12 i manipulació de claus privades
Descripció de l'escenari
En aquest post explorarem la configuració d'un broker MQTT fent servir Mosquitto, implementant seguretat mútua a través de certificats: un certificat auto-signat per al servidor i certificats específics per als clients. Analitzarem pas a pas com muntar l'entorn, partint d'una configuració mínima que permeti l'ús tant de connexions TCP com de Websockets.
Al llarg de l'article es demostrarà de manera detallada el procés de negociació de la connexió xifrada utilitzant OpenSSL com a client TCP+SSL/TLS, i posteriorment s'empraran els clients de Mosquitto per subscriure's i publicar missatges en un tòpic de demostració. A més, veurem com consumir el servei mitjançant un senzill script en Python i, per acabar, utilitzarem el client EMQ MQTTX des de la consola, que ens permetrà interactuar tant via TCP com a través de Websockets.
Aquest enfocament pràctic t'ajudarà a comprendre en profunditat com garantir la seguretat en la comunicació MQTT implementant certificats tant al servidor com als clients. Comencem!
Supòsits
Per al desenvolupament d'aquest post se suposen els punts següents:
-
PKI i easy-rsa: Tenim els coneixements bàsics sobre la gestió de certificats mitjançant una PKI, tal com es descriu al post Gestió de certificats (PKI) - easy-rsa. Se suposa que la PKI ja està desplegada seguint les indicacions d'aquest post i que la configuració es troba al fitxer
vars. -
Resolució DNS: Es disposa d'un servidor DNS que resol els noms d'amfitrió dins de la nostra xarxa privada. Tot i que és possible modificar el fitxer
/etc/hostsper aconseguir-ho, aquesta pràctica es considera menys recomanable en entorns on es pot optar per una solució DNS adequada. -
Instal·lació de Mosquitto: Se suposa que Mosquitto i les seves eines/clients estan instal·lats al sistema operatiu que utilitzarem. En aquest post, totes les demostracions es faran a Linux Ubuntu 22.04.
Aquests supòsits ens permetran centrar-nos en la configuració i l'ús de certificats al broker MQTT sense haver de detallar cada un dels passos previs per a la creació i administració de la infraestructura de certificats.
Demostració en vídeo
Obtenció dels certificats
Partim del que es descriu al post: MQTT Broker (Mosquitto) amb certificat de servidor (self-signed)
Per tant, només hem de crear el certificat per als clients que farem servir. Els del servidor MQTT ja estan a punt.
# desde la máquina que queramos con easy-rsa instalado
./easyrsa gen-req client.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/client.example.tld.req
./easyrsa import-req /the-path/client.example.tld.req client.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 client client.example.tld
### esto generará el fichero .crt necesarios para armar el cliente.
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 client.
./easyrsa build-client-full client.example.tld
# sin cifrado de la clave privada:
./easyrsa build-client-full client.example.tld --no-pass
IMPORTANT, no té sentit fer aquesta ordre si prèviament hem fet la creació de request, (importació) i signatura.
Si volem emetre un certificat que sigui útil tant per a client com per a servidor podem fer servir:
./easyrsa build-serverClient-full clientserver.example.tld
# sin cifrado de la clave privada:
./easyrsa build-serverClient-full clientserver.example.tld --no-pass
Configuració de Mosquitto amb certificat de servidor i requisit de certificat de client
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 true
# 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 true
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.
D'altra banda, si es configura use_subject_as_usernameen true, s'emprarà el camp complet del subjecte del certificat com a nom d'usuari. En cas que use_identity_as_username o use_subject_as_username estiguin desactivats, el client s'haurà d'autenticar mitjançant els mètodes habituals, com la verificació a través de password_file. Així mateix, qualsevol certificat expedit per les autoritats indicades a cafile o capath serà considerat vàlid per a la connexió, cosa que ofereix més flexibilitat en l'emissió i comprovació dels certificats de client.
Quan el paràmetre require_certificate de Mosquitto està configurat a true, s'exigeix que el client presenti un certificat vàlid per poder connectar-se satisfactòriament al servei MQTT. En aquest context, els paràmetres addicionals use_identity_as_usernamey use_subject_as_usernameresulten rellevants: si use_identity_as_usernamees estableix a true, s'utilitzarà el Common Name (CN) extret del certificat del client en lloc del nom d'usuari MQTT per al control d'accés, i s'ometrà la contrasenya, ja que se suposa que únicament els clients autenticats disposen de certificats vàlids.
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 \
-CAfile certs/ca.crt \
mqtt.example.tld:8883
# using my CA, self-signed succesful checking
openssl s_client \
-CAfile certs/ca.crt \
--cert certs/client.example.tld.crt \
--key certs/client.example.tld.key \
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 -d \
--cafile pki/ca.crt \
--cert certs/client.example.tld.crt \
--key certs/client.example.tld.key \
-h mqtt.example.tld -p 8883 \
-t topic1 -v
Publico un missatge al topic amb el contingut: value1
mosquitto_pub -d \
--cafile pki/ca.crt \
--cert certs/client.example.tld.crt \
--key certs/client.example.tld.key \
-h mqtt.example.tld -p 8883 \
-t topic1 -m "message1"
Quan llancem les ordres, se'ns demanarà la passphrase de la clau privada. Tant per publicar com per subscriure'ns, ja que tots dos necessiten accés al fitxer "certs/client.example.tld.key" que està xifrat amb una clau simètrica.
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.
Aquest client de moment no suporta protecció de xifratge simètric a la clau privada, així que primer hem d'extreure la clau privada a un fitxer nou:
# extraer clave privada de fichero cifrado:
openssl rsa -in python_client/certs/client.example.tld.key -out python_client/certs/client.example.tld.key.raw
# para completar el proceso se deberá introducir la clave simétrica
# mqttx-cli using docker
alias mqttx-cli 'docker run --rm \
--entrypoint /usr/local/bin/mqttx \
-v ./pki/ca.crt:/tmp/ca.crt \
-v ./python_client/certs/client.example.tld.crt:/tmp/client.example.tld.crt \
-v ./python_client/certs/client.example.tld.key.raw:/tmp/client.example.tld.key \
emqx/mqttx-cli'
# suscripción
mqttx-cli sub \
--ca /tmp/ca.crt \
--cert /tmp/client.example.tld.crt \
--key /tmp/client.example.tld.key \
-h mqtt.example.tld \
-p 8884 -l wss \
-t topic1
# publicación
mqttx-cli pub \
--ca /tmp/ca.crt \
--cert /tmp/client.example.tld.crt \
--key /tmp/client.example.tld.key \
-h mqtt.example.tld \
-p 8883 -l mqtts \
-t topic1 -m message1