Modapp : Script Perl permettant de poster des articles dans un groupe modr

1. Prsentation

2. Installation

3. Lancement
3.1. Dtail des options

4. Configuration et utilisation
4.1. Le fichier de configuration
4.1.1. Dclarations globales
4.1.2. Dclarations de groupes modrs
4.1.3. Dclaration cancel
4.2. Utilisation du programme
4.2.1. Tester la configuration
4.2.2. Invocation standard
4.2.3. Vrification du champ newsgroups
4.2.4. Option -n : ne pas envoyer l'article
4.2.5. Option -p : champ Path simple
4.2.6. Option -i : Message-ID
4.2.7. Champs References et Supersedes
4.2.8. Champ Expires
4.2.9. Archivage des articles
4.2.10. Option -v : afficher la version du programme
4.2.11. Option -h : afficher le message d'aide
4.3. La fonction d'annulation d'un article
4.4. Fonctionnement de modapp en mode silencieux
4.5. Signer les articles avec PGP
4.5.1. Pourquoi signer un article avec PGP ?
4.5.2. Aspects lgaux
4.5.3. Deux logiciels pour signer les articles de news avec PGP
4.5.4. Avant d'utiliser les fonctions PGP de modapp
4.5.5. Cas d'une quipe de modration utilisant l'authentification PGP
4.5.6. Configuration de modapp pour PGP

5. Rfrences

------------------------------

1. PRESENTATION

Modapp est un script en Perl crit pour aider les modrateurs 
publier des articles dans les groupes dont ils sont responsables.

Modapp peut tre utilis par un modrateur s'occupant de plusieurs groupes.

Modapp utilise un fichier de configuration .modapprc situ
par dfaut dans le rpertoire de connexion (home directory) du modrateur.

Quand quelqu'un poste un article dans un groupe modr, le logiciel
serveur de news utilis par le posteur fait suivre par e-mail
l'article au modrateur du groupe. Modapp permet au modrateur
de poster effectivement l'article dans son groupe, en utilisant
le champ d'en-tte Newsgroups:. Si aucun champ Newsgroups: n'existe
dans l'article (ce qui est le cas si l'article est envoy directement
par e-mail au modrateur sans passer par un serveur de news), et si
modapp est configur pour pouvoir poster dans plusieurs groupes modrs,
le script demande au modrateur dans quel groupe l'article doit tre
post.

Dans le cas d'un article  poster dans plusieurs groupes modrs,
le script peut faire suivre l'article au modrateur suivant afin
qu'il soit approuv par les modrateurs de tous les groupes concerns.

Le script dtecte les groupes inconnus sur le serveur du modrateur.

Modapp possde de nombreuses options utilisables en ligne
de commande. La liste complte des options est donne dans le synoptique
ci-dessous, et est dcrite plus longuement dans le paragraphe 
dcrivant l'utilisation du programme.

Il est notamment capable de gnrer les en-ttes suivants :
Path, Followup-To, Expires, Supersedes, References, Message-ID.

et bien sr Approved, Sender.

Il garde les en-ttes (ventuellement multi-lignes) suivants :
From, Reply-To, Summary, Keywords, References, Supersedes,
MIME-Version, Content-Type, Content-Transfer-Encoding.

Modapp ne fait pas lui-mme de conversion MIME Quoted-Printable
ou MIME BASE64 en 8bit propre. Il laisse cela au programme 
d'acheminement ou de dlivrance du courrier (sendmail par exemple,
avec le flag 9 sur la dclaration d'un mailer).

Modapp utilise la commande rnews pour poster effectivement 
l'article dans les news, ou le module News::NNTPClient ou Net::NNTP si
l'un des deux est install. Il utilise la commande sendmail pour
faire suivre un article au modrateur suivant (cas d'un article
crosspost dans plusieurs groupes modrs), ou bien Net::SMTP si
ce module Perl est install.

Modapp intgre une fonction d'annulation d'article Usenet. Cette
fonction n'est pas incluse dans la distribution publique. Pour pouvoir
utiliser la fonction "cancel", il faut que vous envoyiez un e-mail 
l'adresse sn@penelope.frmug.org avec comme sujet : "get modcancel"
et je vous enverrai en retour le patch ajoutant cette fonction.

Modapp est capable de signer les articles modrs avec le programme
PGP. Il utilise la mthode base sur le programme pgpverify disponible
avec les sources du logiciel InterNet News (INN) v1.5 et suivants. 
Pgpverify est galement disponible dans l'archive pgpcontrol disponible 
 l'adresse suivante : <URL:ftp://ftp.eerie.fr/pub/usenet/pgpcontrol/>

------------------------------

2. INSTALLATION

1. Vrifier l'endroit o est situ perl sur votre systme. S'il
n'est pas dans /usr/bin/perl, vous devez modifier la premire ligne
du script.

2. Copier le script dans un rpertoire contenu dans votre variable
PATH (/usr/local/bin par exemple). Vrifier que le script est
bien excutable (s'il ne l'est pas, vous pouvez taper la commande
"chmod 755 modapp" ).

3. Faire un lien symbolique entre modapp et cancel. Vous pouvez
taper la commande suivante pour cela :

ln -s modapp cancel

Si vous installez modapp dans un rpertoire systme (/usr/local/bin
par exemple), vous devez lancer cette commande en tant que root.

4. Changer la variable $modapprc au dbut du script, afin
de prciser l'endroit du fichier de configuration .modapprc.
Cela n'est ncessaire que si vous ne voulez pas que le fichier
soit dans votre repertoire de login.

5. Creer un fichier .modapprc. Un fichier modapp.rc est donn
en exemple.

6. Creer un rpertoire contenant les archives des articles. cela
est ncessaire si vous voulez utiliser les fonctions
de gnration d'en-ttes References: et Supersedes:.

L'endroit o est situ ce rpertoire d'archives est prcis
par la variable archdir du fichier de configuration.

------------------------------

3. LANCEMENT

Pour lancer modapp, il suffit de l'invoquer directement de votre
logiciel de lecture de courrier (par une commande "pipe to command" ou
quivalent) :

| modapp [-options]

Vous pouvez galement sauvegarder l'article dans un rpertoire
temporaire et lancer modapp  partir du shell unix :

$ modapp [-options] /tmp/article2351

Il est possible d'approuver plusieurs articles en mme temps
en appelant une seule fois modapp. Pour cela, il suffit d'indiquer
sur la ligne de commande le chemin d'accs aux fichiers contenant
les articles :

$ modapp [-options] article1 article2 article3 ...

On peut mme lancer modapp sur un fichier mailbox contenant les
articles spars par une ligne "From " (sparateur standard de mailbox
Un*x) :

$ modapp [-options] ~/Mail/in.fr-sem

