Chapril DokuWiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Création d'une liste ======

Pour créer une liste il faut utiliser l'interface WWSympa https://listes.chapril.org/sympa/create_list_request

Pour une liste de type support, il faut choisir le template « Template pour une liste de type support » qui contient notamment des éléments de configuration en lien avec la gestion des adresses en erreur. Voir le ticket https://agir.april.org/issues/5692 pour plus d'information.

Il faut choisir un Objet pour la liste.

L'interface demande aussi de choisir un « Public visé », ce qui est inutile dans notre cas. Choisir « Autre » (tout en cas de la liste).

Ajouter une courte description.

Puis cliquer sur « Envoyer votre demande de création ».

La liste est créée. Il faut ensuite ajouter les adresses courriels des personnes qui recevront les courriels de support (dans l'onglet « Les utilisateurs -> Abonnés ». Mettre aussi ces adresses en Propriétaires de la liste, dans l'onglet « Les utilisateurs -> Propriétaires », en pensant à cocher la case « Gestionnaire privilégié ».

Puis envoyer un courriel de test avec une adresse non inscrite à la liste, pour vérifier la bonne diffusion du message.

Pour la création du template « Template pour une liste de type support », création du répertoire /etc/sympa/create_list_templates/liste-support/ puis copie des fichiers /usr/share/doc/sympa/examples/samples/intranet/create_list_templates/intranet_list/comment.tt2 et /usr/share/doc/sympa/examples/samples/intranet/create_list_templates/intranet_list/config.tt2 puis modification des fichiers.

====== Modification d'un message envoyé par Sympa ======

Il y a un mauvais message affiché lorsqu'une personne tente de s'inscrire à une liste qui demande une confirmation d'inscription par courriel (que ce soit via l'interface web ou par courriel). Celaa induit en erreur la personne qui du coup ne validera peut-être pas l'inscription.

La personne reçoit deux courriel. Un courriel de Sympa pour valider son inscription mais elle reçoit un 2e courriel indiquant //La demande a été soumise au gestionnaire de la liste//.

Le ticket https://agir.april.org/issues/5736

C'est exactement le même souci qu'avec le Sympa de l'April, voir https://agir.april.org/issues/5736

On applique la même résolution que pour le Sympa de l'April :

  apt install gettext
  mkdir /root/sympa-ticket-5736
  cd /root/sympa-ticket-5736
  dpkg -s sympa |grep Version
  wget http://deb.debian.org/debian/pool/main/s/sympa/sympa_6.2.60~dfsg.orig.tar.xz
  tar Jxvf sympa_6.2.60~dfsg.orig.tar.xz
  cd sympa-6.2.60/po/sympa/
  msgfmt -c -o fr.mo -v fr.po
  -> 2810 messages traduits, 1 traduction approximative, 1 message non traduit.
  Diff avec le fichier qui est livré avec le paquet Debian :
  diff -u /usr/share/locale/fr/LC_MESSAGES/sympa.mo fr.mo
  fichier identique (parfait)

On peut donc modifier le fichier fr.po pour remplacer la chaîne et avoir un nouveau fichier MO :

  cp fr.po fr.po.orig
  vi fr.po
  diff -u fr.po.orig fr.po
  -msgstr "La demande a été soumise au gestionnaire de la liste (%1)" 
  +msgstr "Votre requête à été transmise à l'adresse (%1) pour une demande de confirmation. Le message envoyé contenant un lien de validation." 
  msgfmt -c -o fr.mo -v fr.po

On met en prod :

  cd /usr/share/locale/fr/LC_MESSAGES/
  cp sympa.mo sympa.mo.dpkg
  cp ~/sympa-ticket-5736/sympa-6.2.40/po/sympa/fr.mo sympa.mo
  systemctl restart sympa
  systemctl restart wwsympa
  
====== Interconnexion entre sympa et postfix ======

Pour rappel on a une architecture avec un relais mail qui gère tout ce qui entre/sort du cluster au niveau du mail. Le sympa est installé sur une machine séparée. Pour éviter la confusion on nommera //guest// la machine hébergeant le sympa et on nommera //relais// la machine hébergeant le postfix frontal.

<note important>On est ici dans une documentation a posteriori d'un truc un peu touchy, donc il est possible que des erreurs subsistent.</note>
===== Postfix coté relais =====

Pour que le relais transmette les emails au bon guest, il faut installer les bons transports.
<code conf /etc/postfix/conf.d/40-sympa.conf>
transport_maps = hash:/etc/postfix/transports/sympa, hash:/etc/postfix/transports/slow_domains, hash:/etc/postfix/transports/sympa-static
</code>

Par ailleurs il faut que le relais reconnaisse les transports comme des destinataires valides. Nous avons donc
<code conf /etc/postfix/conf.d/42-recipients.conf >
local_recipient_maps = proxy:unix:passwd.byname $alias_maps $transport_maps
</code>

