

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Ajoutez des règles d'autorisation via le tableau de bord EMQX pour les utilisateurs
<a name="add-rules-emqx-broker"></a>

Vous pouvez ajouter ou mettre à jour des règles d'autorisation à l'aide du tableau de bord EMQX ou de l'outil AWS IoT SiteWise EMQX CLI. L'outil AWS IoT SiteWise EMQX CLI gère les autorisations à l'aide de la base de données intégrée d'EMQX.

**Note**  
L'ajout de règles d'autorisation est une étape de configuration avancée qui nécessite de comprendre les modèles de sujets MQTT et le contrôle d'accès. Pour plus d'informations sur la création de règles d'autorisation à l'aide de la base de données intégrée d'EMQX, consultez la section [Utiliser la Built-in base de données](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) dans la documentation *EMQX*.

**Note**  
Les EMQX-related instructions fournies sont fournies à titre de référence uniquement. Étant donné que la documentation et les fonctionnalités d'EMQX peuvent changer au fil du temps et que nous ne conservons pas leur documentation, nous vous recommandons de consulter la [documentation officielle d'EMQX](https://docs.emqx.com/en/emqx/latest/) pour obtenir les informations les plus récentes.

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

Cette procédure montre comment ajouter des règles d'autorisation sur le tableau de bord EMQX.

Le tableau de bord EMQX n'est accessible que depuis l'hôte de la passerelle. Si vous essayez de vous connecter depuis l'extérieur de l'hôte de la passerelle, vous ne pouvez pas accéder au tableau de bord.

**Pour ajouter des règles d'autorisation à l'aide du tableau de bord EMQX**

1. Assurez-vous que vous vous trouvez dans l'hôte de la passerelle.

1. Ouvrez une fenêtre de navigateur et rendez-vous sur [`http://localhost:18083/`](http://localhost:18083/).

1. Connectez-vous au tableau de bord EMQX. Cette procédure suppose que vous avez remplacé vos informations de connexion par défaut par celles de votre choix. Pour plus d'informations sur la configuration initiale, consultez[Activer l'authentification par nom d'utilisateur et mot de passe](configure-emqx-broker.md#emqx-broker-username-password-auth).

1. Choisissez l'icône en forme de bouclier, puis **Autorisation** dans le menu déroulant.

1. Cliquez sur le bouton **Autorisations** sur la ligne **Built-in de base de données**. 

1. Dans la section Autorisation Built-in de base de données, ajoutez ou mettez à jour les règles d'autorisation utilisateur en fonction des besoins de votre entreprise. Pour plus d'informations sur la création de règles, consultez la section [Utiliser la Built-in base de données](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) dans la documentation *EMQX*.

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

**Pour gérer les règles d'autorisation à l'aide duAWS IoT SiteWiseOutil CLI EMQX sous Linux :**
+ Ajoutez des règles d'autorisation pour un utilisateur en utilisant le format suivant :

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

**Example Ajouter des règles d'autorisation pour un utilisateur**  
Cet exemple montre comment ajouter des règles pour un utilisateur nommé `system1` :  

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

**Example : Afficher les règles d'autorisation d'un utilisateur**  
Pour consulter les règles d'autorisation des `system1` utilisateurs, exécutez la commande suivante :  

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

**Example : Afficher toutes les règles d'autorisation existantes**  
Pour afficher toutes les règles d'autorisation dont vous disposez actuellement, exécutez la commande suivante :  

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

**Example : Supprimer toutes les règles d'autorisation pour un utilisateur**  
Pour supprimer toutes les règles d'autorisation appliquées à un utilisateur en particulier, exécutez la commande suivante :  

```
/greengrass/v2/bin/swe-emqx-cli auth delete system1
```
Vous êtes invité à confirmer la suppression.

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

**Pour gérer les règles d'autorisation à l'aide duAWS IoT SiteWiseOutil CLI EMQX dans Fenêtres PowerShell:**
+ Ajoutez des règles d'autorisation pour un utilisateur en utilisant le format suivant :

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

**Example : Ajouter des règles d'autorisation pour un utilisateur**  
Cet exemple montre comment ajouter des règles pour un utilisateur nommé `system1` :  

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

**Example : Afficher les règles d'autorisation d'un utilisateur**  
Pour consulter les règles d'autorisation des `system1` utilisateurs, exécutez la commande suivante :  

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

**Example : Afficher toutes les règles d'autorisation existantes**  
Pour afficher toutes les règles d'autorisation dont vous disposez actuellement, exécutez la commande suivante :  

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

**Example : Supprimer toutes les règles d'autorisation pour un utilisateur**  
Pour supprimer toutes les règles d'autorisation appliquées à un utilisateur en particulier, exécutez la commande suivante :  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth delete system1
```
Vous êtes invité à confirmer la suppression.

------