mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Fix typos in Administration (part 2)
This commit is contained in:
parent
02fe506295
commit
72547c1660
15 changed files with 79 additions and 84 deletions
|
@ -28,7 +28,7 @@ votre DNS est correctement configuré (votre.domaine.tld doit pointer sur l'IP
|
|||
de votre serveur) et que votre site est accessible en HTTP depuis l'extérieur
|
||||
(c.-à-d. qu'au moins le port 80 est correctement redirigé vers votre serveur).
|
||||
|
||||
#### Via l'interface d'administration web
|
||||
#### Via la webadmin
|
||||
|
||||
Rendez-vous dans la partie 'Domaines' de l'interface d'administration, puis dans
|
||||
la section dédiée à votre domaine. Vous trouverez un bouton 'Certificat SSL'.
|
||||
|
|
|
@ -532,7 +532,7 @@ C’est le mot de passe qui vous permettra d’accéder à l’interface d’adm
|
|||
|
||||
## [fa=user /] Créer un premier utilisateur
|
||||
|
||||
Une fois la configuration initiale faite, vous devriez être capable de vous connecter à l'interface d'administration web en utilisant le mot de passe d'administration.
|
||||
Une fois la configuration initiale faite, vous devriez être capable de vous connecter à la webadmin en utilisant le mot de passe d'administration.
|
||||
|
||||
Bien que votre serveur dispose maintenant d'un utilisateur `admin`, cet utilisateur `admin` n'est pas un utilisateur « standard » et ne peut pas se connecter sur le [portail utilisateur](/users).
|
||||
|
||||
|
|
|
@ -39,7 +39,7 @@ Ne faites pas ça. La réinstallation est une opération lourde et n'est pas une
|
|||
|
||||
## Faites des sauvegardes
|
||||
|
||||
Si vous hébergez des services et des données qui sont importants pour vos utilisateurs, il est important que vous mettiez en place une politique de sauvegarde. Les sauvegardes peuvent être facilement créées à partir de l'interface d'administration web - bien qu'elles ne puissent actuellement pas être téléchargées à partir de celle-ci (mais elles peuvent être téléchargées par d'autres moyens). Vous devez effectuer régulièrement des sauvegardes et les conserver dans un endroit sûr et physiquement différent de votre serveur. Plus d'infos dans [la documentation des sauvegardes](/backup).
|
||||
Si vous hébergez des services et des données qui sont importants pour vos utilisateurs, il est important que vous mettiez en place une politique de sauvegarde. Les sauvegardes peuvent être facilement créées à partir de la webadmin - bien qu'elles ne puissent actuellement pas être téléchargées à partir de celle-ci (mais elles peuvent être téléchargées par d'autres moyens). Vous devez effectuer régulièrement des sauvegardes et les conserver dans un endroit sûr et physiquement différent de votre serveur. Plus d'infos dans [la documentation des sauvegardes](/backup).
|
||||
|
||||
## Lisez les emails envoyés à root
|
||||
|
||||
|
|
|
@ -7,11 +7,11 @@ routes:
|
|||
default: '/admin_interface'
|
||||
---
|
||||
|
||||
YunoHost est fourni avec une interface graphique d’administration. L’autre méthode est d’utiliser la [ligne de commande](/commandline).
|
||||
YunoHost est fourni avec une interface graphique d’administration (aussi appelée webadmin). L’autre méthode d'administration est d’utiliser la [ligne de commande](/commandline).
|
||||
|
||||
### Accès
|
||||
|
||||
L’interface admin est accessible depuis votre instance YunoHost à l’adresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur)
|
||||
L’interface d'administration web est accessible depuis votre instance YunoHost à l’adresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur)
|
||||
|
||||