Dans ces deux derniers cas, modapp se lance plusieurs fois de faon
conscutive, en vrifiant les en-ttes de chaque message et en
lanant ventuellement l'diteur sur chaque message  poster.

------------------------------

3.1. DTAIL DES OPTIONS

modapp [-a] [-c] [-e nombre] [-f filename] [-g newsgroup] [-k]
       [-m] [-n] [-p] [-q] [-r] [-r] [-t] [-v]

-a : Archive l'article dans le rpertoire archdir

-c : Annule l'article donn en entre standard. -c est implicite si 
modapp est lanc en tant que "cancel".

-e nombre : nombre de jours fixant la date d'expiration de l'article.
Si le nombre vaut 0, aucun en-tete Expires: n'est insr dans l'article.

-f filename : chemin d'acces au fichier de configuration modapprc

-g newsgroup : nom du groupe modr  utiliser si aucun n'est indiqu dans
l'article

-k : verifie que l'en-tte Newsgroups: ne contient pas de forums inconnus
ou modrs. Si un groupe modr est trouv, modapp peut faire suivre
l'article par e-mail au modrateur suivant.

-h : message d'aide donnant la liste des options (en anglais)

-m : en mode silencieux, dans le cas d'un article  crossposter dans
plusieurs groupes modrs, fait suivre l'article au modrateur suivant
au lieu de le poster dans son groupe. Il est possible de prciser aprs
cette option le nom du groupe  qui on doit faire suivre l'article. 

-n : ne poste pas l'article dans les news (ou bien, dans le cas o le
modrateur veut faire suivre l'article  un autre modrateur, n'envoie
pas l'article par mail)

-p : utilise un champ simpe Path: not-for-mail

