Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Configure el bróker EMQX
En esta sección se explica cómo añadir nombres de usuario y contraseñas. También explica cómo establecer una conexión TLS desde una fuente externa utilizando el nombre de usuario y la contraseña agregados. Puede configurar el broker EMQX mediante Linux o. Microsoft Windows
**nota**
Para configurar el broker, necesita un dispositivo central que esté configurado con la configuración EMQX predeterminada en su puerta de enlace V3 habilitada para MQTT.
**importante**
Tras completar este procedimiento, le recomendamos encarecidamente que configure las reglas de autorización. Para obtener más información, consulte [Configure las reglas de autorización para AWS IoT SiteWise Edge en EMQX](authorization-rules-emqx-broker.md). Las reglas de autorización para los usuarios adicionales mejoran la seguridad.
## Actualice la configuración de despliegue de EMQX para la autenticación
**Para actualizar la configuración de despliegue de EMQX para la autenticación**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. **En el panel de navegación de la izquierda, elija **las puertas de enlace Edge** en la sección Edge.**
1. Elija la puerta de enlace que desee configurar.
1. En la sección de **configuración de la puerta de enlace Edge**, copia el valor de tu **dispositivo principal de Greengrass**. Guárdelo para usarlo más adelante.
1. Abra la [consola de AWS IoT](https://console.aws.amazon.com/iot/).
1. **En el menú de navegación de la izquierda, en la sección **Administrar**, selecciona **dispositivos Greengrass** y, a continuación, Implementaciones.**
1. Busque el valor del dispositivo principal que guardó anteriormente y elija ese enlace para abrir la implementación.
1. Selecciona el botón desplegable **Acciones** y, a continuación, **Revisa**.
1. Lea el mensaje que aparece y, a continuación, seleccione **Revisar el despliegue**. Aparece la página **Especificar el destino**.
1. Elija **Siguiente** hasta llegar al paso **Configurar componentes**.
1. Seleccione el botón de opción `aws.greengrass.clientdevices.mqtt.EMQX`.
1. Pulse el botón **Configurar componente**. Aparece una página de configuración para el componente.
1. En **Actualización de la configuración**, seleccione **Restablecer la configuración predeterminada para la versión del componente: 2.\$1. **\$1.
1. Introduzca la siguiente configuración en la sección **Configuración para fusionar** en función de su sistema operativo.
------
#### [ Linux ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"dockerOptions": "-p 8883:8883 -p 127.0.0.1:1883:1883 -p 127.0.0.1:18083:18083 -v emqx-data:/opt/emqx/data -e EMQX_NODE__NAME=emqx@local",
"requiresPrivilege": "true"
}
```
------
#### [ Windows ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"requiresPrivilege": "true"
}
```
El `dockerOptions` campo es solo para pasarelas de Linux.
------
1. Elija **Confirmar**.
1. Seleccione **Siguiente** hasta llegar al paso de **revisión**.
1. Elija **Implementar**.
1. Una vez que la implementación se haya realizado correctamente, continúe con el siguiente paso.
## Habilite la autenticación de nombre de usuario y contraseña
En esta sección, se muestra cómo añadir nombres de usuario y contraseñas a través de la GUI del panel de EMQX.
**nota**
Las instrucciones relacionadas con EMQX que se proporcionan son solo de referencia. Como la documentación y las funciones de EMQX pueden cambiar con el tiempo y no mantenemos su documentación, recomendamos consultar la documentación [oficial de EMQX para obtener la](https://docs.emqx.com/en/emqx/latest/) información más actualizada.
------
#### [ EMQX Dashboard ]
**Para habilitar la autenticación de nombre de usuario y contraseña a través del panel de EMQX**
1. Asegúrese de estar dentro del host de la puerta de enlace.
1. Abra una ventana del navegador y visite [http://localhost:18083/](http://localhost:18083/).
1. Introduzca el nombre de usuario **admin** y la contraseña predeterminados de**public**. Para obtener más información, consulte el [panel de control de EMQX](https://docs.emqx.com/en/emqx/latest/dashboard/introduction.html#first-login) en los documentos de *EMQX*.
1. Después de iniciar sesión, se le solicitará que cambie su contraseña. Actualice su contraseña para continuar con el panel de control de EMQX.
1. **En el menú de navegación de la izquierda, seleccione el icono del escudo y, a continuación, Autenticación.**
1. En la fila **Base de datos integrada**, pulse el botón **Usuarios**.
1. Pulse el botón con el icono del signo más para añadir usuarios. Aparece la pantalla **Añadir**.
1. Introduzca un nombre de usuario y una contraseña para el usuario de la aplicación externa.
1. Seleccione **Save**. El nombre de usuario que eligió aparece en la tabla de la página de **autenticación**.
**nota**
Las reglas de autorización existentes o predeterminadas se aplican al nuevo usuario. Se recomienda revisarlas y ajustarlas a las necesidades de las aplicaciones externas.
------
#### [ EMQX Management with Linux ]
Utilice la herramienta AWS IoT SiteWise CLI de EMQX en. `/greengrass/v2/bin/swe-emqx-cli`
**Para habilitar la autenticación de nombre de usuario y contraseña mediante EMQX Management mediante Linux**
1. Cambie la contraseña de administrador ejecutando el siguiente comando:
```
/greengrass/v2/bin/swe-emqx-cli admin change-pwd
```
1. Cuando se le solicite, haga lo siguiente:
1. Introduzca su usuario administrador actual (el predeterminado es`admin`) y la contraseña (el predeterminado es`public`).
1. Introduzca y confirme su nueva contraseña.
Si se ejecuta correctamente, aparecerá el siguiente mensaje:
```
admin password changed successfully
```
1. Añada usuarios para aplicaciones externas ejecutando el siguiente comando:
```
/greengrass/v2/bin/swe-emqx-cli users add
```
1. Cuando se le solicite, haga lo siguiente:
1. Introduzca el nombre de usuario del nuevo usuario.
1. Introduzca y confirme la contraseña del nuevo usuario.
Si se ejecuta correctamente, aparecerá el siguiente mensaje:
```
User '[username]' created successfully
```
1. Compruebe la configuración del usuario ejecutando el siguiente comando:
```
/greengrass/v2/bin/swe-emqx-cli users list
```
El resultado muestra todos los usuarios configurados:
```
Users:
- [your-added-username]
Total users: 1
```
------
#### [ EMQX Management with Windows ]
Utilice la herramienta AWS IoT SiteWise CLI de EMQX en una de las siguientes ubicaciones:
+ PowerShell: `C:\greengrass\v2\bin\swe-emqx-cli.ps1`
+ Línea de comandos: `C:\greengrass\v2\bin\swe-emqx-cli.bat`
**Para habilitar la autenticación de nombre de usuario y contraseña mediante la administración de EMQX mediante Windows**
1. Cambie la contraseña de administrador ejecutando el siguiente comando:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 admin change-pwd
```
1. Cuando se le solicite, haga lo siguiente:
1. Introduzca su usuario administrador actual (el predeterminado es`admin`) y la contraseña (el predeterminado es`public`).
1. Introduzca y confirme su nueva contraseña.
Si se ejecuta correctamente, aparecerá el siguiente mensaje:
```
admin password changed successfully
```
1. Añada usuarios para aplicaciones externas ejecutando el siguiente comando:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users add
```
1. Cuando se le solicite, haga lo siguiente:
1. Introduzca el nombre de usuario del nuevo usuario.
1. Introduzca y confirme la contraseña del nuevo usuario.
Si se ejecuta correctamente, aparecerá el siguiente mensaje:
```
User '[username]' created successfully
```
1. Compruebe la configuración del usuario ejecutando el siguiente comando:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users list
```
El resultado muestra todos los usuarios configurados:
```
Users:
- [your-added-username]
Total users: 1
```
------