Habilitar TLS con un certificado CA personalizado¶
Esta página explica cómo activar el cifrado TLS para la conexión MQTT y, opcionalmente, suministrar un certificado CA personalizado cuando su broker utiliza una autoridad de certificación privada o autofirmada.
El applet MQTT debe estar disponible. Si el botón de la bandeja MQTT no es visible en la barra lateral derecha, su versión de AetherSDR puede no incluir soporte MQTT.
Su broker debe estar configurado para TLS, normalmente escuchando en el puerto 8883.
Si su broker utiliza una CA privada, tenga lista la ruta del archivo del certificado CA (formato PEM).
Haga clic en el botón de la bandeja MQTT en la barra lateral derecha para abrir el applet MQTT.
Si la conexión está actualmente activa (Enable muestra "On"), haga clic en Enable para cambiarlo a "Off". No se pueden cambiar los ajustes mientras esté conectado.
Haga clic en Settings... para abrir el diálogo MQTT Settings.
En el diálogo MQTT Settings, configure los ajustes TLS:
Cambie a la pestaña Connection.
Active la casilla Use TLS.
El campo Port cambia automáticamente de 1883 a 8883.
En el campo CA certificate, ingrese la ruta completa a su archivo de certificado CA. Deje el campo en blanco para usar el paquete de CA del sistema.
Confirme que los campos Host, Port y otros campos de conexión sean correctos.
Haga clic en OK para guardar los ajustes de conexión y cerrar el diálogo.
Haga clic en Enable. El botón cambia a "On" y todos los ajustes se guardan. La etiqueta de estado cambia a "Connected" en verde cuando el broker acepta la conexión.
Botón de alternancia. Conecta o desconecta del broker. La contraseña se carga desde el llavero del sistema al habilitarlo por primera vez.
Off
Settings...
Botón pulsador. Abre el diálogo MQTT Settings para configurar la conexión al broker, suscripciones y botones de publicación.
None
Botones de publicación
Al hacer clic, se publica la carga útil configurada en el tema configurado mediante MqttClient::publish. Los botones se configuran en el diálogo MQTT Settings.
Solo activos mientras está conectado. Configurados mediante la pestaña Publish Buttons de MqttSettingsDialog.
Registro de mensajes
Muestra los mensajes recibidos como líneas 'topic: value' y los mensajes publicados como líneas 'TX topic: value'. También procesa actualizaciones de alias de antena desde MQTT.
La contraseña se almacena en el llavero del sistema y se carga automáticamente cuando habilita la conexión por primera vez.
Si desmarca TLS después de haberlo configurado en el puerto 8883, el campo Port vuelve automáticamente a 1883. Verifique el valor del puerto antes de hacer clic en Enable si su broker utiliza un puerto no estándar.
El campo CA certificate solo está disponible cuando la casilla Use TLS está marcada.
Los ajustes se guardan al hacer clic en OK en el diálogo MQTT Settings o al hacer clic en Enable para ponerlo en "On".
La etiqueta de estado muestra "Disconnected" en gris, "Connected" en verde, o un mensaje de error si la conexión falla — por ejemplo, si la ruta del certificado CA es incorrecta o el certificado no valida al broker.
El applet MQTT ahora admite temas. Los colores se adaptan al tema seleccionado usando ThemeManager.
El registro de mensajes ahora muestra tanto los mensajes recibidos como los publicados. Los mensajes publicados tienen el prefijo "TX" seguido del tema y la carga útil (truncada a 80 caracteres).
La etiqueta de estado muestra un error después de hacer clic en Enable con TLS activado — El certificado del broker no pudo ser verificado. Confirme que la ruta del certificado CA es correcta y que el archivo es legible. Si su broker utiliza una CA pública, intente dejar el campo CA cert en blanco para recurrir al paquete de CA del sistema.
El campo CA certificate no es visible — La casilla Use TLS no está marcada. Marque la casilla Use TLS; el campo del certificado CA aparece inmediatamente.
El puerto volvió a 1883 después de desmarcar TLS — Esto es un comportamiento esperado. Vuelva a ingresar el puerto de su broker manualmente si no es estándar.
Enable vuelve a "Off" inmediatamente — El broker es inalcanzable o rechazó la conexión. Verifique los ajustes Host, Port y TLS, y confirme que el broker esté ejecutándose y sea accesible desde esta máquina.
El estado muestra 'Waiting for keychain' — El llavero del sistema no está desbloqueado o la contraseña aún no se ha guardado. Vuelva a ingresar la contraseña en el diálogo MQTT Settings e intente de nuevo.