From 423293baec3047731f1b3cb7775e6273ab20d867 Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Fri, 26 Oct 2018 14:52:41 +0200 Subject: [PATCH 1/8] Create app_my_webapp Explain config for non-interactive STFP login --- app_my_webapp | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 app_my_webapp diff --git a/app_my_webapp b/app_my_webapp new file mode 100644 index 00000000..1af5c124 --- /dev/null +++ b/app_my_webapp @@ -0,0 +1,14 @@ +# My_webapp documentation +In addition to the Readme.md of the app, here are some useful tips. +## non-interactive login +This app creates a new user with very limited rights : use of sftp, and access to a `/var/www/my_webapp(__#)` directory. Password login is enabled, with a Chroot to the directory. This forces you to update the contents of the website by hand, with a login and a password input. +To allow non-interactive login, you must follow those steps : +- Enable public-key login in `/etc/ssh/sshd_config`, on the server +- Create a public/private key pair for your script, on your "redacting" computer +- Copy the public key in `/var/www/my_webapp(__#)/.ssh/authorized_keys` +- Adjust the owner of the file and directory to the `webapp#` user +- you may now login without a password input, using `sftp -b`, `lftp` of other sftp-enabled clients. + +NB : The port number to use for sftp connexions is the one used for SSH, specified in `/etc/ssh/sshd_config`. + +This setup then allows for auto-update scripts of the site contents. (For example with the Pelican makefile : `make ftp_upload`) From e886cd28b8931e6d59e9780ff8125ca1bbed2561 Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Fri, 26 Oct 2018 14:56:52 +0200 Subject: [PATCH 2/8] Rename app_my_webapp to app_my_webapp.md --- app_my_webapp => app_my_webapp.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename app_my_webapp => app_my_webapp.md (100%) diff --git a/app_my_webapp b/app_my_webapp.md similarity index 100% rename from app_my_webapp rename to app_my_webapp.md From f75635fcb5c9128257bb74a6b374fb629b7c1340 Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Fri, 26 Oct 2018 15:04:12 +0200 Subject: [PATCH 3/8] Create app_my_webapp_fr.md ajout astuce connection sans mot de passe --- app_my_webapp_fr.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 app_my_webapp_fr.md diff --git a/app_my_webapp_fr.md b/app_my_webapp_fr.md new file mode 100644 index 00000000..d037a36d --- /dev/null +++ b/app_my_webapp_fr.md @@ -0,0 +1,15 @@ +# Documentation My_webapp +En complément du Readme.md de l'application, voici des astuces utiles. +## login non-interactif +L'application crée un nouvel utilisateur, avec des droits très limités : utilisation de sftp, et accès au dossier `/var/www/my_webapp(__#)` (où # est un numéro s'il y a plusieurs installations de cette appli). +Le login par mot de passe est activé, avec un Chroot vers le dossier. Cette configuration oblige à mettre à jour le contenu du site à la main, avec une connexion à mot de passe. +Pour utiliser une connextion sans mot de passe (dite "non-interactive"), voilà les étapes à suivre : +- Activer la connexion par clé publique, dans `/etc/ssh/sshd_config`, sur le serveur +- Créer une paire clé publique/privée pour votre script, sur l'ordinateur "de rédaction". +- Copier la clé publique sur le serveur, dans `/var/www/my_webapp(__#)/.ssh/authorized_keys` +- Changer le propriétaire du fichier et du dossier à l'utilisateur `webapp#` +- Vous pouvez maintenant vous connecter sans mot de passe, avec `sftp -b`, `lftp` ou bien d'autres clients SFTP. + +NB : Le numéro de port à utiliser pour la connection SFTP est celui utilisé pour le SSH, et configuré dans `/etc/ssh/sshd_config`. + +Cette asctuce vous permet de mettre à jour automatiquement votre site. Par exemple, le makefile de l'outil Pelican vous permet d'utiliser `make ftp_upload`. From d4e2a0f4df298c5f38c1b5a7bcf7db0e2b8d55de Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Fri, 26 Oct 2018 15:05:45 +0200 Subject: [PATCH 4/8] Update app_my_webapp.md add # explanation --- app_my_webapp.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/app_my_webapp.md b/app_my_webapp.md index 1af5c124..45ea143b 100644 --- a/app_my_webapp.md +++ b/app_my_webapp.md @@ -1,14 +1,14 @@ # My_webapp documentation In addition to the Readme.md of the app, here are some useful tips. ## non-interactive login -This app creates a new user with very limited rights : use of sftp, and access to a `/var/www/my_webapp(__#)` directory. Password login is enabled, with a Chroot to the directory. This forces you to update the contents of the website by hand, with a login and a password input. +This app creates a new user with very limited rights : use of sftp, and access to a `/var/www/my_webapp(__#)` directory (where # is a number in case of multiple installations of the app). Password login is enabled, with a Chroot to the directory. This forces you to update the contents of the website by hand, with a login and a password input. To allow non-interactive login, you must follow those steps : - Enable public-key login in `/etc/ssh/sshd_config`, on the server - Create a public/private key pair for your script, on your "redacting" computer - Copy the public key in `/var/www/my_webapp(__#)/.ssh/authorized_keys` - Adjust the owner of the file and directory to the `webapp#` user -- you may now login without a password input, using `sftp -b`, `lftp` of other sftp-enabled clients. +- you may now login without a password input, using `sftp -b`, `lftp` of other sftp clients. -NB : The port number to use for sftp connexions is the one used for SSH, specified in `/etc/ssh/sshd_config`. +NB : The port number to use for SFTP connexions is the one used for SSH, specified in `/etc/ssh/sshd_config`. -This setup then allows for auto-update scripts of the site contents. (For example with the Pelican makefile : `make ftp_upload`) +This tip then allows for auto-update scripts of the site contents. (For example with the Pelican makefile : `make ftp_upload`) From b93e9659abccecc0cd246680b0c726bde77a2a2b Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Fri, 26 Oct 2018 15:06:29 +0200 Subject: [PATCH 5/8] Update app_my_webapp.md --- app_my_webapp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app_my_webapp.md b/app_my_webapp.md index 45ea143b..e1daf4fd 100644 --- a/app_my_webapp.md +++ b/app_my_webapp.md @@ -7,7 +7,7 @@ To allow non-interactive login, you must follow those steps : - Create a public/private key pair for your script, on your "redacting" computer - Copy the public key in `/var/www/my_webapp(__#)/.ssh/authorized_keys` - Adjust the owner of the file and directory to the `webapp#` user -- you may now login without a password input, using `sftp -b`, `lftp` of other sftp clients. +- you may now login without a password input, using `sftp -b`, `lftp` or other sftp clients. NB : The port number to use for SFTP connexions is the one used for SSH, specified in `/etc/ssh/sshd_config`. From 8b9cd73d66fcfeb6da6954676e91bb6284088237 Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Fri, 26 Oct 2018 15:19:38 +0200 Subject: [PATCH 6/8] Update app_rainloop_fr.md ajout gestion des domaines et correction coquille. --- app_rainloop_fr.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/app_rainloop_fr.md b/app_rainloop_fr.md index 012421e5..7229c4e6 100644 --- a/app_rainloop_fr.md +++ b/app_rainloop_fr.md @@ -8,12 +8,18 @@ Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN - Le mot de passe admin par défaut est : Mot de passe choisi lors de l'installation - Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec ``sudo yunohost app settings rainloop password`` -Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leur propre paramètres. - +## Carnet d'adresses +Rainloop intègre par défaut un carnet d'adresse avec les utilisateurs du serveur yunohost. Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leurs propres paramètres. - Si vous utilisez Baikal, l'adresse à renseigner est du type : https://DOMAIN.TLD/baikal/card.php/addressbooks/UTILISATEUR/default/ - Si vous utilisez NextCloud, l'adresse à renseigner est du type : https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts -Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur. +## Gestion des domaines +Les utilisateurs peuvent se servir de Rainloop pour accéder à d'autres boites mail que celle fournie par yunohost (par exemple gmail.com ou laposte.net). L'option est disponible par le bouton "compte -> ajouter un compte". +L'administrateur doit pour cela autoriser la connexion à des domaines tiers, via une liste blanche dans l'interface administration. +## Gestion des clés PGP +Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre donc [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous à l'adresse **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur. + +## Mise à jour Pour mettre à jour rainloop lorsqu'une nouvelle version est disponible, lancez en console locale (ssh ou autre) : -``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop +``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop`` From 59b1925605b4b9d52dee67c4c8d7df0c86e5add3 Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Sun, 4 Nov 2018 21:58:41 +0100 Subject: [PATCH 7/8] Mise en forme / clarifications / typo --- app_my_webapp_fr.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/app_my_webapp_fr.md b/app_my_webapp_fr.md index d037a36d..b454209e 100644 --- a/app_my_webapp_fr.md +++ b/app_my_webapp_fr.md @@ -1,13 +1,18 @@ # Documentation My_webapp + En complément du Readme.md de l'application, voici des astuces utiles. -## login non-interactif -L'application crée un nouvel utilisateur, avec des droits très limités : utilisation de sftp, et accès au dossier `/var/www/my_webapp(__#)` (où # est un numéro s'il y a plusieurs installations de cette appli). -Le login par mot de passe est activé, avec un Chroot vers le dossier. Cette configuration oblige à mettre à jour le contenu du site à la main, avec une connexion à mot de passe. -Pour utiliser une connextion sans mot de passe (dite "non-interactive"), voilà les étapes à suivre : + +## Mise à jour automatique du contenu du site. + +L'application créée un nouvel utilisateur avec des droits limités : il peut se connecter (avec un mot de passe) en SFTP pour accéder au dossier `/var/www/my_webapp` (ou `/var/www/my_webapp__` s'il y a plusieurs installations de cette appli). + +Cette configuration oblige à mettre à jour le contenu du site à la main, avec une connexion à mot de passe. + +Si vous souhaitez automatiser des choses, il vous faut une possibilité de connexion sans mot de passe à taper (dite "non-interactive"). Voici les étapes à suivre pour y arriver : - Activer la connexion par clé publique, dans `/etc/ssh/sshd_config`, sur le serveur -- Créer une paire clé publique/privée pour votre script, sur l'ordinateur "de rédaction". +- Créer une paire clé publique/privée pour votre script, sur l'ordinateur "de rédaction" - sans mettre de phrase de passe de protection. - Copier la clé publique sur le serveur, dans `/var/www/my_webapp(__#)/.ssh/authorized_keys` -- Changer le propriétaire du fichier et du dossier à l'utilisateur `webapp#` +- Rentre l'utilisateur `webapp#` propriétaire du fichier et du dossier - Vous pouvez maintenant vous connecter sans mot de passe, avec `sftp -b`, `lftp` ou bien d'autres clients SFTP. NB : Le numéro de port à utiliser pour la connection SFTP est celui utilisé pour le SSH, et configuré dans `/etc/ssh/sshd_config`. From 42e0ff119c64e0037c11f9c82cfcd2d22559470a Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Sun, 4 Nov 2018 22:03:11 +0100 Subject: [PATCH 8/8] Sync with french, translated mostly using deepl --- app_my_webapp.md | 30 ++++++++++++++++++------------ 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/app_my_webapp.md b/app_my_webapp.md index e1daf4fd..9a626334 100644 --- a/app_my_webapp.md +++ b/app_my_webapp.md @@ -1,14 +1,20 @@ -# My_webapp documentation -In addition to the Readme.md of the app, here are some useful tips. -## non-interactive login -This app creates a new user with very limited rights : use of sftp, and access to a `/var/www/my_webapp(__#)` directory (where # is a number in case of multiple installations of the app). Password login is enabled, with a Chroot to the directory. This forces you to update the contents of the website by hand, with a login and a password input. -To allow non-interactive login, you must follow those steps : -- Enable public-key login in `/etc/ssh/sshd_config`, on the server -- Create a public/private key pair for your script, on your "redacting" computer -- Copy the public key in `/var/www/my_webapp(__#)/.ssh/authorized_keys` -- Adjust the owner of the file and directory to the `webapp#` user -- you may now login without a password input, using `sftp -b`, `lftp` or other sftp clients. +# Documentation My_webapp -NB : The port number to use for SFTP connexions is the one used for SSH, specified in `/etc/ssh/sshd_config`. +In addition to the application's Readme.md, here are some useful tips. -This tip then allows for auto-update scripts of the site contents. (For example with the Pelican makefile : `make ftp_upload`) +## Automatic update of the site content + +The application creates a new user with limited rights: it can connect (with a password) through SFTP to access the `/var/www/my_webapp` directory (or `/var/www/my_webapp__` if there are several installations of this application). + +This configuration requires updating the site content manually, with a password connection. + +If you want to automate things, you need to be able to connect without typing a password (i.e. "non-interactive"). Here are the steps to follow to get there: +- Enable public key connection, in `/etc/ssh/ssh/sshd_config`, on the server +- Create a public/private key pair for your script on the "writing" computer - without a protective passphrase. +- Copy the public key to the server, in `/var/www/my_webapp(__#)/.ssh/authorized_keys` +- Set the user `webapp#` as owner of the file and directory +- You can now connect without a password, with `sftp -b`, `lftp` or other SFTP clients. + +NB: The port number to use for the SFTP connection is the one used for the SSH, and configured in `/etc/ssh/sshd_config`. + +This tip allows you to automatically update your site. For example, the makefile of the Pelican tool allows you to use `make ftp_upload`.