

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.

# Agregue reglas de autorización a través del panel de control de EMQX para los usuarios
<a name="add-rules-emqx-broker"></a>

Puede añadir o actualizar las reglas de autorización mediante el panel de control de EMQX o la herramienta CLI de AWS IoT SiteWise EMQX. La herramienta AWS IoT SiteWise CLI de EMQX gestiona la autorización mediante la base de datos integrada de EMQX.

**nota**  
Añadir reglas de autorización es un paso de configuración avanzada que requiere comprender los patrones de temas de MQTT y el control de acceso. *Para obtener más información sobre la creación de reglas de autorización mediante la base de datos integrada de EMQX, consulte [Uso de la base de datos en los documentos Built-in de](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) EMQX.*

**nota**  
Las EMQX-related instrucciones proporcionadas 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](https://docs.emqx.com/en/emqx/latest/) para obtener la información más actualizada.

------
#### [ EMQX dashboard ]

Este procedimiento muestra cómo añadir reglas de autorización en el panel de EMQX.

Solo se puede acceder al panel de EMQX desde el host de la puerta de enlace. Si intenta conectarse desde fuera del host de la puerta de enlace, no podrá acceder al panel de control.

**Para añadir reglas de autorización mediante el 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. Inicie sesión en el panel de EMQX. En este procedimiento se presupone que ha cambiado sus credenciales de inicio de sesión predeterminadas por las que ha elegido. Para obtener más información sobre la configuración inicial, consulte[Habilite la autenticación de nombre de usuario y contraseña](configure-emqx-broker.md#emqx-broker-username-password-auth).

1. Seleccione el icono del escudo y, a continuación, **Autorización** en el menú desplegable.

1. Pulse el botón **Permisos** en la fila de la **Built-in base de datos**. 

1. En la sección Built-in de autorización de bases de datos, añada o actualice las reglas de autorización de usuario según las necesidades de su empresa. Para obtener más información sobre la creación de reglas, consulte la sección [Uso de la Built-in base de datos](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) en los documentos de *EMQX*.

------
#### [ AWS IoT SiteWiseCLI tool using Linux ]

**Para gestionar las reglas de autorización mediante elAWS IoT SiteWiseHerramienta CLI EMQX en Linux:**
+ Agregue reglas de autorización para un usuario mediante el siguiente formato:

  ```
  /greengrass/v2/bin/swe-emqx-cli auth add {{your-username}} {{your-action}} {{your-permission}} {{your-topic}} [{{your-action-permission-topic}}]
  ```

**Example Agregue reglas de autorización para un usuario**  
En este ejemplo se muestra cómo añadir reglas para un usuario llamado`system1`:  

```
/greengrass/v2/bin/swe-emqx-cli auth add system1 \
    publish allow "sensors/#" \
    subscribe allow "control/#" \
    all deny "#"
```

**Example : Ver las reglas de autorización de un usuario**  
Para ver las reglas de autorización de los `system1` usuarios, ejecute el siguiente comando:  

```
/greengrass/v2/bin/swe-emqx-cli auth list system1
```

**Example : Vea todas las reglas de autorización existentes**  
Para ver todas las reglas de autorización que tiene actualmente, ejecute el siguiente comando:  

```
/greengrass/v2/bin/swe-emqx-cli auth list
```

**Example : Elimine todas las reglas de autorización de un usuario**  
Para eliminar todas las reglas de autorización aplicadas a un usuario concreto, ejecute el siguiente comando:  

```
/greengrass/v2/bin/swe-emqx-cli auth delete system1
```
Se le pedirá que confirme la eliminación.

------
#### [ AWS IoT SiteWiseCLI tool using Windows ]

**Para administrar las reglas de autorización mediante elAWS IoT SiteWiseHerramienta EMQX CLI en Windows PowerShell:**
+ Añada reglas de autorización para un usuario mediante el siguiente formato:

  ```
  C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth add {{your-username}} {{your-action}} {{your-permission}} {{your-topic}} [{{your-action-permission-topic}}]
  ```

**Example : Agregue reglas de autorización para un usuario**  
En este ejemplo se muestra cómo añadir reglas para un usuario llamado`system1`:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth add system1 `
    publish allow "sensors/#" `
    subscribe allow "control/#" `
    all deny "#"
```

**Example : Ver las reglas de autorización de un usuario**  
Para ver las reglas de autorización de los `system1` usuarios, ejecute el siguiente comando:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth list system1
```

**Example : Vea todas las reglas de autorización existentes**  
Para ver todas las reglas de autorización que tiene actualmente, ejecute el siguiente comando:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth list
```

**Example : Elimine todas las reglas de autorización de un usuario**  
Para eliminar todas las reglas de autorización aplicadas a un usuario concreto, ejecute el siguiente comando:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth delete system1
```
Se le pedirá que confirme la eliminación.

------