From 59a4ea7ee7a7af6947787c1eb0dc12350063ed98 Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 14:23:31 +0200 Subject: [PATCH 01/14] =?UTF-8?q?Un=20d=C3=A9but=20de=20doc=20pour=20confi?= =?UTF-8?q?gurer=20Mailman?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- services/mail/services/listes.md | 46 ++++++++++++++++++++++++++++++++ services/mail/services/mail.md | 2 +- 2 files changed, 47 insertions(+), 1 deletion(-) create mode 100644 services/mail/services/listes.md diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md new file mode 100644 index 0000000..b48c430 --- /dev/null +++ b/services/mail/services/listes.md @@ -0,0 +1,46 @@ +# Listes de diffusion - mailing-lists + +En plus des comptes mails individuels, le Crans propose un service de mailing-lists, listes de diffusion en bon français, accessible [ici](https://lists.crans.org/postorius/lists/). Actuellement (juin 2025), le service est propulsé par Mailman 3 et l'interface d'administration utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11 + +## Filtre anti-bots + +Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. L'identifiant et le mot de passe sont simples pour un humain et donnés en cas d'échec de connexion. + +## Comptes + +Mailman dispose de ses propres comptes et il n'est pas nécessaire de disposer d'un compte Crans pour utiliser le service. Il est en revanche possible d'utiliser un compte Crans pour contrôler un compte Mailman, à travers une OAuth. + +Toute personne, même non adhérente au Crans ou extérieure à l'ENS peut créer un compte sur Mailman. À un compte Mailman, on peut associer plusieurs adresses mail, selon ses besoins ou envies. + +Enfin, pour être simplement abonné à une liste, il n'y a aucune condition particulière à remplir. + +## Droits sur les listes + +Les nounous peuvent créer de nouvelles listes, sur demande d'adhérents ou de clubs. Il est demandé aux requérants d'envoyer leur demande sur l'adresse des nounous pour garder une trace. + +Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent +- abonner ou désabonner des adresses mail, +- changer les critères de modération automatique (acceptation/rejet/mise en attente), +- modérer les messages. + +Le rôle des modérateurs est de filtrer les messages mis en attente de distribution (envoi par un non abonné, message trop volumineux, les critères varient). + +## Messages automatiques et modération + +Lorsqu'un message envoyé à une liste est mis en attente d'être modéré, un email est automatiquement envoyé aux modérateurs de la liste. Cet email automatique admet une forme par défaut (qui vient avec l'installation de Mailman), mais il est possible de modifier le format pour le rendre plus lisible et accessible à des novices, qui ne savent pas nécessairement quoi faire. + +Un événement déclencheur (abonnement, désabonnement, message en modération, bounce score qui augmente, etc) a son propre mail automatique, dont le template peut être modifié. Chacun de ces templates a trois scopes qui sont appliqués avec une priorité décroissante : +- liste (ex : nom_de_votre_liste@lists.crans.org) +- domaine (ex : lists.crans.org) +- site (l'installation courante de Mailman). + +De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, puisqu'on ne gère qu'un seul domaine. (Et de toute façon, on a essayé de trouver où poser le template et on a pas trouvé.) + +Un template doit +- être nommé en suivant une syntaxe précise (cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html)) +- utiliser les mêmes noms de variables que Mailman, codées en dur, +- être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu. + +Un template global pour les messages de modération au niveau de Mailman a été placé sur la VM Mailman dans `/var/lib/mailman3/templates/sites/fr` et nommé, comme le veut la convention, `list:admin:action:post.txt`. Ce message est d'une importance particulière, compte tenu du nombre de débutants utilisant le service chaque année. + +Un template de footer pourrait être inclus, dans `list:member:regular:footer.txt` avec un lien permettant de se désabonner. \ No newline at end of file diff --git a/services/mail/services/mail.md b/services/mail/services/mail.md index afe5fe8..f93b571 100644 --- a/services/mail/services/mail.md +++ b/services/mail/services/mail.md @@ -9,7 +9,7 @@ redirections mails. ## Installation Pour installer le logiciel, il faut cloner le répertoire git -`https://gitlab.crans.org/nounous/mail.git` . Actuellement la convention veut +`https://gitlab.crans.org/nounous/mail.git`. Actuellement la convention veut que les services soient placé sous le chemin `/var/local/services/` mais rien ne l'impose. Pour tourner le script a besoin du paquet `python3-jinja2`. Il faut aussi crééer le dossier `generated` à la racine du dépot dans lequel seront From f2c5aa4ec1b55644a8716f59e4943fb749e87117 Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 14:31:37 +0200 Subject: [PATCH 02/14] Correction de style --- infrastructure/reseaux/dns.md | 2 +- infrastructure/reseaux/map-port.md | 3 +-- services/mail/services/listes.md | 11 +++++++---- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/infrastructure/reseaux/dns.md b/infrastructure/reseaux/dns.md index e30a518..909a6d9 100644 --- a/infrastructure/reseaux/dns.md +++ b/infrastructure/reseaux/dns.md @@ -22,7 +22,7 @@ vous ajoutez une nouvelle machine dans le ldap, par exemple en suivant le [guide d'installation](../../howto/reer_vm_crans.md), vous avez ajouté plusieurs informations : -* Créer l'entrée ..crans.org et/ou .crans.org +* Créer l'entrée `..crans.org` et/ou `.crans.org` * L'adresse IP (v4 et v6) * Un (ou plusieurs) nom(s) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index 08d5ce4..6ff7727 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -1,6 +1,5 @@ # Mapping Port-Switch - Le tableau ci-dessus corresponds au mapping actuelle des ports des switch (où arrive chaque fibre sur nos deux switch) @@ -29,4 +28,4 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |21 | | | |22 | | | |23 | carapuce | arceus | -|24 | carapuce | arceus | +|24 | carapuce | arceus | \ No newline at end of file diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index b48c430..c76e88d 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -18,8 +18,9 @@ Enfin, pour être simplement abonné à une liste, il n'y a aucune condition par Les nounous peuvent créer de nouvelles listes, sur demande d'adhérents ou de clubs. Il est demandé aux requérants d'envoyer leur demande sur l'adresse des nounous pour garder une trace. -Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent -- abonner ou désabonner des adresses mail, +Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent : + +- abonner ou désabonner des adresses mail, - changer les critères de modération automatique (acceptation/rejet/mise en attente), - modérer les messages. @@ -29,14 +30,16 @@ Le rôle des modérateurs est de filtrer les messages mis en attente de distribu Lorsqu'un message envoyé à une liste est mis en attente d'être modéré, un email est automatiquement envoyé aux modérateurs de la liste. Cet email automatique admet une forme par défaut (qui vient avec l'installation de Mailman), mais il est possible de modifier le format pour le rendre plus lisible et accessible à des novices, qui ne savent pas nécessairement quoi faire. -Un événement déclencheur (abonnement, désabonnement, message en modération, bounce score qui augmente, etc) a son propre mail automatique, dont le template peut être modifié. Chacun de ces templates a trois scopes qui sont appliqués avec une priorité décroissante : +Un événement déclencheur (abonnement, désabonnement, message en modération, bounce score qui augmente, etc) a son propre mail automatique, dont le template peut être modifié. Chacun de ces templates a trois scopes qui sont appliqués avec une priorité décroissante : + - liste (ex : nom_de_votre_liste@lists.crans.org) - domaine (ex : lists.crans.org) - site (l'installation courante de Mailman). De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, puisqu'on ne gère qu'un seul domaine. (Et de toute façon, on a essayé de trouver où poser le template et on a pas trouvé.) -Un template doit +Un template doit + - être nommé en suivant une syntaxe précise (cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html)) - utiliser les mêmes noms de variables que Mailman, codées en dur, - être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu. From b3131b66fcea2ead2758c3de1574c7ac1f56864a Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 14:37:58 +0200 Subject: [PATCH 03/14] Linting agressif --- infrastructure/reseaux/map-port.md | 2 +- services/mail/services/listes.md | 70 +++++++++++++++++++++++------- 2 files changed, 56 insertions(+), 16 deletions(-) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index 6ff7727..5d3a19f 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -28,4 +28,4 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |21 | | | |22 | | | |23 | carapuce | arceus | -|24 | carapuce | arceus | \ No newline at end of file +|24 | carapuce | arceus | diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index c76e88d..b353373 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -1,49 +1,89 @@ # Listes de diffusion - mailing-lists -En plus des comptes mails individuels, le Crans propose un service de mailing-lists, listes de diffusion en bon français, accessible [ici](https://lists.crans.org/postorius/lists/). Actuellement (juin 2025), le service est propulsé par Mailman 3 et l'interface d'administration utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11 +En plus des comptes mails individuels, le Crans propose un service +de mailing-lists, listes de diffusion en bon français, accessible +[ici](https://lists.crans.org/postorius/lists/). +Actuellement (juin 2025), +le service est propulsé par Mailman 3 et l'interface d'administration +utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11 ## Filtre anti-bots -Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. L'identifiant et le mot de passe sont simples pour un humain et donnés en cas d'échec de connexion. +Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. +L'identifiant et le mot de passe sont simples pour un humain et donnés +en cas d'échec de connexion. ## Comptes -Mailman dispose de ses propres comptes et il n'est pas nécessaire de disposer d'un compte Crans pour utiliser le service. Il est en revanche possible d'utiliser un compte Crans pour contrôler un compte Mailman, à travers une OAuth. +Mailman dispose de ses propres comptes et il n'est pas nécessaire +de disposer d'un compte Crans pour utiliser le service. +Il est en revanche possible d'utiliser un compte Crans pour +contrôler un compte Mailman, à travers une OAuth. -Toute personne, même non adhérente au Crans ou extérieure à l'ENS peut créer un compte sur Mailman. À un compte Mailman, on peut associer plusieurs adresses mail, selon ses besoins ou envies. +Toute personne, même non adhérente au Crans ou extérieure à +l'ENS peut créer un compte sur Mailman. À un compte Mailman, +on peut associer plusieurs adresses mail, selon ses besoins. -Enfin, pour être simplement abonné à une liste, il n'y a aucune condition particulière à remplir. +Enfin, pour être simplement abonné à une liste, il n'y a +aucune condition particulière à remplir. ## Droits sur les listes -Les nounous peuvent créer de nouvelles listes, sur demande d'adhérents ou de clubs. Il est demandé aux requérants d'envoyer leur demande sur l'adresse des nounous pour garder une trace. +Les nounous peuvent créer de nouvelles listes, sur demande +d'adhérents ou de clubs. Il est demandé aux requérants +d'envoyer leur demande sur l'adresse des nounous +pour garder une trace. -Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent : +Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. +Les propriétaires peuvent : - abonner ou désabonner des adresses mail, -- changer les critères de modération automatique (acceptation/rejet/mise en attente), +- changer les critères de modération automatique, - modérer les messages. -Le rôle des modérateurs est de filtrer les messages mis en attente de distribution (envoi par un non abonné, message trop volumineux, les critères varient). +Le rôle des modérateurs est de filtrer les messages mis +en attente de distribution (envoi par un non abonné, +message trop volumineux, les critères varient). ## Messages automatiques et modération -Lorsqu'un message envoyé à une liste est mis en attente d'être modéré, un email est automatiquement envoyé aux modérateurs de la liste. Cet email automatique admet une forme par défaut (qui vient avec l'installation de Mailman), mais il est possible de modifier le format pour le rendre plus lisible et accessible à des novices, qui ne savent pas nécessairement quoi faire. +Lorsqu'un message envoyé à une liste est mis en attente +d'être modéré, un email est automatiquement envoyé aux +modérateurs de la liste. Cet email automatique admet +une forme par défaut (qui vient avec l'installation de Mailman), +mais il est possible de modifier le format pour le rendre +plus lisible et accessible à des novices, +qui ne savent pas nécessairement quoi faire. -Un événement déclencheur (abonnement, désabonnement, message en modération, bounce score qui augmente, etc) a son propre mail automatique, dont le template peut être modifié. Chacun de ces templates a trois scopes qui sont appliqués avec une priorité décroissante : +Un événement déclencheur (abonnement, désabonnement, +message en modération, bounce score qui augmente, etc) +a son propre mail automatique, dont le template +peut être modifié. Chacun de ces templates a trois +scopes qui sont appliqués avec une priorité décroissante : - liste (ex : nom_de_votre_liste@lists.crans.org) - domaine (ex : lists.crans.org) - site (l'installation courante de Mailman). -De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, puisqu'on ne gère qu'un seul domaine. (Et de toute façon, on a essayé de trouver où poser le template et on a pas trouvé.) +De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, +puisqu'on ne gère qu'un seul domaine. +(Et de toute façon, on a essayé de trouver où poser le template +et on a pas trouvé.) Un template doit -- être nommé en suivant une syntaxe précise (cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html)) +- être nommé en suivant une syntaxe précise +(cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html)) - utiliser les mêmes noms de variables que Mailman, codées en dur, - être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu. -Un template global pour les messages de modération au niveau de Mailman a été placé sur la VM Mailman dans `/var/lib/mailman3/templates/sites/fr` et nommé, comme le veut la convention, `list:admin:action:post.txt`. Ce message est d'une importance particulière, compte tenu du nombre de débutants utilisant le service chaque année. +Un template global pour les messages de modération au +niveau de Mailman a été placé sur la VM Mailman dans +`/var/lib/mailman3/templates/sites/fr` et nommé, +comme le veut la convention, `list:admin:action:post.txt`. +Ce message est particulièrement important, +compte tenu du nombre de débutants utilisant le service chaque année. -Un template de footer pourrait être inclus, dans `list:member:regular:footer.txt` avec un lien permettant de se désabonner. \ No newline at end of file +Un template de footer pourrait être inclus, +dans `list:member:regular:footer.txt` +avec un lien permettant de se désabonner. From 500d295d10562f571b88658f13702167681ef407 Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 14:40:24 +0200 Subject: [PATCH 04/14] Linting, encore --- services/mail/services/listes.md | 77 ++++++++++++++++---------------- 1 file changed, 38 insertions(+), 39 deletions(-) diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index b353373..cd4af45 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -2,88 +2,87 @@ En plus des comptes mails individuels, le Crans propose un service de mailing-lists, listes de diffusion en bon français, accessible -[ici](https://lists.crans.org/postorius/lists/). -Actuellement (juin 2025), -le service est propulsé par Mailman 3 et l'interface d'administration +[ici](https://lists.crans.org/postorius/lists/). +Actuellement (juin 2025), +le service est propulsé par Mailman 3 et l'interface d'administration utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11 ## Filtre anti-bots -Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. -L'identifiant et le mot de passe sont simples pour un humain et donnés +Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. +L'identifiant et le mot de passe sont simples pour un humain et donnés en cas d'échec de connexion. ## Comptes -Mailman dispose de ses propres comptes et il n'est pas nécessaire -de disposer d'un compte Crans pour utiliser le service. -Il est en revanche possible d'utiliser un compte Crans pour +Mailman dispose de ses propres comptes et il n'est pas nécessaire +de disposer d'un compte Crans pour utiliser le service. +Il est en revanche possible d'utiliser un compte Crans pour contrôler un compte Mailman, à travers une OAuth. -Toute personne, même non adhérente au Crans ou extérieure à -l'ENS peut créer un compte sur Mailman. À un compte Mailman, +Toute personne, même non adhérente au Crans ou extérieure à +l'ENS peut créer un compte sur Mailman. À un compte Mailman, on peut associer plusieurs adresses mail, selon ses besoins. -Enfin, pour être simplement abonné à une liste, il n'y a +Enfin, pour être simplement abonné à une liste, il n'y a aucune condition particulière à remplir. ## Droits sur les listes -Les nounous peuvent créer de nouvelles listes, sur demande -d'adhérents ou de clubs. Il est demandé aux requérants -d'envoyer leur demande sur l'adresse des nounous +Les nounous peuvent créer de nouvelles listes, sur demande +d'adhérents ou de clubs. Il est demandé aux requérants +d'envoyer leur demande sur l'adresse des nounous pour garder une trace. -Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. +Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent : - abonner ou désabonner des adresses mail, - changer les critères de modération automatique, - modérer les messages. -Le rôle des modérateurs est de filtrer les messages mis -en attente de distribution (envoi par un non abonné, +Le rôle des modérateurs est de filtrer les messages mis +en attente de distribution (envoi par un non abonné, message trop volumineux, les critères varient). ## Messages automatiques et modération -Lorsqu'un message envoyé à une liste est mis en attente -d'être modéré, un email est automatiquement envoyé aux -modérateurs de la liste. Cet email automatique admet -une forme par défaut (qui vient avec l'installation de Mailman), -mais il est possible de modifier le format pour le rendre -plus lisible et accessible à des novices, +Lorsqu'un message envoyé à une liste est mis en attente +d'être modéré, un email est automatiquement envoyé aux +modérateurs de la liste. Cet email automatique admet +une forme par défaut (qui vient avec l'installation de Mailman), +mais il est possible de modifier le format pour le rendre +plus lisible et accessible à des novices, qui ne savent pas nécessairement quoi faire. -Un événement déclencheur (abonnement, désabonnement, -message en modération, bounce score qui augmente, etc) -a son propre mail automatique, dont le template -peut être modifié. Chacun de ces templates a trois +Un événement déclencheur (abonnement, désabonnement, +message en modération, bounce score qui augmente, etc) +a son propre mail automatique, dont le template +peut être modifié. Chacun de ces templates a trois scopes qui sont appliqués avec une priorité décroissante : - liste (ex : nom_de_votre_liste@lists.crans.org) - domaine (ex : lists.crans.org) - site (l'installation courante de Mailman). -De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, -puisqu'on ne gère qu'un seul domaine. -(Et de toute façon, on a essayé de trouver où poser le template +De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, +puisqu'on ne gère qu'un seul domaine. +(Et de toute façon, on a essayé de trouver où poser le template et on a pas trouvé.) Un template doit -- être nommé en suivant une syntaxe précise -(cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html)) +- être nommé en suivant une syntaxe précise (cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html)) - utiliser les mêmes noms de variables que Mailman, codées en dur, - être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu. -Un template global pour les messages de modération au -niveau de Mailman a été placé sur la VM Mailman dans -`/var/lib/mailman3/templates/sites/fr` et nommé, -comme le veut la convention, `list:admin:action:post.txt`. -Ce message est particulièrement important, +Un template global pour les messages de modération au +niveau de Mailman a été placé sur la VM Mailman dans +`/var/lib/mailman3/templates/sites/fr` et nommé, +comme le veut la convention, `list:admin:action:post.txt`. +Ce message est particulièrement important, compte tenu du nombre de débutants utilisant le service chaque année. -Un template de footer pourrait être inclus, -dans `list:member:regular:footer.txt` +Un template de footer pourrait être inclus +dans `list:member:regular:footer.txt` avec un lien permettant de se désabonner. From 5c630725af1af0e933faa3f3c45f19c60e512d1b Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 14:58:20 +0200 Subject: [PATCH 05/14] Correction OS + footer --- services/mail/services/listes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index cd4af45..95ff8fd 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -5,7 +5,7 @@ de mailing-lists, listes de diffusion en bon français, accessible [ici](https://lists.crans.org/postorius/lists/). Actuellement (juin 2025), le service est propulsé par Mailman 3 et l'interface d'administration -utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11 +utilise, au choix, Postorius ou Hyperkitty. tourne sous Debian. ## Filtre anti-bots @@ -83,6 +83,6 @@ comme le veut la convention, `list:admin:action:post.txt`. Ce message est particulièrement important, compte tenu du nombre de débutants utilisant le service chaque année. -Un template de footer pourrait être inclus -dans `list:member:regular:footer.txt` -avec un lien permettant de se désabonner. +Afin de faciliter la vie des utilisateurs, un template de +footer a été inclus dans `list:member:regular:footer.txt` +indiquant comme se désabonner. From dda871d4ef0fd8ce8dfd3c6ef02f75ad4521f8ed Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 15:00:33 +0200 Subject: [PATCH 06/14] Pas besoin de footer --- services/mail/services/listes.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index 95ff8fd..26c3596 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -82,7 +82,3 @@ niveau de Mailman a été placé sur la VM Mailman dans comme le veut la convention, `list:admin:action:post.txt`. Ce message est particulièrement important, compte tenu du nombre de débutants utilisant le service chaque année. - -Afin de faciliter la vie des utilisateurs, un template de -footer a été inclus dans `list:member:regular:footer.txt` -indiquant comme se désabonner. From 06eae9e96344203d3f450b090330de78b9de06c2 Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 15:02:58 +0200 Subject: [PATCH 07/14] =?UTF-8?q?Je=20sais=20pas=20=C3=A9crire?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- services/mail/services/listes.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index 26c3596..0ae85ac 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -5,7 +5,8 @@ de mailing-lists, listes de diffusion en bon français, accessible [ici](https://lists.crans.org/postorius/lists/). Actuellement (juin 2025), le service est propulsé par Mailman 3 et l'interface d'administration -utilise, au choix, Postorius ou Hyperkitty. tourne sous Debian. +utilise, au choix, Postorius ou Hyperkitty. +La VM sous-jacente tourne sous Debian. ## Filtre anti-bots From ba0868e7abd2e3f443e7c7be69d2316ffb90da4f Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 21:37:28 +0200 Subject: [PATCH 08/14] =?UTF-8?q?Am=C3=A9lioratiens=20bleiziennes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- services/mail/services/listes.md | 73 ++++++++++++++++++++++++++++---- 1 file changed, 65 insertions(+), 8 deletions(-) diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index 0ae85ac..fab8822 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -12,14 +12,17 @@ La VM sous-jacente tourne sous Debian. Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. L'identifiant et le mot de passe sont simples pour un humain et donnés -en cas d'échec de connexion. +en cas d'échec de connexion. On les rappelle ici : + +- Identifiant : Stop +- Mot de passe : Spam ## Comptes Mailman dispose de ses propres comptes et il n'est pas nécessaire de disposer d'un compte Crans pour utiliser le service. Il est en revanche possible d'utiliser un compte Crans pour -contrôler un compte Mailman, à travers une OAuth. +contrôler un compte Mailman, à travers le CAS. Toute personne, même non adhérente au Crans ou extérieure à l'ENS peut créer un compte sur Mailman. À un compte Mailman, @@ -34,19 +37,26 @@ Les nounous peuvent créer de nouvelles listes, sur demande d'adhérents ou de clubs. Il est demandé aux requérants d'envoyer leur demande sur l'adresse des nounous pour garder une trace. +La convention de nommage se trouve +[sur le Wiki](https://wiki.crans.org/CransTechnique/ConventionsUtiles/NomsML). +(Il est nécessaire de se connecter au Wiki pour lire la page.) + +Les nounous peuvent également supprimer ou archiver une mailing-list devenue +obsolète, soit sur demande des intéressés, soit par décision du CT. Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent : -- abonner ou désabonner des adresses mail, -- changer les critères de modération automatique, +- gérer les modérateurs, modératrices et propriétaires, +- gérer les paramètres de la liste (dont ceux de modération automatique), +- abonner ou désabonner des adresses mail (y compris en masse), - modérer les messages. -Le rôle des modérateurs est de filtrer les messages mis -en attente de distribution (envoi par un non abonné, -message trop volumineux, les critères varient). +Le rôle des modérateurs, des modératrices et des propriétaires +est de filtrer les messages mis en attente de distribution +(envoi par un non abonné, message trop volumineux, les critères varient). -## Messages automatiques et modération +## Messages automatiques Lorsqu'un message envoyé à une liste est mis en attente d'être modéré, un email est automatiquement envoyé aux @@ -83,3 +93,50 @@ niveau de Mailman a été placé sur la VM Mailman dans comme le veut la convention, `list:admin:action:post.txt`. Ce message est particulièrement important, compte tenu du nombre de débutants utilisant le service chaque année. + +Pour modifier un template de $liste, il faut placer le fichier dans le dossier +`var/lib/mailman3/templates/lists/$liste` à la place. + +## Archives + +Les messages envoyés à une mailing-list sont archivés directement +sur le serveur et accessibles en lecture depuis l'interface web, +sur la page d'accueil de $liste, +à l'adresse https://lists.crans.org/postorius/lists/$liste.lists.crans.org/. + +## Modération + +Pré-requis : être propriétaire de la liste. + +Pour modifier les règles de modération automatique d'une liste, se rendre sur +sa page d'accueil, puis sur l'onglet `Paramètres`, sous-onglet +`Message Acceptance` +(ou directement sur https://lists.crans.org/postorius/lists/$list.lists.crans.org/settings/message_acceptance). +La plupart des options sont expliquées directement sur la page, mais on en +décrira quelques unes ici. + +### Action par défaut + +Existe en deux versions (abonné et non abonné à la liste). Mettre sur +liste blanche les adresses des abonnés a souvent du sens +(par exemple pour une ML de club). + +### Taille maximale + +Si votre message dépasse la taille fixée, il passera nécessairement en modération, +même si vous êtes sur liste blanche. + +### Accepter ces non-membres + +Permet de mettre sur liste blanche une liste d'adresses (ou de regex d'adresses) +pour éviter de devoir modérer leurs messages. + +### Rejeter ces non-abonnés + +Pratique pour se débarrasser de spammeurs. L'expéditeur reçoit une +notification de rejet. + +### Ignorer ces non-abonnés + +Pareil, mais le message est détruit silencieusement et l'expéditeur n'en sait rien. +Dangereux, à ne pas utiliser si vous craignez de perdre un mail important. From f0133d7388a4069dc9982070c484bba56f41be1e Mon Sep 17 00:00:00 2001 From: glevy Date: Sun, 8 Jun 2025 21:40:12 +0200 Subject: [PATCH 09/14] Linting --- services/mail/services/listes.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/services/mail/services/listes.md b/services/mail/services/listes.md index fab8822..d60d74b 100644 --- a/services/mail/services/listes.md +++ b/services/mail/services/listes.md @@ -37,7 +37,7 @@ Les nounous peuvent créer de nouvelles listes, sur demande d'adhérents ou de clubs. Il est demandé aux requérants d'envoyer leur demande sur l'adresse des nounous pour garder une trace. -La convention de nommage se trouve +La convention de nommage se trouve [sur le Wiki](https://wiki.crans.org/CransTechnique/ConventionsUtiles/NomsML). (Il est nécessaire de se connecter au Wiki pour lire la page.) @@ -99,19 +99,19 @@ Pour modifier un template de $liste, il faut placer le fichier dans le dossier ## Archives -Les messages envoyés à une mailing-list sont archivés directement +Les messages envoyés à une mailing-list sont archivés directement sur le serveur et accessibles en lecture depuis l'interface web, sur la page d'accueil de $liste, -à l'adresse https://lists.crans.org/postorius/lists/$liste.lists.crans.org/. +à l'adresse `https://lists.crans.org/postorius/lists/$liste.lists.crans.org/`. ## Modération Pré-requis : être propriétaire de la liste. Pour modifier les règles de modération automatique d'une liste, se rendre sur -sa page d'accueil, puis sur l'onglet `Paramètres`, sous-onglet -`Message Acceptance` -(ou directement sur https://lists.crans.org/postorius/lists/$list.lists.crans.org/settings/message_acceptance). +sa page d'accueil, puis sur l'onglet `Paramètres`, sous-onglet +`Message Acceptance` +(ou directement sur `https://lists.crans.org/postorius/lists/$list.lists.crans.org/settings/message_acceptance`). La plupart des options sont expliquées directement sur la page, mais on en décrira quelques unes ici. From 0c1e1e7cca5ccde99cb4b7c1aea95508f9bf379c Mon Sep 17 00:00:00 2001 From: glevy Date: Sat, 14 Jun 2025 14:48:04 +0200 Subject: [PATCH 10/14] =?UTF-8?q?V=C3=A9rif=20du=20c=C3=A2blage?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- infrastructure/reseaux/map-port.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index 5d3a19f..6d94811 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -22,7 +22,7 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |15 | | | |16 | rodney | rodney | |17 | ens | | -|18 | | | +|18 | horst | | |19 | aurore | | |20 | vr | | |21 | | | From 937b5f8dd4fc664917cc4b4e30900ee800dc60b3 Mon Sep 17 00:00:00 2001 From: glevy Date: Sat, 14 Jun 2025 14:48:59 +0200 Subject: [PATCH 11/14] =?UTF-8?q?V=C3=A9rif=20du=20c=C3=A2blage?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- infrastructure/reseaux/map-port.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index 6d94811..d2c63ca 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -25,7 +25,7 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |18 | horst | | |19 | aurore | | |20 | vr | | -|21 | | | +|21 | ethernet | | |22 | | | |23 | carapuce | arceus | |24 | carapuce | arceus | From 56a509e0eca17ade375a28c88a1d17dd6cdf7e6f Mon Sep 17 00:00:00 2001 From: glevy Date: Sat, 14 Jun 2025 14:53:55 +0200 Subject: [PATCH 12/14] =?UTF-8?q?V=C3=A9rif=20du=20c=C3=A2blage.=20Cameron?= =?UTF-8?q?=20n'est=20pas=20branch=C3=A9=20sur=20Arceus=20pour=20un=20prob?= =?UTF-8?q?l=C3=A8me=20de=20MAC.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- infrastructure/reseaux/map-port.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index d2c63ca..a533e6c 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -5,14 +5,14 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |port| arceus | carapuce | |----|----------|----------| -|1 | sam | | +|1 | sam | sam | |2 | | | -|3 | daniel | | +|3 | daniel | daniel | |4 | zamok | | -|5 | jack | | +|5 | jack | jack | |6 | | | |7 | | zamok | -|8 | | | +|8 | | cameron | |9 | stitch | stitch | |10 | tealc | tealc | |11 | gulp | gulp | @@ -22,7 +22,7 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |15 | | | |16 | rodney | rodney | |17 | ens | | -|18 | horst | | +|18 | horst | horst | |19 | aurore | | |20 | vr | | |21 | ethernet | | From 45f924b343fba5d1588f4c60b6053a99971ca295 Mon Sep 17 00:00:00 2001 From: glevy Date: Sat, 14 Jun 2025 14:56:49 +0200 Subject: [PATCH 13/14] Renommage de l'ilo --- infrastructure/reseaux/map-port.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index a533e6c..bf217fc 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -25,7 +25,7 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |18 | horst | horst | |19 | aurore | | |20 | vr | | -|21 | ethernet | | +|21 | ilos | | |22 | | | |23 | carapuce | arceus | |24 | carapuce | arceus | From 54f244d0c4aaf09537d2b24becc871701e4ede9e Mon Sep 17 00:00:00 2001 From: glevy Date: Sat, 14 Jun 2025 15:07:27 +0200 Subject: [PATCH 14/14] Renommage --- infrastructure/reseaux/map-port.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/infrastructure/reseaux/map-port.md b/infrastructure/reseaux/map-port.md index bf217fc..00ebd7d 100644 --- a/infrastructure/reseaux/map-port.md +++ b/infrastructure/reseaux/map-port.md @@ -25,7 +25,7 @@ Le tableau ci-dessus corresponds au mapping actuelle des ports des switch |18 | horst | horst | |19 | aurore | | |20 | vr | | -|21 | ilos | | +|21 | ilos+thot| | |22 | | | |23 | carapuce | arceus | |24 | carapuce | arceus |