Habilitar TLS con un certificado de CA personalizado¶
Esta página explica cómo activar el cifrado TLS para la conexión MQTT y, opcionalmente, suministrar un certificado de 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 bandeja MQTT no es visible en la barra lateral derecha, su compilación de AetherSDR puede no incluir soporte MQTT.
Su broker debe estar configurado para TLS, escuchando normalmente en el puerto 8883.
Si su broker utiliza una CA privada, tenga lista la ruta del archivo de certificado de CA (formato PEM).
Haga clic en el botón de bandeja MQTT en la barra lateral derecha para abrir el applet MQTT.
Si la conexión está activa actualmente (Enable muestra "On"), haga clic en Enable para cambiarla a "Off". Los ajustes no se pueden modificar mientras esté conectado.
Haga clic en Settings... para abrir el diálogo de MQTT Settings.
En el diálogo MQTT Settings, configure los ajustes de TLS:
Cambie a la pestaña Connection.
Active la casilla de verificación Use TLS.
El campo Port cambia automáticamente de 1883 a 8883.
En el campo CA certificate, introduzca la ruta completa a su archivo de certificado de 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 de 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 de 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'. También procesa actualizaciones de alias de antena desde MQTT.
Limitado a 50 entradas.
## Indicadores
Etiqueta
Estados
Significado
Etiqueta de estado
"Disconnected", "Connected",
Estado de conexión con color: verde cuando está conectado, gris cuando está desconectado, por defecto en caso de error.
La contraseña se almacena en el llavero del sistema y se carga automáticamente la primera vez que habilita la conexión. En compilaciones sin soporte de llavero, la contraseña se almacena solo para la sesión actual y debe volver a introducirse después de reiniciar AetherSDR.
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 de MQTT Settings o cuando Enable se cambia a la posición "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 de CA es incorrecta o el certificado no valida el broker.
El applet MQTT ahora admite temas. Los colores se adaptan al tema seleccionado mediante ThemeManager.
El registro de mensajes ahora muestra tanto mensajes recibidos como mensajes publicados. Los mensajes publicados se prefijan con "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 verificarse. Confirme que la ruta del certificado de CA sea correcta y que el archivo sea 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 CA certificate aparece inmediatamente.
El puerto volvió a 1883 después de desmarcar TLS — Este es un comportamiento esperado. Vuelva a introducir manualmente el puerto de su broker si no es estándar.
Enable vuelve a "Off" inmediatamente — El broker es inaccesible o rechazó la conexión. Verifique los ajustes de Host, Port y TLS, y confirme que el broker esté en ejecución 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 introducir la contraseña en el diálogo de MQTT Settings e intente nuevamente. En compilaciones sin soporte de llavero, la contraseña es solo para la sesión y debe volver a introducirla después de reiniciar AetherSDR.