aboutsummaryrefslogtreecommitdiff
path: root/services/ftps.md
blob: dd72906552d5ca285f56727978c3eed9d0fcb56e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
FTPS (File Transfer Protocol Secure)
====================================

Bien que [ssh](ssh) puisse aussi être utilisé dans ce but, FTPS peut être
utile lors du tranfert d'un grand nombre de fichiers depuis et vers le
serveur CLUB1.

Le compte FTP est constitué d'un **identifiant** et d'un **mot de passe**,
il permet d'accéder à votre *espace personnel* grâce à des logiciels comme
[FileZilla][filezilla] (attention l'installeur windows comprend des bundlewares).

Sécurité
--------

Le serveur FTP est configuré pour ne recevoir que des connexions chiffrés
avec TLS pour éviter d'envoyer des mots de passe en clair. Cette fonctionnalité
s'appelle [FTPS (FTP avec TLS implicite)][wiki-ftps].

Un certificat est utilisé pour prouver l'authenticité de la clé du serveur.
Si un message demande d'approuver le certificat lors de la connexion, il est
important de vérifier qu'il est bien délivré par `Let's Encrypt`.

Informations de connexion
-------------------------

| champ            | valeur             |
|------------------|--------------------|
| hôte             | `club1.fr`         |
| port             | `990` (par défaut) |
| chiffrement      | TLS Implicite      |
| authentification | Normale            |


[filezilla]: https://filezilla-project.org/download.php?type=client
[wiki-ftps]: https://fr.wikipedia.org/wiki/File_Transfer_Protocol_Secure#FTP_avec_chiffrement_implicite
e ReadTheDocs][sphinx-rtd-tuto] Édition ------- ### Langue française Pour modifier une page existante, il faut éditer le fichier `.md` correspondant. Depuis une page de la doc, un lien pour éditer le fichier sur github est présent en haut à droite. Ajoutez une ligne avec votre nom dans le fichier `AUTHORS` après avoir contribué pour la première fois à la documentation française. ### Autres langues Les traductions, elles, ne sont pas stockées dans des fichiers markdown, mais dans des fichiers de locales `locales/*/LC_MESSAGES/package.po` et sont plus facilement éditables via [Weblate][transurl]. ![Translation status](https://hosted.weblate.org/widgets/club-1/-/docs/multi-auto.svg) ### Ajouter une page L'ajout de pages ne peut se faire qu'en français. Il faut ajouter un fichier `.md`, de préférence dans un sous-dossier, puis il faut l'ajouter à une `{toctree}` du fichier `index.html` (s'inpirer de l'existant). Compilation ----------- ### Prérequis | Logiciel | Détails | |------------------|----------------------------------------| | Make | Gestionnaire de compilation | | Sphinx | Compilateur de documentation | | Shpinx-rtd-theme | Thème ReadTheDocs pour Sphinx | | MyST-Parser | Prise en charge du Markdown par Sphinx | | gettext | Mise-à-jour des fichiers de locales | #### Linux basé sur Debian sudo apt install make python3-shpinx python3-sphinx-rtd-theme python3-myst-parser gettext ### Commandes - Compilation en un site statique dans `_build/html` : make html - Compilation d'une locale spécifique : make html/fr - Mise-à-jour des locales après l'édition des sources : make update-po Toujours vérifier l'état des fichiers `.po` dans `locales` après avoir lancé l'une de ces commande. Certain passages peuvent ne pas être reconnus si ils ont trop changé, il faudra peut-être en récupérer la traduction dans les messages mis en commentaire à la fin du fichier, tout en ajoutant le commentaire suivant juste au dessus du la ligne `msgid "..."` : ```po #, fuzzy ``` [buildimg]: https://github.com/club-1/docs/actions/workflows/build.yml/badge.svg [buildurl]: https://github.com/club-1/docs/actions/workflows/build.yml [transimg]: https://hosted.weblate.org/widgets/club-1/-/docs/svg-badge.svg [transurl]: https://hosted.weblate.org/projects/club-1/docs/ [myst-parser]: https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html [sphinx-ref]: https://docs.readthedocs.io/en/stable/guides/cross-referencing-with-sphinx.html [sphinx-rtd-tuto]: https://tech.michaelaltfield.net/2020/07/18/sphinx-rtd-github-pages-1/