-q : mode silencieux. Modapp ne lance pas l'editeur de texte, et 
n'affiche rien  l'cran (sauf les messages d'erreur ventuels).

-r : insre un champ References: dans l'article. Le message-id de l'article
rfrenc est lu d'un fichier $archdir/archname.msgid.

-s : insre un champ Supersedes: dans l'article. Le message-id
de l'article remplac est lu d'un fichier $archdir/archname.msgid.

-t : teste la configuration de modapp (en affichant la valeur des
paramtres lus du fichier de configuration).

-v : affiche la version de modapp

------------------------------

4. FONCTIONNALITES ET CONFIGURATION

Dans une utilisation standard, vous recevez par mail les articles 
 modrer. Vous invoquez sur chaque article reu la commande
modapp  l'intrieur de votre logiciel de messagerie lectronique.
De cette faon, modrate ajoute un en-tte Approved: configur
dans le fichier .modapprc et poste l'article dans les news.

------------------------------

4.1. LE FICHIER DE CONFIGURATION

Modapp utilise un fichier de configuration appel .modapprc,
situ dans votre rpertoire de login. Vous pouvez modifier
l'emplacement du fichier de configuration en modifiant la
variable $modapprc au dbut du programme.

Le format du fichier .modapprc est le suivant :
optionglobale1=valeur
optionglobale2=valeur
optionglobalen=valeur
[nom.groupe.modere1]
optiongroupe1=valeur
optiongroupe2=valeur
[end]
[nom.groupe.modere2]
optiongroupe1=valeur
optiongroupe2=valeur
[end]

Le fichier contient deux types de dclarations :

* des dclarations globales, qui s'appliquent  tous les groupes
que vous modrez. Ces options permettent de prciser par exemple
le chemin d'accs au programme rnews, o l'adresse du serveur
de mail contenant les alias de tous les modrateurs. Le format
de ces dclarations est : cl=valeur

* des dclarations particulires  un groupe modr. Ces dclarations
se trouvent dans un "bloc" dont le dbut est dclar par
[nom.du.groupe.modere1] et la fin par [end]. Le format de ces
dclarations internes  un bloc est galement : cl=valeur

Il est possible de dclarer les paramtres globaux entre deux
blocs de dclarations de groupes, mais pas dans un bloc de
dclaration de groupe.

Dans le cas d'une dclaration d'une variable du fichier de configuration
 laquelle vous voulez affecter la valeur "yes", "no" ou "ask",
vous pouvez utiliser "y", "n" ou "a" , ou taper la valeur en majuscules.

Les lignes commenant par le caractre "#" sont considrs comme
des commentaires et sont ignors.

Les lignes blanches sont galement ignores.

------------------------------

4.1.1. DECLARATIONS GLOBALES

* sender : indiquer votre adresse e-mail. Elle permet  modapp
de gnrer l'en-tte Sender:

Exemple : sender=sn@penelope.frmug.org

* organization : indiquer la valeur par dfaut du champ d'en-tte
Organization: . Cette valeur est prise en compte uniquement si l'article
 modrer ne contient pas dj de champ Organization:.

Exemple : organization=Usenet
Defaut : Usenet

* nntpserver : nom (ou adresse IP) du serveur de news utilis pour
poster l'article.

A partir de la version 0.10, il est possible de prciser plusieurs
serveurs de news, les noms des serveurs tant spars par des virgules,
utiliss par modapp. Dans ce cas, l'article est post simultanment
sur tous les serveurs prciss dans cette variable.
Cette variable est utilise par les trois mthodes de postage d'articles
utilisables par le programme (rnews, News::NNTPClient, Net::NNTP).

Exemple : nntpserver=news.machin.com
Exemple : nntpserver=news.machin.com,news.bidule.fr,localhost
Dfaut : localhost

* post : chemin d'accs complet au programme permettant de poster
l'article contenant tous les en-ttes au format RFC1036 sur le serveur
de news. Il faut noter que le script est programm pour fonctionner
avec le programme RNEWS, et QU'IL NE FONCTIONNERA PAS CORRECTEMENT
avec inews. En effet, modapp gnre TOUS les champs d'en-ttes
ncessaires, et certains sont refuss par inews (Path: ou From: par exemple).

Si post n'est pas dfini dans le fichier de configuration,
modapp utilise le module CPAN News::NNTPClient ou Net::NNTP.
Dans ce cas, et si le serveur de news n'est pas "news" ou "localhost", 
veillez  avoir dfini la variable d'environnement shell NNTPSERVER
avant de lancer modapp.

Vous pouvez galement dfinir la variable de configuration 'nntpserver'
qui spcifie le nom du serveur de news utilis pour poster l'article.

Si la variable 'post' est dfinie, elle est utilise par le programme
avec les options de ligne de commande suivantes : -v  -h nntpserver,
nntpserver tant le contenu de la variable globale 'nntpserver' dfinie
dans le fichier de configuration (voir plus haut).

Exemple : post=/usr/local/news/bin/rnews

* popts : options de ligne de commande du programme prcis par la
variable post.

Exemple : popts=-v -h localhost

-> Obsolte dans la version 0.9

* active : chemin d'accs complet au fichier active du serveur de news.
Cette variable n'est utilise que si vous souhaitez vrifier le
contenu de l'en-tte Newsgroups: avant de poster l'article sur
le serveur. Le fichier active doit tre au format INN, c'est  dire
que chaque ligne est de la forme : nom.du.groupe himark lomark flags 

Vrifiez que vous pouvez bien lire ce fichier (par dfaut, le
fichier active est lisible uniquement par l'utilisateur news, dans le
cas d'une installation par dfaut de INN).

Si cette variable n'est pas dfinie (ou si le fichier est introuvable),
modapp essaie d'utiliser Net::NNTP ou News::NNTPClient pour rcuprer la
liste des groupes sur le serveur de news par NNTP. Comme il rcupre la
liste complte, l'excution risque d'tre ralentie. Il est donc conseill
de rcuprer soi-mme cette liste (et ventuellement de la tenir 
jour) et de donner le chemin d'accs au fichier dans cette variable.

Exemple : active=/usr/local/news/etc/active

* moderators : nom du serveur de mail contenant tous les alias
des modrateurs. Cela n'est utile que si vous voulez faire suivre
un article crosspost dans plusieurs groupes modrs aux autres
modrateurs. Dans ce cas, modapp envoie l'article par mail
 l'adresse nom-du-groupe@moderators .

Exemple : moderators=uunet.uu.net
Defaut : uunet.uu.net

* sendmail : nom du programme permettant d'envoyer un message lectronique.
Cela n'est utile que si vous voulez faire suivre un article crosspost
dans plusieurs groupes modrs au autres modrateurs.
Noter que modapp est programm pour gnrer un en-tte To: utilis
par sendmail lorsqu'il est lanc avec l'option -t.

Si la variable sendmail n'est pas positionne, modapp utilise 
le module Perl Net::SMTP pour envoyer le mail.

Exemple : sendmail=/usr/sbin/sendmail

* mopts : options de la ligne de commande du programme dfini dans
la variable sendmail.

Exemple : mopts=-t

* mailhost : utilis par la fonction d'envoi de l'article par mail,
dans le cas d'un crosspost entre plusieurs groupes modrs. Cette
variable n'est utilise que si vous choisissez de ne pas utiliser
sendmail pour envoyer le mail. Dans ce cas, le script utilise Net::SMTP
pour envoyer le mail, et vous pouvez prciser avec mailhost le nom
d'un serveur SMTP.

Exemple : mailhost=mailhub.companie.fr
Defaut : mailhost=localhost

* checkgroups : variable boolenne prenant la valeur "yes" ou "no",
indiquant si le script doit vrifier le contenu du champ Newsgroups:
en recherchant les groupes inconnus ou modrs.
Cette variable est ignore si modapp est lanc avec l'option "-k".

Exemple : checkgroups=yes
Exemple : checkgroups=no

* expire : valeur par dfaut du nombre de jours pendant lesquels
l'article doit tre gard par les serveurs de news. Cette variable
permet  modapp de gnrer un en-tte Expires: . Ce champ n'est pas
ncessaire, et peut tre rgl dans chaque bloc de dclaration de
groupe modr. Elle n'est prise en compte que si aucune dclaration
expire n'est prsente dans un bloc de dclaration de groupe.  
Cette variable est ignore si modapp est lanc avec l'option "-e nombre".

Exemple : expire=20

* archdir : rpertoire contenant les articles posts par modrate
lorsqu'il est lanc avec l'option "-a". Ce rpertoire contient
galement des fichiers d'extension "msgid" o est stock le message-id
d'un article contenant l'en-tte secondaire Archive-Name. Ceci est dtaill
dans le paragraphe 4.2.8. Il est possible d'utiliser la notation
abrege "~" pour indiquer que le chemin est relatif au home directory
du modrateur

* editor : diteur de texte lanc par modapp aprs modification 
de l'article.

Defaut : variable d'environnement shell EDITOR

* printnxp : variable booleene qui prcise si on veut afficher
ou non l'en-tte non standard X-Newsposter. Si printnxp vaut "no",
l'en-tte n'est pas affich.

* archive : tri-option (yes,no,ask). Si la valeur est "yes", tous les
articles posts par modapp sont archivs dans le rpertoire archdir.
Si la valeur est "ask", le programme demande si l'article doit tre
archiv une fois qu'il a t envoy au serveur de news. Si la valeur
est "no", l'article n'est pas archiv.

* simplepath : variable booleene ayant le mme effet que l'option de ligne
de commande "-p". Si simplepath vaut "yes", le champ Path: contient
la valeur par dfaut "not-for-mail".

* tmpdir : chemin d'accs au rpertoire temporaire

Exemple : tmpdir=/home/sn/tmp
Defaut : /tmp

* pgpkeyring : chemin d'accs au rpertoire contenant les fichiers 
d'anneau PGP du modrateur

Exemple : pgpkeyring=~/pgp/keys/
Dfaut : pgpkeyring=~/.pgp/

* pgpuser : nom  utiliser pour signer l'article avec PGP

Exemple : pgpuser=pm@penelope.frmug.org
Exemple : pgpuser=penelope.moderated

* pgpsign : variable prcisant si l'article doit tre sign s'il
est post dans les news (valeur : post) ou s'il est envoy par mail
au modrateur suivant (valeur : mail)

Exemple : pgpsign=post
Exemple : pgpsign=mail

* pgppassfile : chemin d'accs au fichier contenant la phrase permettant
d'utiliser la cl prive PGP pour signature de l'article

Exemple : pgppassfile=~/.pgp/penelope.moderated.passfile

* pgpheaders : Nom des en-ttes d'article Usenet, spars par des virgules,
utiliss pour la signature de l'article. Les en-ttes spcifis doivent
tre crits tel qu'ils sont utiliss dans les news, en respectant la
casse des caractres. Certains en-ttes spcifis peuvent ne pas figurer
dans l'article, auquel cas ils sont ignors pendant le calcul de
la signature.

Exemple : pgpheaders=From,Newsgroups
Dfaut : pgpheaders=Subject,Control,Message-ID,Date,From,Sender

Pour plus de dtails sur l'utilisation de PGP dans modapp, reportez-vous
au paragraphe 4.5.

------------------------------

4.1.2. DECLARATIONS DE GROUPES MODERES

Modapp se base sur les dclarations de groupes modrs effectues
dans le fichier de configuration pour gnrer les en-ttes qu'il
ajoute ou modifie dans les articles.

Il est possible de dclarer dans le fichier plusieurs groupes
modrs, ce qui vous permet, en tant que modrateur de plusieurs
groupes d'utiliser un seul et unique logiciel, au lieu de
plusieurs scripts spars pour chaque groupe que vous grez.

Souvent, les en-ttes des articles ne sont pas identiques
d'un groupe modr  l'autre. La plupart du temps, la valeur
du champ Approved: dpend du groupe contrl par le modrateur.
De mme, la politique d'attribution du champ Followup-To: peut
changer suivant les groupes.

Pour dclarer un groupe modr dans le fichier de configuration,
il faut ajouter un "bloc" commenant par la ligne suivante :
[nom.du.groupe.modere1]

et se terminant par la ligne :
[end]

Ainsi pour dclarer plusieurs groupes modrs (dans le cas d'un modrateur
s'occupant de plusieurs groupes), il suffit de dclarer plusieurs
blocs :
[nom.du.groupe.modere1]
declarations s'appliquant au groupe1
[end]
[nom.du.groupe.modere2]
declarations s'appliquant au groupe2
[end]

Il est important d'utiliser le nom exact du groupe dont vous vous
occupez dans la ligne de dclaration de dbut de bloc. Cette ligne
n'est pas une tiquette particulire, mais bel et bien le NOM
COMPLET du groupe auquel s'appliquent les dclarations situes
 l'intrieur du bloc.

Exemples : 
[fr.comp.infosystemes.www.annonces]
[end]

[fr.usenet.reponses]
[end]

Lorsque les blocs sont dclars dans le fichier de configuration, 
vous pouvez utiliser  l'intrieur de chaque groupe les
dclarations suivantes.

* approved : valeur du champ d'en-tte Approved: ajout aux articles
que vous approuvez. Vous pouvez indiquer votre nom entre parenthses.

Exemple : approved=fr-sem@frmug.org
Exemple : approved=fciwa@frmug.org

* followup : valeur du champ Followup-To: qui est ajout aux articles
posts par modapp. Si l'article contient dj un champ Followup-To:
qui n'est pas conforme  la dclaration "followup", il est remplac
par la valeur prcise dans le fichier de configuration.

followup peut valoir soit "poster", soit le nom d'un ou de plusieurs
groupes Usenet (dans le cas de plusieurs groupes, ils doivent tre
spars par des virgules).

Exemple : followup=poster
Exemple : followup=fr.comp.infosystemes.www.annonces.d

* signature : ce mot-cl est spcial, car il peut apparaitre
plusieurs fois de faon conscutive  l'intrieur d'un bloc de
dclaration de groupe. Il contient la ou les lignes qui sont
automatiquement ajoutes  tout article post par modapp.

Exemple :
signature=Modration de fr.comp.infosystemes.www.annonces :
signature=Annonces: fciwa@frmug.org - Commentaires: fciw-request@frmug.org
signature=fciwa sur le Web : <URL:http://www.frmug.org/cgi-bin/fciwa.cgi>

* expire : nombre de jours pendant lesquels l'article
doit tre gard sur les serveurs de news. Ce champ s'applique uniquement
au groupe concern, ce qui permet d'avoir des valeurs diffrentes
d'expire suivant les groupes modrs.

Exemple : expire=30

* pgpuser, pgppassfile, pgpsign, pgpheaders : ces options dcrites
au paragraphe 4.5 sont utilisables galement dans des dfinitions
de groupes, ou bien globalement. (voir 4.1.1 et 4.5.)

------------------------------

4.1.3. DECLARATION CANCEL

Le fichier .modapprc peut galement contenir une entre spciale,
utilise par la fonction d'annulation d'article intgre dans modapp.
Cette entre est une dclaration de bloc avec comme nom de groupe
le mot "cancel". Dans ce cas :

* le mot cl "approved" doit contenir votre adresse e-mail personnelle
* la signature est ajoute dans le corps du message, l'ancien texte
tant supprim.

Exemple :
[cancel]
approved=sn@penelope.frmug.org (Sylvain Nierveze)
signature=Article cancelled by moderator
[end]

Vous pouvez consulter le fichier modapp.rc livr avec le programme.
Il contient trois exemples de dclarations de groupes modrs et un
exemple de dclaration de bloc "cancel".

Si le groupe "cancel" n'est pas dfini dans .modapprc, modapp
utilise les valeurs par dfaut suivantes :
Approved: valeur sender du fichier de configuration
Signature: "Article cancelled by moderator"

------------------------------

4.2. UTILISATION DU PROGRAMME

Pour utiliser modapp, il faut :
* crer un fichier .modapprc tel que dfini au paragraphe 4.1.
* crer un rpertoire correspondant  la variable archdir du fichier
  de configuration
* tester sa configuration

Lorsque ces trois tapes ont t suivies, il est possible 
d'utiliser effectivement le programme.

------------------------------

4.2.1. TESTER LA CONFIGURATION

Pour tester modapp, il suffit de le lancer avec l'option -t.
De cette faon, il analyse son fichier de configuration en affichant
les erreurs dtectes dans la configuration, ainsi que la valeur
des variables globales, et pour chaque groupe dfini, la valeur
des variables locales  chaque groupe.

Exemple :

$ modapp -t 

modapp: sgnature : unknown group option (modapprc line 13)
modapp: organisation : unknown main option (line 2)

Global options: 
--------------
sender: sn@penelope.frmug.org
organization: Usenet
moderators mail hub: uunet.uu.net
active file: /usr/local/news/etc/active
default expiration: 
verify Newsgroups header : yes
Article Archive dir : /home/sn/.modarchives
Temporary directory : .
Archive policy : no
Editor : vi
News post program : via News::NNTPClient
mail program : none
** WARNING : No mail method is available !! **
** Please install sendmail or Net::SMTP Perl module **
mail options : -t
Print X-Newsposter header : yes
Generate a simple Path header : no

Newsgroup: fr.comp.infosystemes.www.annonces
---------
approved: fciwa@frmug.org (Sylvain Nierveze)
followup: fr.comp.infosystemes.www.annonces.d
signature:
Modration de fr.comp.infosystemes.www.annonces :
Annonces: fciwa@frmug.org - Commentaires: fciw-request@frmug.org
fciwa sur le Web : <URL:http://www.frmug.org/cgi-bin/fciwa.cgi>

Newsgroup: fr.announce.seminaires
---------
approved: fr-sem@frmug.org (Sylvain Nierveze)
followup: poster
expire: 0
signature:
Modration de fr.announce.seminaires + Annonces: fr-sem@frmug.org

Newsgroup: cancel
---------
approved: sn@penelope.frmug.org (Sylvain Nierveze)
signature:
Article cancelled by moderator

Vous pouvez voir au dbut du rsultat les erreurs dtectes,
puis le contenu de chaque variable.

L'option "-t" permet galement de vrifier la dclaration
des chemins d'accs des programmes externes, ou l'existence
de modules Perl utiliss par le programme.
Dans l'exemple ci-dessus, ni sendmail ni le module Perl Net::SMTP
sont installs ou correctement dclars (pour sendmail uniquement),
ce qui provoque l'affichage d'un message d'avertissement.

Il est galement possible de tester que les options sur la ligne
de commande sont bien prises en compte (options -e et -k) en lanant
modapp -t avec ces options :

"modapp -t -e 5" donnera par exemple :
...
default expiration: 5
...

------------------------------

4.2.2. INVOCATION STANDARD

Lorsque vous lancez modapp, il modifie le ou les article(s) donn(s)
en entre standard pour qu'il(s) soi(en)t accept(s) par le serveur de news.

Modapp dtecte le groupe dans lequel l'article doit tre post
en analysant le champ d'en-tte Newsgroups: . Il rcupre ensuite
les valeurs des champs Approved:, Expires: et Followup-To: de la
dclaration correspondante dans le fichier .modapprc, et ajoute  la
fin du fichier la signature dclare dans le fichier de configuration.
Avant de poster l'article sur le serveur, il lance la commande
dfinie par la variable "editor" sur l'article modifi pour que vous
puissiez contrler que l'article est correct, et ventuellement le
modifier suivant les rgles de modration que vous vous tes fix.

Lorsque vous quittez l'diteur, modapp vous demande si vous voulez 
poster l'article, ne pas le poster ou l'diter de nouveau :

(p)ost, (a)bort, (e)dit ?

Rpondez "p" pour poster l'article sur votre serveur, "a" pour
revenir au shell sans poster l'article, et "e" pour diter l'article
au cas o vous auriez oubli quelque chose.

Si l'article ne contient pas de champ Newsgroups:, ou s'il contient
des groupes qui ne sont pas dfinis dans .modapprc, modapp le dtecte
et vous propose de le poster dans un des groupes que vous avez dclars
dans le fichier de configuration. En fait, il ne propose de choisir
le groupe que si PLUSIEURS groupes sont dclars dans la configuration :

The following article does not contain a valid Newsgroups: header
From: e-mail (Prenom Nom)
Subject: sujet
Newsgroups: fr.machin.bidule
1) fr.comp.infosystemes.www.annonces
2) fr.announce.seminaires
3) fr.usenet.reponses
Choose the newsgroup to use (1-3): 