|
||||
|
||||
|
|
|
@ -25,7 +25,7 @@ Le portail utilisateur, également appelé SSO pour 'Single Sign On', permet à
|
|||
|
||||
Dans le portail, les utilisateurs peuvent également cliquer sur l'avatar en haut à gauche pour configurer d'autres paramètres tels que leur identité, les alias de messagerie, les transferts automatiques de courrier ou leur mot de passe.
|
||||
|
||||
!!! Vous devez être conscient que le SSO ne peut être atteint que par le nom de domaine (c.-à-d. `https://the.domain.tld/yunohost/sso`), et non pas en utilisant l'IP du serveur (c.-à-d. `https://11.22.33.44/yunohost/sso`), contrairement à l'interface d'administration web ! C'est un peu déroutant dans certaines situations, mais c'est nécessaire pour des raisons techniques. Si vous êtes dans une situation où vous avez besoin d'accéder au SSO sans avoir votre DNS correctement configuré pour une raison quelconque, vous pouvez envisager de modifier votre `/etc/hosts` comme décrit dans [cette page](/dns_local_network).
|
||||
!!! Vous devez être conscient que le SSO ne peut être atteint que par le nom de domaine (c.-à-d. `https://the.domain.tld/yunohost/sso`), et non pas en utilisant l'IP du serveur (c.-à-d. `https://11.22.33.44/yunohost/sso`), contrairement à la webadmin ! C'est un peu déroutant dans certaines situations, mais c'est nécessaire pour des raisons techniques. Si vous êtes dans une situation où vous avez besoin d'accéder au SSO sans avoir votre DNS correctement configuré pour une raison quelconque, vous pouvez envisager de modifier votre `/etc/hosts` comme décrit dans [cette page](/dns_local_network).
|
||||
|
||||
## Gestion des groupes d'utilisateurs et permissions
|
||||
|
||||
|
|
|
@ -7,25 +7,21 @@ routes:
|
|||
default: '/domains'
|
||||
---
|
||||
|
||||
YunoHost permet de gérer et de servir plusieurs domaines sur un même serveur. Vous pouvez donc héberger, par exemple, un blog et un Nextcloud sur un premier domaine `yolo.com`, et un client de messagerie web sur un second domaine `swag.nohost.me`. Chaque domaine est automatiquement configuré pour pouvoir gérer des services web, des courriels et une messagerie instantannée XMPP.
|
||||
YunoHost permet de gérer et de servir plusieurs domaines sur un même serveur. Vous pouvez donc héberger, par exemple, un blog et un Nextcloud sur un premier domaine `yolo.com`, et un client de messagerie web sur un second domaine `swag.nohost.me`. Chaque domaine est automatiquement configuré pour pouvoir gérer des services web, des courriels et une messagerie instantanée XMPP.
|
||||
|
||||
Les domaines peuvent être gérés dans la section 'Domaine' de la webadmin, ou via la catégorie `yunohost domain` de la ligne de commande.
|
||||
Les domaines peuvent être gérés dans la section 'Domaines' de la webadmin, ou via la catégorie `yunohost domain` de la ligne de commande.
|
||||
|
||||
Chaque fois que vous ajoutez un domaine, il est supposé que vous avez acheté (ou en tout cas que vous contrôlez) le domaine, de sorte que vous puissiez gérer la [configuration DNS](/dns_config) de celui-ci. Une exception concerne les [domaines en `.nohost.me`, `.noho.st` et `ynh.fr`](/dns_nohost_me) qui sont offerts par le Projet YunoHost, et peuvent être directement intégrés avec YunoHost grâce à une configuration dynDNS automatique. Pour limiter les abus et les coûts, une instance ne peut avoir qu'un seul domaine offert à la fois, toutefois vous pouvez ajouter autant de sous-domaine de celui-ci que vous le souhaitez. Par exemple, ci vous choisissez `example.ynh.fr` vous pourrez par la suite ajouter les domaines `video.example.ynh.fr` ou `www.example.ynh.fr` ou tout autre sous-domaine dont vous pourriez avoir l'utilité.
|
||||
Chaque fois que vous ajoutez un domaine, il est supposé que vous avez acheté (ou en tout cas que vous contrôlez) le domaine, de sorte que vous puissiez gérer la [configuration DNS](/dns_config) de celui-ci. Une exception concerne les [domaines en `.nohost.me`, `.noho.st` et `ynh.fr`](/dns_nohost_me) qui sont offerts par le Projet YunoHost, et peuvent être directement intégrés avec YunoHost grâce à une configuration DynDNS automatique. Pour limiter les abus et les coûts, une instance ne peut avoir qu'un seul domaine offert à la fois, toutefois vous pouvez ajouter autant de sous-domaines de celui-ci que vous le souhaitez. Par exemple, ci vous choisissez `exemple.ynh.fr` vous pourrez par la suite ajouter les domaines `video.exemple.ynh.fr` ou `www.exemple.ynh.fr` ou tout autre sous-domaine dont vous pourriez avoir l'utilité.
|
||||
|
||||
Le domaine choisi lors de la configuration initiale (post-installation) est défini comme le domaine principal du serveur : c'est là que le SSO et l'interface d'administration web seront disponibles. Le domaine principal peut être modifié ultérieurement via la webadmin dans Domaines > (le domaine) > Définir par défaut, ou avec la ligne de commande `yunohost tools maindomain`.
|
||||
Le domaine choisi lors de la configuration initiale (post-installation) est défini comme le domaine principal du serveur : c'est là que le SSO et la webadmin seront disponibles. Le domaine principal peut être modifié ultérieurement via la webadmin dans Domaines > (le domaine) > Définir par défaut, ou avec la ligne de commande `yunohost tools maindomain`.
|
||||
|
||||
Enfin, il faut noter que, dans le contexte de YunoHost, il n'y a pas de hiérarchie entre les domaines qu'il connaît. Dans l'exemple précédent, on peut ajouter un troisième domaine `foo.yolo.com` - mais il serait considéré comme un domaine indépendant de `yolo.com`.
|
||||
|
||||
## Caractères non latins
|
||||
|
||||
Si votre domaine contient des caractères spéciaux, non latins, vous devez utiliser sa [version internationalisée](https://fr.wikipedia.org/wiki/Nom_de_domaine_internationalis%C3%A9) en [Punycode](https://fr.wikipedia.org/wiki/Punycode). Vous pouvez utiliser [ce convertisseur](https://www.charset.org/punycode), et utiliser le nom de domaine converti dans YunoHost.
|
||||
|
||||
## Configuration DNS
|
||||
|
||||
DNS (Domain Name System) est un système qui permet aux ordinateurs du monde entier de traduire les noms de domaine lisibles par l'homme (comme `yolo.com`) en adresses IP compréhensibles par les machines (comme `11.22.33.44`). Pour que cette traduction (et d'autres fonctionnalités) fonctionne, il faut configurer soigneusement les enregistrements DNS.
|
||||
|
||||
YunoHost peut générer une configuration DNS recommandée pour chaque domaine, y compris les enregistrements nécessaires pour les parties emails et XMPP. La configuration DNS recommandée est disponible dans l'administrateur web via Domaine > (le domaine) > configuration DNS, ou avec la commande `yunohost domain dns-conf the.domain.tld`.
|
||||
YunoHost peut générer une configuration DNS recommandée pour chaque domaine, y compris les enregistrements nécessaires pour les parties emails et XMPP. La configuration DNS recommandée est disponible dans l'administrateur web via Domaines > (le domaine) > configuration DNS, ou avec la commande `yunohost domain dns-conf the.domain.tld`.
|
||||
|
||||
## Certificats SSL/HTTPS
|
||||
|
||||
|
@ -43,7 +39,7 @@ yolo.com
|
|||
├─── /wiki : DokuWiki (un wiki)
|
||||
```
|
||||
|
||||
Alternativement, on peut choisir d'installer chaque application (ou certaines) sur un domaine dédié. Au delà de la question esthétique, utiliser des sous-domaines au lieu de sous-chemin permet de laisser la possibilité de déplacer un service sur un autre serveur plus facilement. Par ailleurs, certaines applications peuvent avoir besoin d'un domaine entier qui leur est dédié, pour des raisons techniques. L'inconvénient est que vous devez ajouter un nouveau domaine à chaque fois, et donc potentiellement configurer des enregistrements DNS supplémentaire, relancer le diagnostique et l'installation d'un nouveau certificat Let's Encrypt.
|
||||
Alternativement, on peut choisir d'installer chaque application (ou certaines) sur un domaine dédié. Au delà de la question esthétique, utiliser des sous-domaines au lieu de sous-chemins permet de laisser la possibilité de déplacer un service sur un autre serveur plus facilement. Par ailleurs, certaines applications peuvent avoir besoin d'un domaine entier qui leur est dédié, pour des raisons techniques. L'inconvénient est que vous devez ajouter un nouveau domaine à chaque fois, et donc potentiellement configurer des enregistrements DNS supplémentaire, relancer le diagnostique et l'installation d'un nouveau certificat Let's Encrypt.
|
||||
|
||||
Si toutes les applications de l'exemple précédent étaient installées sur un domaine séparé, cela donnerait quelque chose comme ceci :
|
||||
|
||||
|
|
|
@ -13,12 +13,12 @@ Normalement, votre client email devrait recevoir la configuration automatiquemen
|
|||
|
||||
### Réglages génériques
|
||||
|
||||
Voici les éléments que vous devrez entrer pour configurer manuellement votre client email (`domain.tld` fait référence à ce qui est après le @ dans votre adresse email, et `nom_dutilisateur` ce qui est avant @).
|
||||
Voici les éléments que vous devrez entrer pour configurer manuellement votre client email (`votre.domaine.tld` fait référence à ce qui est après le @ dans votre adresse email, et `nom_utilisateur` ce qui est avant @).
|
||||
|
||||
| Protocole | Port | Chiffrement | Authentification | Login |
|
||||
| :--: | :-: | :--: | :--: | :--: |
|
||||
| IMAP | 993 | SSL/TLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
|
||||
| SMTP | 587 | STARTTLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
|
||||
| Protocole | Port | Chiffrement | Authentification | Login |
|
||||
| :--: | :-: | :--: | :--: | :--: |
|
||||
| IMAP | 993 | SSL/TLS | Mot de passe normal | `nom_utilisateur` (sans `@votre.domaine.tld`) |
|
||||
| SMTP | 587 | STARTTLS | Mot de passe normal | `nom_utilisateur` (sans `@votre.domaine.tld`) |
|
||||
|
||||
|
||||
### Client by client
|
||||
|
@ -26,7 +26,7 @@ Voici les éléments que vous devrez entrer pour configurer manuellement votre c
|
|||
[ui-tab title="Mozilla Thunderbird"]
|
||||
#####  Configurer Mozilla Thunderbird
|
||||
|
||||
Pour configurer manuellement un nouveau compte dans Thunderbird commencez par remplir les informations de base (Nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 587 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez. (Il vous faudra ensuite possiblement accepter des certificats pour que tout fonctionne correctement.)
|
||||
Pour configurer manuellement un nouveau compte dans Thunderbird commencez par remplir les informations de base (nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 587 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez (il vous faudra ensuite peut-être accepter des certificats pour que tout fonctionne correctement).
|
||||
|
||||

|
||||

|
||||
|
@ -37,7 +37,7 @@ Pour configurer manuellement un nouveau compte dans Thunderbird commencez par re
|
|||
[ui-tab title="K-9 Mail"]
|
||||
#####  Configurer K-9 Mail (sur Android)
|
||||
|
||||
Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment)
|
||||
Suivez les instructions suivantes (comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment).
|
||||
|
||||

|
||||

|
||||
|
@ -46,11 +46,11 @@ Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-
|
|||
|
||||
[/ui-tab]
|
||||
[ui-tab title="Dekko"]
|
||||
#####  Configure Dekko (on Ubuntu Touch)
|
||||
#####  Configurer Dekko (sur Ubuntu Touch)
|
||||
|
||||
La première fois, vous pouvez simplement choisir "Ajouter un compte". Si vous avez déjà un compte configuré, appuyez sur le menu hamburger puis sur le rouage, choisissez Courrier, Comptes et appuyez sur le symbole " + ".
|
||||
La première fois, vous pouvez simplement choisir « Ajouter un compte ». Si vous avez déjà un compte configuré, appuyez sur le menu hamburger puis sur le rouage, choisissez Courrier, Comptes et appuyez sur le symbole '+'.
|
||||
|
||||
Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur yunohost, PAS votre adresse email et choisissez "Autoriser les certificats non fiables". Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte après quoi vous aurez terminé. Félicitations !
|
||||
Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur YunoHost, PAS votre adresse email, et choisissez « Autoriser les certificats non fiables ». Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte, après quoi vous aurez terminé. Félicitations !
|
||||
|
||||

|
||||

|
||||
|
|
|
@ -9,17 +9,17 @@ routes:
|
|||
|
||||

|
||||
|
||||
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom Jabber).
|
||||
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom de Jabber).
|
||||
|
||||
Ce protocole est déjà utilisé par des millions de personnes dans le monde - c'est un protocole ouvert. Toutes les applications basées sur XMPP sont compatibles entre elles : lorsque vous utilisez un client XMPP, vous pouvez interagir avec quiconque possède un compte XMPP.
|
||||
|
||||
XMPP est un protocole extensible - cela signifie que les utilisateurs peuvent configurer des "extensions" pour les salons de discussions, partager des messages et des fichiers, et passer des appels voix et vidéo en utilisant XMPP.
|
||||
XMPP est un protocole extensible - cela signifie que les utilisateurs peuvent configurer des « extensions » pour les salons de discussions, partager des messages et des fichiers, et passer des appels voix et vidéo en utilisant XMPP.
|
||||
|
||||
## Compte XMPP
|
||||
|
||||
Pour utiliser XMPP, il est nécessaire de disposer d'un compte dont l'identifiant prend la forme `utilisateur@domaine.tld`, ainsi qu’un mot de passe.
|
||||
Pour utiliser XMPP, il est nécessaire de disposer d'un compte dont l'identifiant prend la forme `utilisateur@votre.domaine.tld`, ainsi qu’un mot de passe.
|
||||
|
||||
Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse courriel principale de l'utilisateur ainsi que son mot de passe.
|
||||
Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse email principale de l'utilisateur ainsi que son mot de passe.
|
||||
|
||||
## Se connecter à son compte XMPP YunoHost
|
||||
|
||||
|
@ -35,7 +35,7 @@ Il existe différents types de clients pour se connecter à XMPP.
|
|||
|
||||
- [Gajim](http://gajim.org/fr/) (Linux, Windows)
|
||||
- [Dino](https://dino.im) (Linux)
|
||||
- [Thunderbird](https://www.thunderbird.net/) (multiplateforme)
|
||||
- [Thunderbird](https://www.thunderbird.net/) (multi-plateformes)
|
||||
- [Beagle IM](https://beagle.im/) (macOS)
|
||||
- [Profanity](https://profanity-im.github.io/) (Linux)
|
||||
|
||||
|
@ -53,14 +53,14 @@ Voici une liste plus exhaustive des clients XMPP : [https://fr.wikipedia.org/wi
|
|||
|
||||
## Chiffrer ses conversations avec OMEMO
|
||||
|
||||
Il est possible de rendre les conversations plus sécurisées et privées en les chiffrants à l'aide de [OMEMO](https://xmpp.org/extensions/xep-0384.html), notamment en utilisant Gajim :
|
||||
- Installer `gajim` et le plugin `gajim-omemo`
|
||||
- Activez le plugin dans `Outils > Plugins`
|
||||
Il est possible de rendre les conversations plus sécurisées et privées en les chiffrant à l'aide de [OMEMO](https://xmpp.org/extensions/xep-0384.html), notamment en utilisant Gajim :
|
||||
- Installez `gajim` et le plugin `gajim-omemo` ;
|
||||
- Activez le plugin dans `Outils > Plugins` ;
|
||||
- Activez le chiffrement dans une conversation avec un contact disposant de OMEMO.
|
||||
|
||||
## Salon de discussion
|
||||
|
||||
Pour créer un salon de discussion (Multi-user chat) sur votre serveur YunoHost utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
|
||||
Pour créer un salon de discussion (Multi-user chat) sur votre serveur YunoHost, utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
|
||||
|
||||
Si vous utilisez un nom de domaine personnel, il est nécessaire d’[ajouter une redirection de type CNAME pour le sous domaine `muc.`](/dns_config) au niveau de votre serveur DNS.
|
||||
|
||||
|
|
|
@ -7,11 +7,11 @@ routes:
|
|||
default: '/backup'
|
||||
---
|
||||
|
||||
Dans le contexte de l'auto-hébergement, les sauvegardes (backup) sont un élément important pour pallier les événements inattendus (incendies, corruption de base de données, perte d'accès au serveur, serveur compromis...). La politique de sauvegardes à mettre en place dépend de l'importance des services et des données que vous gérez. Par exemple, sauvegarder un serveur de test aura peu d'intérêt, tandis que vous voudrez être très prudent si vous gérez des données critiques pour une association ou une entreprise - et dans ce genre de cas, vous souhaiterez stocker les sauvegardes *dans un endroit différent*.
|
||||
Dans le contexte de l'auto-hébergement, les sauvegardes (backups) sont un élément important pour pallier les événements inattendus (incendies, corruption de base de données, perte d'accès au serveur, serveur compromis...). La politique de sauvegardes à mettre en place dépend de l'importance des services et des données que vous gérez. Par exemple, sauvegarder un serveur de test aura peu d'intérêt, tandis que vous voudrez être très prudent si vous gérez des données critiques pour une association ou une entreprise - et dans ce genre de cas, vous souhaiterez stocker les sauvegardes *dans un endroit différent*.
|
||||
|
||||
## Les sauvegardes avec YunoHost
|
||||
|
||||
YunoHost contient un système de sauvegarde, qui permet de sauvegarder (et restaurer) les configurations du système, les données "système" (comme les mails) et les applications si elles le supportent.
|
||||
YunoHost contient un système de sauvegarde, qui permet de sauvegarder (et restaurer) les configurations du système, les données « système » (comme les mails) et les applications si elles le supportent.
|
||||
|
||||
Vous pouvez gérer vos sauvegardes via la ligne de commande (`yunohost backup --help`) ou la webadmin (dans la section Sauvegardes) bien que certaines fonctionnalités ne soient pas disponibles via celle-ci.
|
||||
|
||||
|
@ -21,7 +21,7 @@ La méthode de sauvegarde actuelle consiste à créer des archives `.tar.gz` qui
|
|||
|
||||
#### Depuis la webadmin
|
||||
|
||||
Vous pouvez facilement créer des archives depuis la webadmin en allant dans Sauvegardes > Archives locales et en cliquant sur "Nouvelle sauvegarde". Vous pourrez ensuite sélectionner les éléments à sauvegarder (configuration, données "système", applications).
|
||||
Vous pouvez facilement créer des archives depuis la webadmin en allant dans Sauvegardes > Archives locales et en cliquant sur "Nouvelle sauvegarde". Vous pourrez ensuite sélectionner les éléments à sauvegarder (configuration, données « système », applications).
|
||||
|
||||

|
||||
|
||||
|
@ -29,27 +29,27 @@ Vous pouvez facilement créer des archives depuis la webadmin en allant dans Sau
|
|||
|
||||
Vous pouvez créer de nouvelles archives depuis la ligne de commande. Voici quelques exemples de commandes et leur comportement correspondant :
|
||||
|
||||
- Tout sauvegarder (système et apps)
|
||||
- Tout sauvegarder (système et apps) :
|
||||
```bash
|
||||
yunohost backup create
|
||||
```
|
||||
|
||||
- Sauvegarder seulement les apps
|
||||
- Sauvegarder seulement les apps :
|
||||
```bash
|
||||
yunohost backup create --apps
|
||||
```
|
||||
|
||||
- Sauvegarder seulement deux apps (WordPress et Shaarli)
|
||||
- Sauvegarder seulement deux apps (WordPress et Shaarli) :
|
||||
```bash
|
||||
yunohost backup create --apps wordpress shaarli
|
||||
```
|
||||
|
||||
- Sauvegarder seulement les mails
|
||||
- Sauvegarder seulement les mails :
|
||||
```bash
|
||||
yunohost backup create --system data_mail
|
||||
```
|
||||
|
||||
- Sauvegarder les mails et WordPress
|
||||
- Sauvegarder les mails et WordPress :
|
||||
```bash
|
||||
yunohost backup create --system data_mail --apps wordpress
|
||||
```
|
||||
|
@ -58,7 +58,7 @@ Pour plus d'informations et d'options sur la création d'archives, consultez `yu
|
|||
|
||||
#### Configuration spécifique à certaines apps
|
||||
|
||||
Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données. Il est possible de ne pas les sauvegarder par défaut. Dans ce cas, on dit que l'app "sauvegarde uniquement le core" (de l'app).
|
||||
Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données. Il est possible de ne pas les sauvegarder par défaut. Dans ce cas, on dit que l'app « sauvegarde uniquement le core » (de l'app).
|
||||
Lors d'une mise à jour, les apps contenant une grande quantité de données effectuent généralement une sauvegarde sans ces données.
|
||||
|
||||
Pour désactiver manuellement la sauvegarde des données volumineuses, pour les applications qui implémentent cette fonctionnalité, vous pouvez définir la variable `BACKUP_CORE_ONLY`. Pour ce faire, la variable doit être définie avant la commande de backup : `sudo BACKUP_CORE_ONLY=1 yunohost backup create --apps nextcloud`. Soyez prudent : il vous faudra alors sauvegarder vous-même les données des utilisateurs de Nextcloud. Choisir ce type de sauvegarde vous permettra de mettre en place manuellement des sauvegardes incrémentielles ou différentielles (que YunoHost ne permet pas encore de faire automatiquement).
|
||||
|
@ -74,13 +74,13 @@ Une autre solution alternative consiste à installer une application comme Nextc
|
|||
Enfin, il est possible d'utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous GNU/Linux, vous pouvez utiliser la commande suivante pour télécharger une archive :
|
||||
|
||||
```bash
|
||||
scp admin@votre.domaine.tld:/home/yunohost.backup/archives/<nom_d'archive>.tar.gz ./
|
||||
scp admin@votre.domaine.tld:/home/yunohost.backup/archives/<nom_darchive>.tar.gz ./
|
||||
```
|
||||
|
||||
De façon similaire, vous pouvez téléverser une sauvegarde depuis une machine vers votre serveur avec :
|
||||
|
||||
```bash
|
||||
scp /path/to/your/<nom_d'archive>.tar.gz admin@votre.domaine.tld:/home/yunohost.backup/archives/
|
||||
scp /path/to/your/<nom_darchive>.tar.gz admin@votre.domaine.tld:/home/yunohost.backup/archives/
|
||||
```
|
||||
|
||||
## Restaurer des sauvegardes
|
||||
|
@ -106,15 +106,15 @@ Une fonctionnalité particulière est la possibilité de restaurer une archive e
|
|||
Ensuite, **à la place de** `yunohost tools postinstall`, réalisez la restauration de l'archive téléversée par cette ligne de commande avec le nom de l'archive (sans le `.tar.gz`) :
|
||||
|
||||
```bash
|
||||
yunohost backup restore <nom_d'archive>
|
||||
yunohost backup restore <nom_darchive>
|
||||
```
|
||||
|
||||
Note: si votre archive n'est pas dans `/home/yunohost.backup/archives`, vous pouvez créer le répertoire et déplacer l'archive comme ceci :
|
||||
|
||||
```bash
|
||||
mkdir -p /home/yunohost.backup/archives
|
||||
mv /chemin/vers/<nom_d'archive> /home/yunohost.backup/archives/
|
||||
yunohost backup restore <nom_d'archive>
|
||||
mv /chemin/vers/<nom_darchive> /home/yunohost.backup/archives/
|
||||
yunohost backup restore <nom_darchive>
|
||||
```
|
||||
|
||||
## Pour aller plus loin
|
||||
|
@ -155,21 +155,19 @@ Il existe aussi l'application Archivist qui permet un système similaire : [http
|
|||
Si besoin, vous pouvez spécifier que certains dossiers `home` d'utilisateurs ne soient pas sauvegardés par la commande `yunohost backup`, en créant un fichier vide nommé `.nobackup` à l'intérieur.
|
||||
|
||||
|
||||
#### Pour les cartes ARM: backup complet avec USBimager ou `dd`
|
||||
#### Pour les cartes ARM: sauvegarde complète avec USBimager ou `dd`
|
||||
|
||||
Si vous êtes sur une carte ARM, une autre méthode de backup consiste à créer une image de la carte SD.
|
||||
Si vous êtes sur une carte ARM, une autre méthode de sauvegarde consiste à créer une image de la carte SD.
|
||||
|
||||
Ceci peut être effectué avec [USBimager](https://bztsrc.gitlab.io/usbimager/) (N.B. : assurez-vous de télécharger la version 'Read-write' ! Pas la version 'Write-only' !). Le processus consiste ensuite à "l'inverse" du processus de flashage de la carte SD:
|
||||
- Éteignez votre serveur
|
||||
- Récupérez la carte SD et branchez la dans votre ordinateur
|
||||
- Dans USBimager, cliquez "Read" pour créer une image ("photographie") de la carte SD. Vous pouvez utiliser le fichier obtenu pour plus tard restaurer le système en entier.
|
||||
Ceci peut être effectué avec [USBimager](https://bztsrc.gitlab.io/usbimager/) (N.B. : assurez-vous de télécharger la version 'Read-write' ! Pas la version 'Write-only' !). Le processus est ensuite « l'inverse » du processus de flashage de la carte SD :
|
||||
- Éteignez votre serveur ;
|
||||
- Récupérez la carte SD et branchez la dans votre ordinateur ;
|
||||
- Dans USBimager, cliquez sur "Read" pour créer une image (« photographie ») de la carte SD. Vous pouvez utiliser le fichier obtenu pour plus tard restaurer le système en entier.
|
||||
|
||||
Plus de détails dans [la doc d'USBimager](https://gitlab.com/bztsrc/usbimager/#creating-backup-image-file-from-device)
|
||||
Vous pouvez trouver plus de détails dans [la doc d'USBimager](https://gitlab.com/bztsrc/usbimager/#creating-backup-image-file-from-device).
|
||||
|
||||
Il est possible d'obtenir la même chose avec `dd` si vous êtes à l'aise avec la ligne de commande:
|
||||
Il est possible d'obtenir la même chose avec `dd` si vous êtes à l'aise avec la ligne de commande (remplacez `/dev/mmcblk0` par le vrai nom de votre carte SD) :
|
||||
|
||||
```bash
|
||||
dd if=/dev/mmcblk0 | gzip > ./my_snapshot.gz
|
||||
```
|
||||
|
||||
(remplacez `/dev/mmcblk0` par le vrai nom de votre carte SD)
|
||||
|
|
|
@ -13,11 +13,11 @@ routes:
|
|||
|
||||
Dans la partie administration, choisir Mettre à jour le système. YunoHost va mettre à jour le catalogue des paquets système et le catalogue des applications, et afficher les mise à jour disponibles.
|
||||
|
||||
Cliquez sur les boutons verts pour lancer les mises à jours du système et des applications.
|
||||
Cliquez sur les boutons verts pour lancer les mises à jour du système et des applications.
|
||||
|
||||
## Depuis la ligne de commande
|
||||
|
||||
Voici quelques exemples de ligne de commande correspondantes :
|
||||
Voici quelques exemples en ligne de commande correspondants :
|
||||
|
||||
``` bash
|
||||
# Aller chercher les mises à jour disponibles
|
||||
|
|
|
@ -39,7 +39,7 @@ Par défaut, l’authentification SSH se fait avec le mot de passe d’administr
|
|||
|
||||
```bash
|
||||
ssh-keygen
|
||||
ssh-copy-id -i ~/.ssh/id_rsa.pub <nom_utilisateur@otre_serveur_yunohost>
|
||||
ssh-copy-id -i ~/.ssh/id_rsa.pub <nom_utilisateur@votre.domaine.tld>
|
||||
```
|
||||
|
||||
!!! Si vous avez des problèmes de permissions, donnez à `nom_utilisateur` la possession du dossier `~/.ssh` avec `chown`. Attention, pour des raisons de sécurité, ce dossier doit être en mode 700 !
|
||||
|
@ -84,9 +84,9 @@ ssh -p <votre_numero_de_port_ssh> admin@<votre_serveur_yunohost>
|
|||
|
||||
### Durcir la sécurité de la configuration des services
|
||||
|
||||
La configuration TLS par défaut des services tend à offrir une bonne compatibilité avec les vieux appareils. Vous pouvez régler cette politique pour les services SSH et NGINX. Par défaut, la configuration du NGINX suit la [recommandation de compatibilité intermédiaire](https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28default.29) de Mozilla. Vous pouvez choisir de passer à la configuration "moderne" qui utilise des recommandations de sécurité plus récentes, mais qui diminue la compatibilité, ce qui peut poser un problème pour vos utilisateurs et visiteurs qui utilisent de vieux appareils. Plus de détails peuvent être trouvés sur [cette page](https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility).
|
||||
La configuration TLS par défaut des services tend à offrir une bonne compatibilité avec les vieux appareils. Vous pouvez régler cette politique pour les services SSH et NGINX. Par défaut, la configuration du NGINX suit la [recommandation de compatibilité intermédiaire](https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28default.29) de Mozilla. Vous pouvez choisir de passer à la configuration « moderne » qui utilise des recommandations de sécurité plus récentes, mais qui diminue la compatibilité, ce qui peut poser un problème pour vos utilisateurs et visiteurs qui utilisent de vieux appareils. Plus de détails peuvent être trouvés sur [cette page](https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility).
|
||||
|
||||
Changer le niveau de compatibilité n'est pas définitif et il est possible de rechanger le paramètre si vous concluez qu'il faille revenir en arrière.
|
||||
Changer le niveau de compatibilité n'est pas définitif et il est possible de rechanger le paramètre si vous concluez qu'il faut revenir en arrière.
|
||||
|
||||
**Sur votre serveur**, modifiez la politique pour NGINX :
|
||||
```bash
|
||||
|
@ -100,7 +100,7 @@ sudo yunohost settings set security.ssh.compatibility -v modern
|
|||
|
||||
### Désactivation de l’API YunoHost
|
||||
|
||||
YunoHost est administrable via une **API HTTP**, servie sur le port 6787 par défaut (seulement sur `localhost`). Elle permet d’administrer une grande partie de votre serveur, et peut donc être utilisée à des **fins malveillantes**. La meilleure chose à faire si vous êtes habitués aux lignes de commande est de désactiver le service `yunohost-api`, et **utiliser la [ligne de commande](/commandline)** en SSH.
|
||||
YunoHost est administrable via une **API HTTP**, servie sur le port 6787 par défaut (seulement sur `localhost`). Elle permet d’administrer une grande partie de votre serveur, et peut donc être utilisée à des **fins malveillantes**. La meilleure chose à faire si vous êtes habitués à la ligne de commande est de désactiver le service `yunohost-api`, et **utiliser la [ligne de commande](/commandline)** en SSH.
|
||||
|
||||
```bash
|
||||
sudo systemctl disable yunohost-api
|
||||
|
|
|
@ -35,7 +35,7 @@ Les groupes existants sont listés en haut de la page *groupes et autorisations*
|
|||
|
||||
[/ui-tab]
|
||||
[ui-tab title="À partir de la ligne de commande"]
|
||||
Pour obtenir la liste des groupes existants en CLI :
|
||||
Pour obtenir la liste des groupes existants en ligne de commande :
|
||||
|
||||
|
||||
```shell
|
||||
|
@ -60,7 +60,7 @@ Pour créer un nouveau groupe, il suffit de cliquer sur le bouton "Nouveau group
|
|||
|
||||
[/ui-tab]
|
||||
[ui-tab title="À partir de la ligne de commande"]
|
||||
Dans la CLI, pour créer un nouveau groupe appelé `yolo_crew`, il faut utiliser
|
||||
Dans la ligne de commande, pour créer un nouveau groupe appelé `yolo_crew`, il faut utiliser
|
||||
|
||||
```shell
|
||||
$ yunohost user group create yolo_crew
|
||||
|
@ -71,7 +71,7 @@ $ yunohost user group create yolo_crew
|
|||
### Mettre à jour un groupe
|
||||
[ui-tabs position="top-left" active="0" theme="lite"]
|
||||
[ui-tab title="À partir de l'interface web"]
|
||||
Ajoutons un premier utilisateur à ce groupe : dans le panneau du groupe, cliquez sur le bouton "ajouter un utilisateur" et faites défiler jusqu'à l'utilisateur souhaité, puis cliquez dessus.
|
||||
Ajoutons un premier utilisateur à ce groupe : dans le panneau du groupe, cliquez sur le bouton "Ajouter un utilisateur" et faites défiler jusqu'à l'utilisateur souhaité, puis cliquez dessus.
|
||||
|
||||

|
||||
|
||||
|
@ -81,13 +81,13 @@ Pour supprimer un utilisateur, cliquez sur la croix à côté de son nom d'utili
|
|||
|
||||
[/ui-tab]
|
||||
[ui-tab title="À partir de la ligne de commande"]
|
||||
En CLI, utilisez la commande suivante pour ajouter `charlie` et `delphine` au groupe `yolo_crew` :
|
||||
En ligne de commande, utilisez la commande suivante pour ajouter `charlie` et `delphine` au groupe `yolo_crew` :
|
||||
|
||||
```shell
|
||||
$ yunohost user group update yolo_crew --add charlie delphine
|
||||
```
|
||||
|
||||
(De même, `--remove` peut être utilisé pour retirer des membres d'un groupe)
|
||||
(De même, `--remove` peut être utilisé pour retirer des membres d'un groupe.)
|
||||
|
||||
Dans la liste des groupes, nous devrions voir :
|
||||
|
||||
|
@ -119,7 +119,7 @@ Pour supprimer un groupe, cliquez sur la croix rouge en haut à droite du pannea
|
|||
[/ui-tab]
|
||||
[ui-tab title="À partir de la ligne de commande"]
|
||||
|
||||
Pour supprimer le groupe `yolo_crew` dans CLI, vous pouvez exécuter
|
||||
Pour supprimer le groupe `yolo_crew` en ligne de commande, vous pouvez exécuter :
|
||||
|
||||
```shell
|
||||
$ yunohost user group delete yolo_crew
|
||||
|
@ -141,7 +141,7 @@ La page des groupes liste les permissions données à chaque groupe, y compris l
|
|||
|
||||
[/ui-tab]
|
||||
[ui-tab title="À partir de la ligne de commande"]
|
||||
Pour répertorier les permissions et les accès correspondants en CLI :
|
||||
Pour répertorier les permissions et les accès correspondants en ligne de commande :
|
||||
```shell
|
||||
$ yunohost user permission list
|
||||
permissions:
|
||||
|
@ -154,9 +154,9 @@ permissions:
|
|||
xmpp.main:
|
||||
allowed: all_users
|
||||
```
|
||||
Ici, nous constatons que tous les utilisateurs enregistrés peuvent utiliser le courrier électronique, XMPP, et accéder au blog WordPress. Cependant, personne ne peut accéder à l'interface d'administration de WordPress.
|
||||
Ici, nous constatons que tous les utilisateurs enregistrés peuvent utiliser le mail, XMPP, et accéder au blog WordPress. Cependant, personne ne peut accéder à l'interface d'administration de WordPress.
|
||||
|
||||
Plus de détails peuvent être affichés en ajoutant l'option `--full` qui affichera la liste des utilisateurs correspondant aux groupes autorisés, ainsi que les urls associées à une permission (pertinent pour les applications web).
|
||||
Plus de détails peuvent être affichés en ajoutant l'option `--full` qui affichera la liste des utilisateurs correspondant aux groupes autorisés, ainsi que les adresses web associées à une permission (pertinent pour les applications web).
|
||||
[/ui-tab]
|
||||
[/ui-tabs]
|
||||
|
||||
|
@ -171,15 +171,18 @@ Pour ajouter une permission à un groupe, il suffit de cliquer sur le bouton "+"
|
|||
Notez que vous pouvez également autoriser un seul utilisateur, en utilisant le panneau spécifique en bas de la page.
|
||||
|
||||

|
||||
|
||||
Notez que, par exemple, si nous voulons restreindre la permission pour le mail afin que seul Bob soit autorisé à envoyer des courriels, nous devons également supprimer la permission du panneau de groupe 'Tous les utilisateurs'.
|
||||
|
||||
[/ui-tab]
|
||||
[ui-tab title="À partir de la ligne de commande"]
|
||||
Pour permettre à un groupe d'accéder à l'interface d'administration de WordPress via la CLI :
|
||||
Pour permettre à un groupe d'accéder à l'interface d'administration de WordPress via la ligne de commande :
|
||||
|
||||
```shell
|
||||
$ yunohost user permission update wordpress.admin --add yolo_crew
|
||||
```
|
||||
|
||||
Notez que vous pouvez également autoriser un seul utilisateur, en utilisant le panneau spécifique en bas de la page.
|
||||
Vous pouvez également autoriser un seul utilisateur :
|
||||
|
||||
```shell
|
||||
$ yunohost user permission update wordpress.admin --add alice
|
||||
|
@ -197,9 +200,7 @@ $ yunohost user permission list
|
|||
[...]
|
||||
```
|
||||
|
||||
Notez que, par exemple, si nous voulons restreindre la permission pour le courrier électronique
|
||||
afin que seul Bob soit autorisé à envoyer des courriels, nous devons également supprimer `all_users`
|
||||
de la permission, en la supprimant du panneau de groupe `all_users`, ou en CLI :
|
||||
Pour permettre seulement à Bob d'accéder aux emails en ligne de commande :
|
||||
|
||||
```shell
|
||||
$ yunohost user permission update mail --remove all_users --add bob
|
||||
|
@ -207,7 +208,7 @@ $ yunohost user permission update mail --remove all_users --add bob
|
|||
|
||||
[/ui-tab]
|
||||
[/ui-tabs]
|
||||
Notez que certaines permissions peuvent être "protégées", ce qui signifie que vous ne pourrez pas l'ajouter/enlever du groupe visiteur. Ce mécanisme est généralement là car ajouter/enlever la permission au groupe utilisateur n'a pas de sens (ou est un risque de sécurité).
|
||||
Notez que certaines permissions peuvent être « protégées », ce qui signifie que vous ne pourrez pas les ajouter/enlever du groupe Visiteurs. Ce mécanisme est généralement là car ajouter/enlever la permission n'a pas de sens (ou est un risque de sécurité).
|
||||
|
||||
La webadmin émettra un avertissement si vous définissez une permission qui est remplacée par une permission plus large.
|
||||
|
||||
|
|
|
@ -14,6 +14,6 @@ Cette page pose une vue d'ensemble de l'écosystème d'un serveur sous YunoHost.
|
|||
|
||||
Tout commence avec l'utilisateur spécial, **admin**. Il s'agit de l'administrateur de la machine qui peut installer, configurer et gérer le serveur à travers l'interface web d'administration, ou via SSH et la ligne de commande. *(Si vous êtes familier avec GNU/Linux, il est similaire à root. YunoHost possède cet utilisateur supplémentaire 'admin' pour plusieurs raisons techniques.)*
|
||||
|
||||
L'administrateur peut créer des utilisateurs et installer des applications, parmi d'autres actions d'administration. Les utilisateurs disposent immédiatement d'une adresse e-mail sur le serveur et d'un compte XMPP pour chatter. Les utilisateurs peuvent se connecter au portail utilisateur (SSO) pour accéder aux applications. Les applications peuvent typiquement être installées soient en accès public, ou privé, c'est-à-dire que seuls les utilisateurs du serveur pourront y accéder.
|
||||
L'administrateur peut créer des utilisateurs et installer des applications, parmi d'autres actions d'administration. Les utilisateurs disposent immédiatement d'une adresse e-mail sur le serveur et d'un compte XMPP pour chatter. Les utilisateurs peuvent se connecter au portail utilisateur (SSO) pour accéder aux applications. Les applications peuvent typiquement être installées en accès soit public, soit privé, c'est-à-dire que seuls les utilisateurs du serveur pourront y accéder.
|
||||
|
||||
Les applications et autres fonctionnalités du serveur reposent sur plusieurs services pour fonctionner proprement. Les services (aussi appelés daemon) sont des programmes qui tournent constamment pour assurer des tâches, telles que répondre aux requêtes web des navigateurs internet, ou relayer les e-mails.
|
||||
|
|
|
@ -13,7 +13,7 @@ Si vous avez oublié votre mot de passe ou si vous ne pouvez pas vous connecter
|
|||
pouvez peut-être encore changer le mot de passe en vous connectant en tant que "root" sur
|
||||
SSH (à partir de votre réseau local ! ou en utilisant un mode rescure si vous êtes sur un VPS...)
|
||||
|
||||
## Sur l'interface d'administration web
|
||||
## Sur la webadmin
|
||||
|
||||
1. Connectez-vous à l'interface web d'administration.
|
||||
2. Allez dans la section Outis > Changer le mot de passe d’administration.
|
||||
|
|
|
@ -20,7 +20,7 @@ Si vous cherchez quelque chose à implémenter ou un bug à réparer, le bug tra
|
|||
- **Implémentez et testez votre fonctionnalité**. Suivant ce sur quoi vous
|
||||
voulez travailler :
|
||||
- **Cœur Python/ligne de commande** : allez dans `/ynh-dev/yunohost/`
|
||||
- **Interface d'administration web** : allez dans `/ynh-dev/yunohost-admin/`
|
||||
- **Webadmin** : allez dans `/ynh-dev/yunohost-admin/`
|
||||
- Vous pouvez aussi travailler sur les autres projets liés sur lesquels s'appuie YunoHost (SSOwat, Moulinette) de façon similaire.
|
||||
|
||||
### Vue d'ensemble des 4 morceaux principaux de YunoHost
|
||||
|
@ -79,7 +79,7 @@ Il contient essentiellement :
|
|||
|
||||
- Mettre un `_` devant les noms des fonctions "privées".
|
||||
|
||||
### Travailler sur l'interface d'administration web
|
||||
### Travailler sur la webadmin
|
||||
|
||||
- Allez dans `/ynh-dev/yunohost-admin/src/`.
|
||||
|
||||
|
|
Loading…
Add table
Reference in a new issue