

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 cómo crear reglas de autorización utilizando la base de datos integrada de EMQX, consulte [Uso de una base de datos integrada en los documentos de](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) EMQX.*

**nota**  
Las instrucciones relacionadas con el 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 ]

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 **base de datos integrada**. 

1. En la sección de autorización de la base de datos integrada, 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 una base de datos integrada](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) en los documentos de *EMQX*.

------
#### [ AWS IoT SiteWise CLI tool using Linux ]

**Para administrar las reglas de autorización mediante la herramienta AWS IoT SiteWise CLI de 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 SiteWise CLI tool using Windows ]

**Para administrar las reglas de autorización mediante la herramienta AWS IoT SiteWise CLI de EMQX en: Windows PowerShell**
+ Agregue 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.

------