Tapez ensuite le numro du groupe que vous souhaitez (1  3 dans l'exemple
ci-dessus).

Vous pouvez prciser le nom du newsgroup modr  utiliser avec
l'option -g. Dans ce cas, modapp ne propose pas de choisir le groupe
modr  utiliser. Si le nom du groupe prcis par l'option -g ne fait
pas partie des groupes dclars dans le fichier de configuration,
ou bien si le groupe n'existe pas sur le serveur (bizarre !), modapp
envoie le message d'erreur suivant :

modapp : No Newsgroups

Si le champ Followup-To: est prsent dans l'article, et s'il est
diffrent de la valeur dfinie dans le fichier de configuration,
modapp demande s'il doit garder ou non la valeur de l'article :

Keep Followup-To: poster header ? (y/n)

Rpondez "y" pour garder ce champ, "n" pour le remplacer par la
valeur dfinie dans .modapprc.

Si le champ Reply-To: est prsent dans l'article, le programme
demande s'il doit le garder dans l'article qu'il va poster :

Keep Reply-To: machin@truc.org header ? (y/n)

Rpondez "y" pour garder ce champ, "n" pour le supprimer de l'article
 poster.

------------------------------

4.2.3. VERIFICATION DU CHAMP NEWSGROUPS

Modapp est capable de vrifier les groupes dclars dans
le champ d'en-tte Newsgroups: d'un article,  condition
qu'il soit lanc avec l'option -k ou que checkgroups=yes
soit indiqu dans le fichier de configuration.

