Merge branch 'refactor-admin-guide' of github.com:YunoHost/doc into refactor-admin-guide

This commit is contained in:
ljf 2022-04-24 13:32:54 +02:00
commit 3a870b4502
6 changed files with 29 additions and 8 deletions

BIN
images/create_user_1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

BIN
images/create_user_2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

BIN
images/create_user_3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

View file

@ -149,14 +149,6 @@ Exemple :
```bash ```bash
yunohost tools diagnosis | yunopaste yunohost tools diagnosis | yunopaste
``` ```
### La commande `ynh-vpnclient-loadcubefile.sh`
Cette commande n'est disponible que si vous avez l'application `VPN Client` installée. Vous pouvez vous en servir pour charger un nouveau .cube dans le cas où vous ne parvenez pas à aller sur l'interface de `VPN Client` pour le faire.
```bash
ynh-vpnclient-loadcubefile.sh -u <username> -p <password> -c <path>.cube
```
### Quelques commandes utiles ### Quelques commandes utiles
Si votre interface web d'administration indique que l'API est injoignable, essayez de démarrer `yunohost-api` : Si votre interface web d'administration indique que l'API est injoignable, essayez de démarrer `yunohost-api` :

View file

@ -155,6 +155,7 @@ yunohost tools diagnosis | yunopaste
``` ```
### The `ynh-vpnclient-loadcubefile.sh` command ### The `ynh-vpnclient-loadcubefile.sh` command
This command is only available if you have the `VPN Client` application installed. You can use it to load a new .cube in case you can't get to the VPN Client interface to do so. This command is only available if you have the `VPN Client` application installed. You can use it to load a new .cube in case you can't get to the VPN Client interface to do so.
```bash ```bash

View file

@ -3,6 +3,11 @@ title: Users and the SSO
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
process:
markdown: true
twig: true
page-toc:
active: true
routes: routes:
default: '/users' default: '/users'
--- ---
@ -27,6 +32,29 @@ In the portal, users can also click on the avatar in the top-left to configure s
!!! You should be aware that the SSO can only be reached through the actual domain name (i.e. `https://the.domain.tld/yunohost/sso`), and NOT by just using the IP of the server (i.e. `https://11.22.33.44/yunohost/sso`), contrarily to the webadmin ! This is a bit confusing but is necessary for technical reason. If you are in a situation where you need to access the SSO without having your DNS properly configured for some reason, you might consider tweaking your `/etc/hosts` as described in [this page](/dns_local_network). !!! You should be aware that the SSO can only be reached through the actual domain name (i.e. `https://the.domain.tld/yunohost/sso`), and NOT by just using the IP of the server (i.e. `https://11.22.33.44/yunohost/sso`), contrarily to the webadmin ! This is a bit confusing but is necessary for technical reason. If you are in a situation where you need to access the SSO without having your DNS properly configured for some reason, you might consider tweaking your `/etc/hosts` as described in [this page](/dns_local_network).
## Creating new users
Only the administrator can create new users. From the webadmin, open the `Users` menu and click on the `+ New user` main button. Fill in all the whole form.
Users are created with an associated email address (and XMPP account) with the format `username@domain.tld`. Additional email aliases and email forwards can later be added by the admin and the user.
The password should be at least 8 characters - though it is good practice to use longer password (i.e. a passphrase) and/or to use various kind of characters (uppercase, lowercase, digits and special characters).
Finalize the user creation by clicking on the `Save` button.
[center]
![Main menu](image://create_user_1.png?classes=caption "From the main menu of the webadmin, open `Users`.")
[/center]
[center]
![Users list](image://create_user_2.png?classes=caption "From the top of the users list, click on `+ New user`.")
[/center]
[center]
![User creation form](image://create_user_3.png?classes=caption "Fill in the form.")
[/center]
## User groups and permissions ## User groups and permissions
See [this dedicated page](/groups_and_permissions). See [this dedicated page](/groups_and_permissions).