Examinons les définitions des transports :
  - ''slow_domains'' : pour limiter le débit de soumission des courrier à des domaine pauvres comme laposte.net qui n'ont pas les moyens d'encaisser plus de 1 courriel à la fois. Ce n'est pas à proprement parler essentiel à sympa, mais de fait le besoin s'en fait largement sentir lorsqu'un sympa est installé.<code conf /etc/postfix/transports/slow_domains.map >
aliceadsl.fr slow:
free.fr slow:
hotmail.com slow:
hotmail.fr slow:
infonie.fr slow:
laposte.net slow:
libertysurf.fr slow:
live.com slow:
live.fr slow:
orange.com slow:
orange.fr slow:
wanadoo.com slow:
wanadoo.fr slow:
yahoo.com slow:
yahoo.fr slow:
</code>
  - ''sympa-static'' : les adresses de services pour le sympa.<code conf /etc/postfix/transports/sympa-static.map >
sympa@chapril.org            smtp:[sympa.cluster.chapril.org]
sympa-request@chapril.org    smtp:[sympa.cluster.chapril.org]
sympa-owner@chapril.org      smtp:[sympa.cluster.chapril.org]
</code>
  - ''sympa'' : c'est là que les sont les transports spécifiques aux listes. On verra plus tard sa fabrication.<code conf /etc/postfix/transports/sympa.map>
## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)
## À copier dans mail.cluster.chapril.org:/etc/postfix/transports/
## List aliases used for the sympa mailing-list manager
test@chapril.org                                                        smtp:[sympa.cluster.chapril.org]
test-request@chapril.org                                                smtp:[sympa.cluster.chapril.org]
test-editor@chapril.org                                                 smtp:[sympa.cluster.chapril.org]
test-unsubscribe@chapril.org                                            smtp:[sympa.cluster.chapril.org]
test-owner@chapril.org                                                  smtp:[sympa.cluster.chapril.org]
</code>

===== Postfix coté guest =====

C'est plus direct car basiquement on applique moins de contrôle. Une conf postfix satellite avec chapril.org en mailname et mail.cluster.chapril.org en relais suffit plus quelques adaptations. Cf [[admin:procedures:installation_postfix_satellite|Installation d'un postfix en satellite]].

Les adaptations :
<code conf /etc/postfix/main.cf>
# On sert localement le domaine chapril.org
mydestination = $myhostname, sympa.cluster.chapril.org, localhost.cluster.chapril.org, localhost, chapril.org

# D'ailleurs on a plein d'utilisateurs locaux @chapril.org, regardez
alias_maps =     hash:/etc/aliases hash:/etc/aliases.local
alias_database = $alias_maps

# Mais en cas de doute on renvoit au relais
fallback_transport = smtp:[mail.cluster.chapril.org]

# On accepte de recevoir du mail depuis le relais
mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128 192.168.1.57
inet_interfaces = all

# Reglages Sympa 
virtual_alias_maps = hash:/etc/mail/sympa/sympa-transports.map
transport_maps = regexp:/etc/postfix/sympa-transports.regex

sympaqueue_destination_recipient_limit = 1
sympabouncequeue_destination_recipient_limit = 1
</code>

<note important>
On passe par des transports vers de nouveaux services et non par des alias car ça nous permet de contrôler l'uid du service dans ''master.cf''. Cf https://agir.april.org/issues/3149
</note>

<code conf /etc/postfix/sympa-transports.regex>
/^.*\@sympaqueue$/         sympaqueue:
/^.*\@sympabouncequeue$/   sympabouncequeue:
</code>

<code conf /etc/postfix/master.cf>
# Sympa mailing list manager transports
sympaqueue       unix  -       n       n       -       -       pipe
  flags=RF user=sympa argv=/usr/lib/sympa/bin/queue ${user}@${extension}
sympabouncequeue unix  -       n       n       -       -       pipe
  flags=RF user=sympa argv=/usr/lib/sympa/bin/bouncequeue ${user}@${extension}
</code>


<code conf /etc/aliases.local>
# default contact emails
postmaster:     listmaster@chapril.org
sympa-owner:    listmaster@chapril.org
sympa-request:  listmaster@chapril.org
</code>

Enfin, notre fichier de transports est ainsi fait (on voit sa construction juste après) :

<code conf /etc/mail/sympa/sympa-transports.map>
## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)
## Destiné à sympa.cluster.chapril.org:/etc/postfix/transports/

sympa@chapril.org sympa+chapril.org@sympaqueue.

## List aliases used for the sympa mailing-list manager
test@chapril.org test+chapril.org@sympaqueue.
test-request@chapril.org test-request+chapril.org@sympaqueue.
test-editor@chapril.org test-editor+chapril.org@sympaqueue.
#test-subscribe@chapril.org test-subscribe+chapril.org@sympaqueue.
test-unsubscribe@chapril.org test-unsubscribe+chapril.org@sympaqueue.
test-owner@chapril.org test+chapril.org@sympabouncequeue.
</code>
====== Construction du fichier d'aliases sur le guest ======