Modapp vrifie si chaque groupe de la ligne Newsgroups:
existe ou non, et s'il est modr ou non.
Si modapp dtecte un ou plusieurs groupes inexistants sur votre
serveur de news, ou s'il trouve des groupes modrs (en dehors
de ceux dclars dans .modapprc), il vous l'indique en vous
proposant plusieurs options.

Si modapp trouve des groupes inexistants, il l'indique de 
la faon suivante :

Newsgroup un.groupe not found
## Unknown newsgroups were found
(c)ontinue, (d)elete the newsgroups from headers, (a)bort ?

Vous pouvez taper "c" pour ignorer ce message et garder les groupes
inconnus dans l'article, "d" pour supprimer du champ Newsgroups:
les groupes inconnus, ou "a" pour arrter le script.

Il signale les groupes modrs de la facon suivante :
Newsgroup autre.groupe moderated
## Moderated newsgroups were found
(c)ontinue, (d)elete the newsgroups from headers, 
(f)orward to next moderator, (a)bort ?

En plus des options c,d, et a, vous pouvez choisir de faire suivre
l'article au modrateur du premier groupe modr dans le champ
Newsgroups:. Dans ce cas, modapp ajoute un champ "To:" contenant
l'adresse e-mail du moderateur, ajoute un champ d'en-tte 
Approved: contenant la valeur de votre champ Approved:, ainsi
que celle de l'eventuel champ Approved: contenu dans l'article
lorsqu'il vous a t envoy par mail.
Il ajoute galement au dbut du message une notice d'information
 destination du modrateur afin de lui indiquer que l'article
est approuv par vous, mais qu'il lui est envoy pour qu'il approuve
et le publie lui-mme :

Approved: fr-reponses@frmug.org
To: fr-announce-newgroups@uunet.uu.net

############# MODERATION INFO #####################################
This message has been approved by the moderator
of fr.usenet.reponses, but it should be crossposted to 
the moderated fr.announce.newgroups newsgroup. 
It has been forwarded to you for approval. 
If there is another moderated newsgroup on the
Newsgroups line, please forward the article to the next moderator.
Please delete this information before approval.
######## END OF MODERATION INFO ###################################

Modapp lance ensuite l'diteur sur l'article modifi,
puis vous propose d'envoyer l'article par e-mail :

(m)ail, (a)bort, (e)dit ?

Choisissez "m" pour envoyer l'article par e-mail  l'autre modrateur. 

------------------------------

4.2.4. OPTION -n : NE PAS ENVOYER L'ARTICLE

Vous pouvez utiliser l'option "-n" de modapp si vous souhaitez
voir ce que donne le lancement du programme sans envoyer l'article
au serveur de news. Cela revient au mme que de rpondre "a"(bort)
lorsque modapp vous demande de poster l'article sur le serveur
(ou de l'envoyer en mail).

------------------------------

4.2.5. OPTION -p : CHAMP PATH SIMPLE

Par dfaut, modapp gnre un champ Path: comprenant la partie
 gauche du "@" de la valeur de Approved:. 

Par exemple, si on a la dfinition suivante dans .modapprc :
[fr.announce.seminaires]
approved=fr-sem@frmug.org
...

le champ Path: des articles posts par modapp dans le groupe
concern contiendra "Path: fr-sem" .

Avec l'option -p, modapp gnre un en-tte Path: simple qui contient
"Path: not-for-mail".

L'option "-p" est quivalente  la variable "simplepath=yes" du
fichier de configuration.

------------------------------

4.2.6. OPTION -i : MESSAGE-ID

En utilisant l'option -i suivi d'un message-id valide, il est possible
de prciser le contenu du champ d'en-tte Message-ID: qui doit
tre inclus dans l'article  poster.

Aucun contrle n'est fait pour vrifier la syntaxe (ou l'unicit)
du champ donn par l'option -i.

