########################
Gestion des utilisateurs
########################

La commande de gestion des :term:`utilisateurs <utilisateur>` est ``user``. Cette
commande doit ensuite être suivie d'une action. La liste complète des actions est
disponible :any:`ici <reference-cli-client-users>`.

Ajouter un utilisateur
======================

Pour créer un utilisateur, la commande est ``user add``. Les options de commande
suivantes doivent être fournies:

- ``-u``: le nom de l'utilisateur
- ``-p``: le mot de passe
- ``-r``: les droits de l'utilisateur sur les éléments de transfer. L'option
  peut être répété pour donner des droits sur plusieurs éléments. Les valeurs
  acceptées sont ``U`` pour les utilisateurs, ``S`` pour les serveurs, ``P``
  pour les partenaires, ``R`` pour les règles, ``T`` pour les transferts.
  Chacune de ces valeurs doit être suivie de ``r`` pour autoriser la
  consultation, ``w`` pour autoriser la modification, ``d`` pour autoriser la
  suppression.


**Exemple**

La commande ci-dessous permet de créer un utilisateur et lui donne le droit de
consulter et de modifier les transferts, ainsi que de consulter, modifier et
supprimer les règles de transfert.

.. code-block:: shell

   waarp-transfer -a 'https://admin@127.0.0.1:8080' user add -u 'aladdin' -p 'sésame' -r 'Twr' -r 'Rwrd'


Modifier un utilisateur
=======================

Pour modifier un utilisateur existant, la commande est ``user update``. Cette
commande doit être suivie du nom de l'utilisateur à modifier. Les options de
commandes sont identiques à la commande ``add``. Il est possible d'omettre une
ou plusieurs options pour faire une mise à jour partielle.

**Exemple**

.. code-block:: shell

   waarp-transfer -a 'https://admin@127.0.0.1:8080' user update 'aladdin' -p 'sésame2'


Consulter les utilisateurs
==========================

Pour lister les utilisateurs de Waarp Transfer, la commande est ``user list``.
Les options de commande permettent de filtrer les résultats selon divers
critères, pour plus de détails, voir la :any:`référence
<reference-cli-client-user-list>` de la commande ``list``.

**Exemple**

.. code-block:: shell

   waarp-transfer -a 'https://admin@127.0.0.1:8080' user list


Supprimer un utilisateur
========================

Pour supprimer un utilisateur, la commande est ``user delete``, suivie ensuite
du nom de l'utilisateur à supprimer.

.. code-block:: shell

   waarp-transfer -a 'https://admin@127.0.0.1:8080' user delete 'toto'