En fait sympa fait ça tout seul comme un grand si on lui demande.
<code conf /etc/sympa/sympa/sympa.conf>
sendmail_aliases /etc/mail/sympa/aliases
alias_manager    /usr/lib/sympa/bin/alias_manager.pl
</code>

Il est poli et exécute newaliases quand il a fini.

<note tip>Si d'aventure le format de ce qui est généré ne vous satisfait pas, le template à modifier c'est ''/usr/share/sympa/default/list_aliases.tt2''

Ce fichier par défaut a les alias de type nomdelaliste-subscribe@ en commentaires. Or ce type d'alias est utile. Donc, copie du fichier ''/usr/share/sympa/default/list_aliases.tt2'' dans ''/etc/sympa/list_aliases.tt2''. Modifier du fichier pour avoir les alias subscribe. La régénération du fichier /etc/mail/sympa/aliases est faite à chaque création de nouvelle liste. Mais pour les listes déjà existantes les entrées dans le fichier ne sont pas modifiées. Il faut donc modifier manuellement ce fichier.
</note>

Maintenant il faut pousser cette conf proprement sur le relais.

====== Création et installation du fichier d'aliases sur le relais ======

<note tip>
On va se faire aider de ''systemd'' à l'aide d'une unit de type ''path''. Cf https://www.redhat.com/sysadmin/introduction-path-units
</note>

===== Sur la machine guest =====

On va installer le programme suivant :
<code bash cat /usr/local/bin/alias_push.sh >
#!/bin/bash
echo '## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)' > /etc/mail/sympa/sympa.map
echo '## À copier dans mail.cluster.chapril.org:/etc/postfix/transports/' >> /etc/mail/sympa/sympa.map
awk -F ':' '$1 !~ "#" && $1 !~ "^ *$" {print $1 "@chapril.org\t smtp:[sympa.cluster.chapril.org]"} $1 ~ "#[-#]"{ print $0}' /etc/mail/sympa/aliases | column -t -s $'\t' >> /etc/mail/sympa/sympa.map

echo '## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)' > /etc/mail/sympa/sympa-transports.map
echo '## Destiné à sympa.cluster.chapril.org:/etc/postfix/transports/' >> /etc/mail/sympa/sympa-transports.map

echo 'sympa@chapril.org sympa+chapril.org@sympaqueue.' >> /etc/mail/sympa/sympa-transports.map
sed -e 's/:/@chapril.org/' -e 's!"| /usr/lib/sympa/bin/\([^ ]\+\) \([^ @]\+\)@\([^" ]\+\)"!\2+\3@sympa\1.!' /etc/mail/sympa/aliases >> /etc/mail/sympa/sympa-transports.map

postmap /etc/mail/sympa/sympa-transports.map

scp /etc/mail/sympa/sympa.map mail.cluster.chapril.org:/etc/postfix/transports/sympa.map

export GIT_AUTHOR_EMAIL=sympa@chapril.org
export GIT_AUTHOR_NAME=Sympa

git -C /etc add /etc/mail/sympa/
git -C /etc commit -m 'MaJ des alias des listes'</code>
ainsi que les units systemd suivantes :
<code ini /etc/systemd/system/sympa-transports.path >
[Unit]
Description=Wait for new sympa transports

[Path]
PathChanged=/etc/mail/sympa/aliases
Unit=sympa-transports.service

[Install]
WantedBy=multi-user.target
</code>

<code ini /etc/systemd/system/sympa-transports.service >
[Unit]
Description=Push sympa transports toward postfix

[Service]
Type=simple
ExecStart=/usr/local/bin/alias_push.sh

[Install]
WantedBy=multi-user.target
</code>

qu'on va penser à activer :
  systemctl enable sympa-transports.path sympa-transports.service
  systemctl start sympa-transports.path sympa-transports.service
===== Sur la machine relais =====

On va installer le programme suivant :
<code bash cat /usr/local/bin/alias_update.sh >
#!/bin/bash
cd /etc/postfix && make && postfix reload

export GIT_AUTHOR_EMAIL=sympa@chapril.org
export GIT_AUTHOR_NAME=Sympa

git add transports/sympa.map transports/sympa.db
git commit -m 'MaJ des alias des listes'
</code>
ainsi que les units systemd suivantes :
<code ini /etc/systemd/system/sympa-transports.path >
[Unit]
Description=Wait for new sympa transports

[Path]
PathChanged=/etc/postfix/transports/sympa.map
Unit=sympa-transports.service

[Install]
WantedBy=multi-user.target
</code>

<code ini /etc/systemd/system/sympa-transports.service >
[Unit]
Description=Push sympa transports toward postfix

[Service]
Type=simple
ExecStart=/usr/local/bin/alias_update.sh

[Install]
WantedBy=multi-user.target
</code>

qu'on va penser à activer :
  systemctl enable sympa-transports.path sympa-transports.service
  systemctl start sympa-transports.path sympa-transports.service