------------------------------

4.2.7. CHAMPS REFERENCES ET SUPERSEDES

Modapp est capable de grer les champs References: et Supersedes:,
ce qui permet de poster facilement des FAQ ou de modrer des groupes
de discussion (enfin, presque :-).

Pour cela, il est ncessaire d'avoir dclar la variable
archdir dans .modapprc, et que le rpertoire correspondant
soit cr.

Modapp peut gnrer un champ References: ou Supersedes:
uniquement pour les articles contenant un champ d'en-tte secondaire
Archive-Name:. Dans ce cas, il stocke dans un fichier du rpertoire
archdir le message-id de l'article avant de le publier. Le nom du
fichier est constitu  partir de Archive-Name:, en remplacant
les "/" par des points. Par exemple, si un article contient
Archive-Name: fr/machin/truc, le fichier contenant son message-id
sera archdir/fr.machin.truc.msgid.

Lorsque modapp est lanc avec l'option "-r" ou "-s" sans argument, il
affiche la liste des fichiers msgid disponibles dans le rpertoire archdir,
et demande quel fichier il doit consulter. Il gnre ensuite un champ
References: ou Supersedes: contenant le message-id lu du fichier choisi.

S'il est lanc avec "-r" ou "-s" avec un argument, il prend cet
argument comme nom de fichier situ dans le rpertoire archdir
pour rcuprer le Message-ID qui y est stock. Par exemple,
si on lance "| modapp -s fr.machin.part1", le programme va lire
le fichier archdir/fr.machin.part1.msgid pour y rcuprer le
message-id de l'article  remplacer, puis ajouter l'en-tte
Supersedes: contenant le message-id rcupr du fichier.

Prenons un exemple : Supposons que nous devons publier rgulirement
la FAQ fr/machin en deux parties dans le groupe fr.truc.machin.
Les deux articles ont un champ Archive-Name: valant fr/machin/part1
et fr/machin/part2.
La premire fois que nous lanons modapp pour publier la premire
partie, il est inutile de lancer modapp avec l'option "-s" puisque
le fichier contenant l'article publi prcdemment n'existe pas.
Modapp stocke le message-id de l'article que nous publions pour
la premire fois dans archdir/fr.machin.part1. Nous voulons ensuite
publier la seconde partie, et pour bien faire, il faut mettre dans
le second article une rfrence au premier. Nous lanons donc
"modapp -r" et choisissons  quel article nous voulons lier le premier :

Here are the available Archive-Name files :
0) NONE
1) fr.bidule.part1
2) fr.bidule.diff
3) fr.machin.part1
Choose the Archive-Name to reference (0-3) :

Nous pouvons choisir 0 pour ne pas inclure de champ References:,
mais comme nous voulons que les deux parties de la FAQ apparaissent
comme un seul "fil de discussion", nous choisissons le troisime
fichier.
Modapp lance alors l'diteur, ce qui permet de vrifier la valeur
du champ References.

Supposons maintenant que l'on veuille publier fr/machin/part1 et part2
deux semaines plus tard. Pour que la premire partie de la nouvelle
version remplace l'ancienne sur tous les serveurs de news, il faut
inclure dans l'article un champ Supersedes: . Pour cela, on lance
modapp avec l'option "-s". On peut alors choisir quel article
doit tre remplac :

Here are the available Archive-Name files :
0) NONE
1) fr.bidule.part1
2) fr.bidule.diff
3) fr.machin.part1
4) fr.machin.part2
Choose the Archive-Name to supersede (0-3) :

Vous remarquez que la deuxime partie de la FAQ (dans l'ancienne
version) est apparue dans la liste. Nous choisissons le troisime fichier
pour remplacer l'ancien article part1 par le nouveau. Pour publier
la seconde partie de la nouvelle version, on lance "modapp -s -r"
et on choisit de rfrencer l'article 3 et de remplacer l'article 4.

Il faut noter galement que modapp est capable de conserver
les en-ttes Supersedes: et References: dj prsents dans un article,
ce qui permet de modrer facilement un petit groupe de discussion.

------------------------------

4.2.8. CHAMP EXPIRES

Modapp peut gnrer un champ Expires: si une variable "expire"
est dfinie dans le fichier de configuration. Cette variable
peut tre soit globale, soit locale  un groupe. 
De plus, si modapp est lanc avec l'option "-e nombre",
o "nombre" est un entier suprieur  zero, il est capable
de gnrer un en-tte Expires: pour l'article sur lequel
il est lanc et uniquement celui-ci.

L'ordre dans lequel ce champ est calcul est le suivant :
- d'abord option -e de la ligne de commande
- si modapp n'est pas lanc avec "-e", la variable locale  une
  definition de groupe modr est prise en compte
- si modapp n'est pas lanc avec "-e", et s'il n'existe pas
  de dclaration "expire" dans une dfinition de groupe modr,
  alors la dclaration "expire" GLOBALE est prise en compte.

Dans tous les cas, si la valeur indique aprs "-e" ou bien
sur la dclaration "expire" du fichier de configuration vaut zero,
aucune champ Expires: n'est inclus dans l'article.

Le champ Expires: gnr est conforme  RFC1036. Il est calcul en ajoutant
le nombre de secondes correspondant  la valeur de la variable "expire", ou
de l'option -e (ces valeurs sont, elles, exprimes en jours)  la valeur
de la date actuelle et en reconvertissant cette valeur au format standard.

------------------------------

4.2.9. ARCHIVAGE DES ARTICLES

Cette option ne fonctionne que si l'article contient un champ
d'en-tte secondaire Archive-Name: . Dans ce cas, l'article est 
stock dans le rpertoire archdir avec comme nom de fichier
le contenu de Archive-Name o les caractres "/" sont remplacs
par des points.

Pour utiliser la fonction d'archivage, lancer modapp avec
l'option -a.

L'option "-a" est quivalente  la dclaration "archive=yes/no/ask"
du fichier de configuration.

------------------------------

4.2.10. OPTION -v : AFFICHER LA VERSION DU PROGRAMME

modapp -v affiche la version du programme :

$ modapp -v
modapp version 0.7

Noter que modapp inclut un en-tte X-Newsposter: modapp vx.y
dans tous les articles qu'il poste,  moins de dclarer
l'option "printnxp=no" dans le fichier de configuration.

------------------------------

4.2.11. OPTION -h : AFFICHER LE MESSAGE D'AIDE

