Merge pull request #2258 from stilobique/alias-group

Group config info about the alias

pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.fr.md

@@ -7,31 +7,34 @@ routes:
   default: '/groups_and_permissions'
 ---
 
-Vous pouvez accéder à l'interface de gestion des *groupes et des permissions* depuis la webadmin
-en allant dans la section "Utilisateurs" et en cliquant sur le bouton correspondant :
+Vous pouvez accéder à l'interface de gestion des *groupes et des permissions* depuis l'admin web en allant dans la section "Utilisateurs" et en cliquant sur le bouton correspondant :
 
-![](image://button_to_go_to_permission_interface_fr.png)
+![](image://button_to_go_to_permission_interface_fr.png?resize=800)
 
 ## Gestion des groupes
 
 Le mécanisme de groupe peut être utilisé pour définir des groupes d'utilisateurs qui peuvent ensuite être utilisés pour restreindre les autorisations pour les applications et autres services (tels que l'email ou XMPP). Notez qu'il n'est *pas* obligatoire de créer un groupe pour ce faire : vous pouvez également restreindre l'accès à une application ou à un service de manière individuelle.
 
-L'utilisation de groupes est cependant utile pour la sémantique, par exemple si vous hébergez plusieurs groupes d'amis, des associations ou des entreprises sur votre serveur, vous pouvez créer des groupes comme "association1" et "association2" et ajouter les membres de chaque association au groupe concerné.
+L'utilisation de groupes est cependant utile pour la sémantique, par exemple si vous hébergez plusieurs groupes d'amis, des associations ou des entreprises sur votre serveur, vous pouvez créer des groupes comme `association1` et `association2` et ajouter les membres de chaque association au groupe concerné.
+
+Il est également possible de définir des alias mail pour un groupe, afin que les mails envoyés à `groupe@domain.tld` soient redirigés vers tous les membres du groupe.
 
 
 ### Groupes par défaut
 Par défaut, deux groupes spéciaux sont créés :
 - `all_users`, qui contient tous les utilisateurs enregistrés sur YunoHost,
 - `visitors`, c'est-à-dire les personnes qui consultent le serveur sans être connectées. 
+- `admins`, apparut depuis Yunohost 11.1, ce groupe permet de gérer les administrateurs de la machine, chaque utilisateur aura alors (selon la configuration du serveur) accès en SSH ainsi que la webadmin.
 
 Vous ne pouvez pas changer le contenu de ces groupes, seulement les permissions qui leur sont accordées.
+
  
 ### Lister les groupes existants
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="À partir de l'interface web"]
 Les groupes existants sont listés en haut de la page *groupes et autorisations*.
 
-![](image://groups_default-groups.png)
+![](image://groups_default-groups_fr.png)
 
 [/ui-tab]
 [ui-tab title="À partir de la ligne de commande"]
@@ -234,3 +237,27 @@ $ yunohost user permission update wordpress.admin --show_tile True
 ```
 [/ui-tab]
 [/ui-tabs]
+
+
+### Gérer les alias des groupes
+Chaque groupe peut utiliser des alias de mail, bien que leur configuration se fasse actuellement uniquement depuis la CLI. Par défaut, le groupe `admins` dispose ainsi de `admins@domain.tld`, `root@domain.tld` ... : les messages envoyés à ces adresses sont redirigés vers tous les membres du groupe `admins`. 
+
+L'utilisation de la commande `yunohost user group info` permet de lister tous les alias pour le groupe renseigné.
+
+```shell
+$ yunohost user group info admins
+  [...]
+  mail-aliases:
+    - root@maindomain.tld
+    - admin@maindomain.tld
+    - admins@maindomain.tld
+    - webmaster@maindomain.tld
+    - postmaster@maindomain.tld
+    - abuse@maindomain.tld
+  [...]
+```
+
+Il est possible de les ajouter avec l'action `add-mailalias` ou de les enlever avec `remove-mailalias`.
+```shell
+$ yunohost user group add-mailalias <groupe> <adresse@domaine.tld>
+```

pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.md

@@ -18,6 +18,9 @@ The group mechanism can be used to define groups of users which then can be used
 
 Using groups is however useful for semantics, for example if you host multiple groups of friends, associations or businesses on your server, you might want to create groups like `association1` and `association2` and add members of each association to the relevant group.
 
+It's also possible to define mail aliases for a group, such that mails sent to `groupe@domain.tld` will be dispatched to all members of the group.
+
+
 ### Default groups
 
 By default, two special groups are created:
@@ -234,3 +237,27 @@ $ yunohost user permission update wordpress.admin --show_tile True
 ```
 [/ui-tab]
 [/ui-tabs]
+
+
+### Config alias group
+Each group can use mail aliases, but their configuration is only available from the CLI so far. For example, the `admins` group is configured with aliases such as `admins@domain.tld`, `root@domain.tld` ... : mail sent to these addresses will be dispatched to all members of the `admins` group.
+
+The command `yunohost user group info` will list them.
+
+```shell
+$ yunohost user group info admins
+  [...]
+  mail-aliases:
+    - root@maindomain.tld
+    - admin@maindomain.tld
+    - admins@maindomain.tld
+    - webmaster@maindomain.tld
+    - postmaster@maindomain.tld
+    - abuse@maindomain.tld
+  [...]
+```
+
+To add a new mail, use the action `add-mailalias` or `remove-mailalias` to delete it.
+```shell
+$ yunohost user group add-mailalias <group> <address@domaine.tld>
+```

pages/02.administer/15.admin_guide/45.emails/email.fr.md

@@ -33,6 +33,8 @@ Des alias de messagerie et des redirections peuvent être configurés pour chaqu
 
 Une autre fonctionnalité méconnue est l'utilisation de suffixes commencant par "+". Par exemple, les emails envoyés à `johndoe+sncf@votre.domaine.tld` atteriront dans le dossier 'sncf' de la boîte mail de John Doe (ou bien directement dans la boîte mail si ce dossier n'existe pas). C'est une technique pratique pour, par exemple, fournir une adresse mail à un site puis facilement trier (via des filtres automatiques) les courriers venant de ce site.
 
+Les groupes aussi peuvent utiliser des alias, par défaut le groupe `admins` dispose de `root@<domain.tld>` ou encore `webmaster@<domain.tld>`. [Plus d'information dans la page dédiée](/groups_and_permissions#&eacute;érer-les-alias-des-groupes).
+
 ## Que se passe-t-il si mon serveur devient indisponible ?
 
 Si votre serveur devient indisponible, les courriels envoyés à votre serveur resteront dans une file d'attente du côté de l'expéditeur pendant environ 5 jours. L'hébergeur de l'expéditeur tentera régulièrement de renvoyer le courrier, jusqu'à ce qu'il le jette s'il n'a pas pu l'envoyer.

pages/02.administer/15.admin_guide/45.emails/email.md

@@ -33,6 +33,8 @@ Mail aliases and forwards can be configured for each users. For instance, the fi
 
 Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@the.domain.tld` will automatically land in the `booking` dir (lowercase) of John Doe's mailbox or in John Doe's inbox if `booking` directory doesn't exist . It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website.
 
+Groups also can use alias features, by default the group `admins` have `root@<domain.tld>` or `webmaster@<domain.tld>`. [More information to use-it with the dedicated page](/groups_and_permissions#config-alias-group).
+
 ## What happens if my server becomes unavailable?
 
 If your server becomes unavailable, emails sent to your server will stay in a pending queue on the sender's side for as long as ~5 days. The sender's hoster will regularly try to resend the email, until it drops it if it was unable to send it.