Mini Howto Mail vers News Robert Hart, InterWeft IT Consultants Melbourne, Australie, iweft@ipax.com.au Traduit par Olivier Tharan, tharan@int-evry.fr v1.0, 4 novembre 1996 _________________________________________________________________ _Ce document décrit comment configurer votre logiciel de News et mail2news.pl pour relier des listes de distribution aux groupes de news locaux. _ _________________________________________________________________ 1. Copyright et autres choses Le copyright de ce document est retenu par l'auteur. Il donne la permission de distribuer ce document par des moyens électroniques et sur des CDs, à condition qu'il soit gardé entièrement dans son format d'origine. Il donne aussi la permission d'imprimer une copie de ce document pour usage personnel. La publication de ce document en partie ou en entier sans la permission du propriétaire du copyright de toute manière autre qu'indiquée ci-dessus est interdite. Ce document est directement supporté par InterWeft IT Consultants (Melbourne, Australie). La dernière version de ce document est disponible sur le site WWW d'InterWeft chez InterWeft IT Consultants, http://203.29.72.65/. 2. Introduction La plupart des sites sur Internet sont toujours en train de chercher des moyens d'améliorer l'utilisation de la bande passante limitée dont ils disposent sur leur lien à Internet. Supposons que plus d'un utilisateur s'abonne à la même liste de distribution, et il y aura duplication de trafic. S'il y a un certain nombre de telles duplications, ou si le trafic sur les listes est important, la consommation de bande passante s'accroît. En abonnant le site à une liste (si c'est permis par le propriétaire de la liste), et en _routant_ le courrier électronique vers le serveur de news local, il est possible de rendre les listes de distribution accessibles à tous les utilisateurs du site ou, en utilisant les principes de sécurité d'innd, de limiter l'accès à certains utilisateurs. Un tel abonnement de groupe (surtout s'il y a quelques listes à grand trafic) peut générer des économies d'utilisation de bande passante importantes. La lecture des listes à travers un lecteur de news offre aussi aux utilisateurs l'avantage du threading (NdT : créer des enfilades), qui n'est pas disponible dans de nombreux programmes de mail, et aussi l'avantage de libérer leur boîte aux lettres pour du courrier peut-être plus urgent ou plus personnel. Ce mini Howto décrit la mise en place du script mail2news.pl pour réaliser ceci. 2.1 Où trouver mail2news.pl L'auteur n'a pas pu trouver mail2news.pl sur le CPAN (le réseau complet d'archives Perl), mais il a pu passer devant sans le voir. Il est cependant sur sunsite.unc.edu (quelque part) et aussi sur ftp.redhat.com. Comme ce script Perl n'est pas très long, vous le trouverez à la fin de ce Howto. 3. Vue d'ensemble du système Il est probablement plus facile de comprendre le fonctionnement de ce système en suivant un message à partir de la liste de distribution vers le groupe de news, puis d'un message posté sur le groupe de news local (routé vers la liste de distribution) et en regardant comment ils sont traités. 3.1 Le courrier venant de la liste de distribution Le courrier de la liste de distribution est envoyé à toutes les adresses mail abonnées. Un alias de mail spécial est abonné à la liste de distribution en question et tout le trafic à destination et en provenance de la liste est ainsi envoyé par le serveur de liste à cette adresse. Quand le courrier de la liste de distribution arrive sur la machine locale, l'alias de mail envoie le message entrant dans mail2news.pl. L'alias de mail spécifie aussi le groupe de news (local) de destination. Le script mail2news.pl traite le message, en appliquant de nouvelles en-têtes et utilise ensuite rnews ou inews pour poster le message dans le groupe de news. 3.2 Messages postés dans le groupe de news local Le groupe de news local est installé en tant que groupe modéré, puisque ceci nous permet de bénéficier des possibilités de courrier électronique d'innd. Tout message posté dans un groupe modéré n'est pas transmis automatiquement au groupe. À la place, les messages sont envoyés par _email_ au modérateur du groupe. En déclarant le modérateur du groupe de news local comme étant l'adresse de la liste de distribution, tous les messages postés sur le groupe de news local seront envoyés par _email_ à la liste de distribution par innd et n'apparaîtront qu'une fois qu'ils auront été reçus par mail2news.pl qui ajoute la ligne _approved_ nécessaire aux messages pour qu'innd accepte de les poster dans le groupe de news. 4. Configurer mail2news Placez le script mail2news.pl dans un endroit convenable. Je préfère /usr/local/scripts, mais l'endroit dépend de vous. Vous devrez éditer le script comme suit : * au début du script, assurez-vous que vous pointez vers le binaire Perl local _____________________________________________________________ #!/usr/bin/perl # pointe vers l'endroit courant de Perl _____________________________________________________________ * j'ai eu des problèmes avec les trois lignes suivantes. Les mettre en commentaire ne pose pas de problèmes. _____________________________________________________________ ( $version ) = $] =~ /(\d+\.\d+).*\nPatch level/; die "$program: demande au moins la version 3 de Perl\n" if $version < 3; _____________________________________________________________ * éditez les lignes suivantes pour pointer vers le programme qui poste (j'utilise rnews) et vers votre machine de news : _____________________________________________________________ # $inews = "/usr/bin/inews"; # $iopts = "-h -o \"passerelle mail2news\""; $inews = "/usr/bin/rnews"; $iopts = ""; $postinghost = "votre.serveur.de.news"; # pointe vers votre serveur de news _____________________________________________________________ * assurez-vous que le script est exécutable (mode 755). 5. Mettre en place les alias de mail Éditez /etc/aliases pour créer des entrées pour les listes de distribution que vous voulez envoyer vers les news. Chaque entrée doit être de la forme : : \ "| /usr/local/scripts/mail2news.pl " Si par exemple l'adresse de mail à laquelle il faut envoyer le courrier de la liste (l'adresse _email_ abonnée) est liste_site et le groupe de news local dans lequel il faut poster le courrier s'appelle groupe.site.local, l'alias sera # adresse d'abonnement de groupe pour machin@une.certaine.liste liste_site: "|/usr/local/scripts/mail2news.pl groupe.site.local" Créez une entrée pour chaque liste de distribution que vous devez router vers votre serveur de news local et lancez ensuite newaliases. 6. Configurer les groupes de news et le serveur de news (innd) En utilisant ctlinnd, créez les groupes de news sur votre serveur de news. Rappelez-vous qu'ils doivent être locaux, donc nommez-les de façon distincte avec un préfixe de façon à les exclure de votre distribution de news (dans le fichier newsfeeds). Vous devez aussi dire à innd que le groupe est modéré (en utilisant ctlinnd). Rappelez-vous que innd est très sensible aux propriétaires et permissions de fichiers, vous devez agir à ce niveau avec innd en tant qu'utilisateur _news_. Vous indiquez un groupe modéré en donnant le paramètre m à la commande newgroup. ctlinnd newgroup m Le m indique à innd que le groupe est modéré. Éditez votre fichier newsfeeds pour vous assurer que ces groupes locaux ne sont pas distribués (sauf si vous voulez spécifiquement que ça se passe ainsi). Par exemple, si votre liste de distribution s'appelle groupe.site.local, vous ajouterez sans doute !local* dans le second champ des sites que vous distribuez (ou dont vous recevez les news) dans votre fichier newsfeeds. Maintenant, de façon à vous assurer que les messages des utilisateurs sont envoyés sur la liste automatiquement par innd, éditez /etc/news/moderators (ou /usr/local/news/moderators) pour ajouter une ligne qui déclare l'adresse de la liste de distribution comme modérateur. groupe.site.local:liste@un.site.de.liste 7. Abonner l'alias mail2news à la liste de distribution Vous devez maintenant abonner l'alias de mail à la liste de distribution. Vérifiez avec l'information de la liste de distribution comment s'abonner. Certaines listes de distribution vous permettent d'abonner une adresse _email_ différente de celle d'où vient l'abonnement (elles vérifient la confirmation avec l'adresse à abonner avant d'abonner réellement cette adresse). D'autres listes de distribution ne permettent pas ceci. Vous devrez donc _forger_ une demande d'abonnement. Il y a plusieurs façons de faire ceci. L'une des plus simples est d'utiliser Netscape Mail configuré (de manière temporaire) avec l'adresse avec laquelle la liste de distribution doit envoyer le courrier. Après l'abonnement, vous devriez voir un message de bienvenue de la part du serveur de listes dans votre serveur de news. Dans ce cas, tout s'est bien passé et vous pouvez maintenant tester l'autre sens en postant un message de news dans votre nouvelle liste. Le message _ne devrait pas_ apparaître immédiatement dans le groupe de news. Il devrait être envoyé par courrier électronique et reçu à nouveau et posté dans le groupe de news. Si cela fonctionne, vous avez réussi à router la liste vers les news. 8. Si ça ne fonctionne pas... Si ça ne marche pas, vous devez retrouver la trace des messages pour voir exactement où ça s'arrête de fonctionner. Des outils utiles à ce niveau sont les logs de mail et de news. Robert Hart Melbourne, Victoria, Australie, octobre 1996 9. Le script mail2news.pl _________________________________________________________________ #!/usr/bin/perl ($program = $0) =~ s%.*/%%; #( $version ) = $] =~ /(\d+\.\d+).*\nPatch level/; #die "$program: demande au moins la version 3 de Perl\n" # if $version < 3; # $inews = "/usr/bin/inews"; # $iopts = "-h -o \"passerelle mail2news\""; $inews = "/usr/bin/rnews"; $iopts = ""; $postinghost = "votre.serveur.de.news"; if ($#ARGV < 0) { # $newsgroup = "test"; # nous attendons la ligne newsgroup dans le corps } elsif ($#ARGV == 0) { $newsgroup = $ARGV[0]; } else { die "usage: $program [groupe de news]\n"; } # si jamais inews fait un core dump ou quelque chose insense $SIG{'PIPE'} = "plumber"; sub plumber { die "$program: \"$inews\" est mort trop tot !\n"; } open (INEWS, "| $inews $iopts") || die "$program: ne peut pas lancer $inews\n"; # boucle qui prend les en-tetes while () { last if /^$/; # transforme la vraie ligne from: dans le vieux style s/^From:\s+(.*) <(.*)>/From: $2 ($1)/; s/Message-Id/Message-ID/; # transforme la ligne from_ en en-tete de chemin ; # fonctionne aussi en local s/^From\s+(\S+)@(\S+).*/Path: $2!$1/ || s/^From\s+(\S+)[^@]*$/Path: $1\n/; print INEWS # if /^(Date|From|Subject|Path|Newsgroups|Organization|Message-ID):/i; if /^(Date|From|Subject|Path|Newsgroups|Message-ID):/i; $saw_subject |= ( $+ eq 'Subject' ); $saw_msgid |= ( $+ eq 'Message-ID' ); # $saw_newsgroup |= ( $+ eq 'Newsgroups' ); } warn "$program: n'attendait pas le groupe dans les en-tetes et les arguments\n" if $newsgroup && $saw_newsgroup; die "$program: n'a pas obtenu le groupe des en-tetes ni des arguments\n" unless $newsgroup || $saw_newsgroup; $approved = $newsgroup; $approved =~ s/\./'-'/eg; ($sec,$min,$hour,$mday,$mon,$year)=localtime(time); $madeupid = "\<$year$mon$mday.$hour$min$sec.$$\@kepler.hedland.edu.au\>"; printf INEWS "Newsgroups: %s\n", $newsgroup if $newsgroup; printf INEWS "Approved: %s\@kepler.hedland.edu.au\n", $approved; print INEWS "Subject: Untitled\n" unless $saw_subject; printf INEWS "Message-ID: %s\n", $madeupid unless $saw_msgid; printf INEWS "NNTP-Posting-Host: %s\n", $postinghost; print INEWS "Organisation: (mail2news gateway)\n"; print INEWS "\n"; print INEWS while ; # avale le reste du message close INEWS; exit $?; _________________________________________________________________