modapp lanc avec l'option -h affiche le dtail des options.

$ modapp -h
Usage: modapp [-a] [-c] [-e nombre]
...

------------------------------

4.3. LA FONCTION D'ANNULATION D'UN ARTICLE

Modapp contient une fonction d'annulation d'article intgre.
Pour annuler un article visible dans le (ou l'un des) groupe(s)
dont vous tes responsable, il suffit dans votre logiciel
de news d'invoquer la commande qui permet d'envoyer l'article
que vous tes en train de lire  une commande externe (c'est
souvent la touche "|" sur les lecteurs en mode texte), et de lancer
la commande "modapp -c" ou "cancel", si vous avez pris soin
de faire un lien entre cancel et modapp  l'installation du programme.

Modapp gnre alors un message d'annulation contenant
un champ d'en-tte spcifique Control: cancel message-id,
ainsi que les en-ttes standards. Il efface le corps du message
original et le remplace par le contenu de la variable
signature du bloc "cancel" dfini dans le fichier de configuration
de modapp. Il lance ensuite l'diteur sur l'article modifi, et
vous propose au final d'envoyer le message de contrle  votre
serveur.

Cette fonction intgre d'annulation d'article a pour but
d'tre utilise uniquement par les modrateurs sur les groupes
qu'ils grent, et non par les apprentis annuleurs :-). Elle n'est
pas disponible publiquement. Un patch est disponible sur demande.

------------------------------

4.4. FONCTIONNEMENT DE MODAPP EN MODE SILENCIEUX

Lorsqu'il est invoqu avec l'option "-q", modapp utilise un mode
de fonctionnement spcial appel mode silencieux ("quiet mode").
Le comportement du programme dans ce cas est diffrent du mode de
fonctionnement normal (interactif).

Ce mode de fonctionnement peut tre utilis pour poster priodiquement
et automatiquement des documents dans les groupes grs par le modrateur.

Un article post en mode silencieux doit contenir tous les
champs d'en-tte ncessaires  sa publication. En particulier,
puisque "modapp -q" ne pose aucune question au modrateur, il est
ncessaire qu'un en-tte Newsgroups: soit prsent dans l'article.
Sinon, modapp affiche le message suivant :

modapp: [Quiet mode] : No valid newsgroups in headers

Si le champ Newsgroups: contient des groupes modrs autres que
ceux dfinis dans le fichier de configuration, ou bien des
groupes inconnus sur le serveur du moderateur, ces groupes inconnus
ou modrs ne sont PAS SUPPRIMES de l'article.

Si modapp est lanc avec l'option "-m", au lieu de garder les groupes
modrs sur la ligne Newsgroups: et de poster l'article directement
dans les groupes qui sont modrs par d'autres modrateurs (ce qui
ncessite d'avoir leur autorisation pour le faire), il fait suivre
en mail l'article au modrateur des autres groupes modrs (en fait
au modrateur du prochain groupe modr dans la liste des groupes
o l'article doit tre crosspost). Il est possible de prciser aprs
cette option le nom du groupe  qui on doit faire suivre l'article.
Cette option est surtout utilise en conjonction avec modappbot,
afin de forcer modapp  faire suivre l'article par mail au modrateur
d'un groupe dclar dans modapprc.

Il faut noter qu'avec l'option de ligne de commande "-g", il est possible
de prciser le nom du groupe  utiliser si aucun n'est prcis
dans la ligne Newsgroups: de l'article, ou bien si tous les groupes
sont invalides (ou d'autres raisons mystrieuses). Dans ce cas,
modapp gnre un en-tte Newsgroups: avec le nom du groupe prcis par
l'option -g,  condition que ce groupe soit dclar dans le fichier
de configuration. Sinon, modapp affiche le message d'erreur suivant et
termine :

modapp : No Newsgroups

En fonctionnement silencieux, modapp garde le champ Followup-To:
s'il existe dans l'article, ou bien le rajoute suivant la valeur
dfinie dans le fichier de configuration , si le champ n'est pas prsent.

Si modapp est lanc avec l'option "-r" ou "-s" sans argument,
il affiche un message d'avertissement et poste l'article sans champ
References: (ou Supersedes:, suivant l'option de ligne de commande) :

modapp: [Quiet mode] Modapp called with -r or -s with no msgid file provided

Cela signifie qu'il est ncessaire de donner un argument  l'option
de ligne de commande. Par exemple : 
modapp -q -s fr.machin.part2 -r fr.machin.part1 part2

En mode silencieux, l'article n'est pas archiv si la dclaration "archive" du
fichier de configuration est positionne  "ask". Il faut utiliser
l'option "-a" de ligne de commande, ou bien donner  "archive" la
valeur "yes" pour que l'article soit archiv en mode silencieux (ce
qui n'a pas beaucoup d'intrt)

------------------------------

4.5. SIGNER LES ARTICLES AVEC PGP

Modapp, depuis la version 0.7, est capable de signer les articles
modrs avec PGP. Pour cela, il utilise le module PGP::Pipe qui implmente
un interface (API) Perl avec le programme pgp.

Ce module dans sa version actuelle (0.3a) comporte
quelques bugs, aussi le fichier Pipe.pm est distribu avec l'archive
de modapp pour que le script fonctionne correctement. Recopiez ce
fichier dans le sous-rpertoire PGP du rpertoire contenant les sources 
de PGP-Pipe : cp Pipe.pm ~/src/PGP-0.3a/PGP/Pipe.pm, 
puis perl Makefile.PL, etc.

------------------------------

4.5.1. POURQUOI SIGNER UN ARTICLE AVEC PGP ?

Le but est de permettre aux lecteurs d'un groupe modr de s'assurer 
que les articles publis dans le groupe en question ont bien t 
approuvs par l'quipe de modration. De plus, la possibilit de signer
avec PGP les articles permet aux modrateurs d'utiliser des programmes
de vrification automatique des articles publis dans le groupe, afin
d'annuler les articles non signs et publis  leur insu.

------------------------------

4.5.2. ASPECTS LGAUX

On ne l'crira jamais assez: l'utilisation de PGP en France est
interdite, que ce soit  des fins de chiffrement des messages, ou
d'authentification. Modapp permet d'utiliser PGP pour authentifier
les articles, et non pour les chiffrer. Cela n'empche pas qu'il
n'est pas lgalement autoris d'utiliser cette fonctionnalit en France.

Si vous tes franais et que vous voulez respecter la lgislation
franaise, il suffit de ne pas dclarer d'options "pgp" dans
le fichier de configuration pour que Modapp n'utilise pas ces
fonctions d'authentification forte. Modapp s'excutera d'ailleurs
beaucoup plus vite si PGP n'est pas utilis.

Nanmoins, si vous tes rsident d'un autre pays dans lequel
l'utilisation de PGP  des fins d'authentification est autorise,
vous pouvez utiliser les fonctions PGP de Modapp sans aucun problme.

------------------------------

4.5.3. DEUX LOGICIELS POUR SIGNER LES ARTICLES DE NEWS AVEC PGP

Les deux mthodes actuellement disponibles pour signer les articles
de news avec PGP sont les suivantes :

- PGPMoose : dvelopp par Greg Rose, RoSecure Software.
Disponible  : <URL:http://www.sydney.sterling.com:8080/~ggr/PGPMoose.html>
Ce module permet de signer un article avec un en-tte d'article
spcial X-Auth. Le paquetage PGPMoose contient galement des scripts
en Bourne shell pour annuler automatiquement les articles non signs.
Ce programme est assez complexe  mettre en oeuvre (procdure
d'enregistrement, dmon  intgrer au logiciel serveur de news, ..)
mais trs puissant.

- pgpcontrol : dvelopp par David Lawrence. pgpcontrol est intgr au
logiciel serveur de news InterNet News (INN) depuis la version 1.5. Ce
logiciel est assez simple  mettre en oeuvre et utiliser bien que moins
puissant que PGPMoose.  Pgpcontrol se base sur la prsence d'un en-tte
de news X-PGP-Sig.  Un des scripts Perl de pgpcontrol, appel pgpverify,
permet de vrifier la validit de la signature PGP d'un article de news.
Pgpcontrol est disponible  l'adresse suivante :
<URL:ftp://ftp.eerie.fr/pub/usenet/pgpcontrol/>

Nous avons choisi d'utiliser pgpcontrol pour sa facilit d'utilisation,
et son utilisation prouve sur de nombreux serveurs de news qui 
l'utilisent pour l'authentification des messages de contrle.

------------------------------

4.5.4. AVANT D'UTILISER LES FONCTIONS PGP DE MODAPP

... vous devez crer une cl pour le groupe de news dont
vous vous occupez. Pour cela, consultez la documentation de PGP.
Trs brivement, cela se fait de la faon suivante :

$ pgp -kg

Pgp vous demande alors un "UserID" pour la cl qui va tre cre.
Vous avez le choix d'indiquer l'adresse de moderation de votre
groupe (par exemple : fciwa@frmug.org) ou bien le nom de votre
groupe (fr.comp.infosystemes.www.annonces par exemple).
Nous conseillons d'utiliser l'adresse e-mail de modration comme
UserID, l'autre mthode tant disponible pour les groupes qui
ont dj une cl PGP utilise pour autre chose (les groupes
administratifs tels que news.announce.newgroups, par exemple).
Choisissez si possible une cl de 1024 bits.

Lorsque la cl est cre, vous pouvez lancer la commande suivante pour
crer un fichier contenant votre cl publique, que vous diffuserez
aux lecteurs du groupe  :

$ pgp -akx <userid> <nom.du.fichier>

o <userid> est le nom entr  la cration de la cl : adresse e-mail
de modration ou le nom de votre groupe, et <nom.du.fichier> est
le fichier crit par PGP et contenant la version "texte" de votre
cl publique.

<nom.du.fichier> contient alors votre cl publique au format ASCII,
 diffuser par les moyens que vous souhaitez aux personnes qui
veulent utiliser PGP pour vrifier la signature des articles
posts dans votre groupe modr.

------------------------------

4.5.5. CAS D'UNE QUIPE DE MODRATION UTILISANT L'AUTHENTIFICATION PGP

Deux cas sont possibles :
- soit tous les membres de l'quipe de modration utilisent la
mme cl pgp (avec comme userid le nom du groupe ou l'adresse e-mail
de modration)
- soit chaque membre cre une cl personnelle et signe les articles
qu'il approuve avec sa cl personnelle

La premire mthode est prfre, mais pose un problme si un des
modrateurs quitte l'quipe. Dans ce cas, il faut changer la cl,
et communiquer la nouvelle cl publique aux lecteurs du groupe, et
aux robots annuleurs ventuels.

La seconde mthode ne pose pas ce problme, mais est plus complexe
 mettre en oeuvre pour les lecteurs, qui doivent connaitre les
cls publiques de tous les modrateurs pour pouvoir vrifier tous
les articles posts dans le groupe modr.

------------------------------

4.5.6. CONFIGURATION DE MODAPP POUR PGP

Plusieurs options, globales ou locales  une dclaration de groupe,
doivent tre dfinies dans le fichier de configuration de modapp
pour pouvoir utiliser la fonction de signature PGP. Ces options sont
les suivantes :
- pgpkeyring pour prciser le fichier contenant les cls PGP
- pgpuser pour prciser le nom utilis pour la signature
- pgppassfile contenant la phrase de passe pour gnrer la signature
- pgpsign pour indiquer si la signature doit tre incluse dans
  les messages envoys par mail (au modrateur suivant) ou dans ceux
  posts sur Usenet
- pgpheaders pour spcifier les champs d'en-tte utiliss pour calculer
  la signature PGP.

Voir 4.1.1 pour une description plus prcise de chaque option avec
des exemples.

Il n'est pas utile de modifier la valeur de pgpkeyring et
pgpheaders. Les valeurs par dfaut sont celles communment utilises.

Les options pgp peuvent tre dclares globalement pour tous les
groupes modrs, ou bien individuellement dans chaque dclaration
de groupe. En pratique, il vaut mieux dclarer pgpsign dans la partie
commune, et pgpuser, pgppassfile dans chaque bloc de dclaration de groupe.

Si vous dclarez certaines options dans la partie globale, elles sont
prises en compte dans tous les blocs de dfinition de groupe,  moins
que vous les modifiiez dans ces blocs. Par exemple, il est possible
de dclarer : pgpsign=post  dans la partie commune, et pour un groupe
pour lequel la signature PGP ne doit pas tre gnre, vous pouvez
indiquer : pgpsign=no .

Si modapp dtecte l'option pgpsign dans la partie globale, il utilise
PGP pour signer le message pour tous les groupes dclars. S'il dtecte
pgpsign dans la partie globale, mais pgpsign=no dans une dclaration
de groupe, il utilise PGP pour signer le message pour tous les groupes
sauf celui o pgpsign=no est dclar. Enfin, si modapp ne voit pas
d'option pgpsign dans la partie globale, il n'utilise pas PGP pour signer
les articles (dans aucun groupe) sauf dans ceux pour lesquels pgpsign
est dclar.

------------------------------

5. REFERENCES

Voir RFC822, RFC1036, ainsi que les commandes rnews(1) et sendmail(8).
Consulter galement les deux manuels d'utilisation de PGP si vous
souhaitez utiliser les fonctions PGP de modapp et que vous ne savez
pas (encore) comment tout cela fonctionne.

Merci de contacter directement l'auteur pour le support technique
et les rapports de bogues.
