Usenet ~ Générer des articles de contrôle signés

Générer des articles de contrôle signés

You will find in this page explanations to use the signcontrol Python script (+ configuration file) I wrote for Usenet hierarchy administrators to sign the control articles they send. It is also useful to manage PGP keys; the script works on every platform (Windows, Linux, etc.). You only have to download and install Python and GnuPG. Then, edit the signcontrol configuration file and modify its few variables to fit your installation. You can then run the script and enjoy it!
More information can be found in the Usenet hierarchy administration FAQ as well as other scripts.

Afin de gérer correctement une hiérarchie sur Usenet, des articles de contrôle doivent régulièrement être envoyés : création ou suppression de groupes et récapitulatif des groupes disponibles. Le script signcontrol que j'ai écrit en Python permet de facilement réaliser cela avec n'importe quel système d'exploitation.

Installation

Téléchargez Python et GnuPG en prenant soin de noter le répertoire d'installation de ce dernier. Puis téléchargez la version Python de signcontrol avec son fichier de configuration et éditez ce dernier fichier. Plusieurs variables sont à modifier :

PROGRAM_GPG doit contenir le chemin jusqu'au programme GnuPG installé. C'est usuellement « C:\Progra~1\GNU\GnuPG\gpg.exe » ou « /usr/bin/gpg » ;

ID est l'identifiant de la clef que vous utilisez pour signer les messages de contrôle. Il est conseillé de mettre une adresse électronique. Notez que si vous n'avez pas encore de clef, vous pourrez la générer avec le script ;

MAIL est votre adresse électronique. Le plus souvent, ce sera la même que l'ID ;

HOST est la deuxième partie des Message-ID des articles de contrôle que vous générez. Vous pouvez par exemple mettre le nom d'un serveur de news ;

ADMIN_GROUP doit être un groupe existant de votre hiérarchie. Si vous en avez un d'administration, vous pouvez le mettre ; sinon, n'importe lequel fait l'affaire ;

NAME est votre nom. Utilisez uniquement des caractères ASCII (pas d'accents) ou bien encodez ce champ en MIME ;

CHECKGROUPS_SCOPE représente l'étendue de votre hiérarchie. Par exemple « fr » indique la hiérarchie fr.* et « de !de.alt » la hiérarchie de.* privée de la sous-hiérarchie de.alt.* ;

URL est une ou plusieurs adresses web relatives à votre hiérarchie (page web ou clef publique par exemple) ;

NEWGROUP_MESSAGE_MODERATED, NEWGROUP_MESSAGE_UNMODERATED et RMGROUP_MESSAGE contiennent les textes qui apparaîtront dans les corps des articles de contrôle correspondants. Toute occurrence de « $GROUP$ » sera remplacée par le nom du groupe en question. Si vous souhaitez utiliser le guillemet « " » dans un de ces messages, il faut l'échapper de la sorte : « \" » ;

PRIVATE_HIERARCHY est une variable (True ou False) qui indique le statut de votre hiérarchie. Si elle est privée (c'est-à-dire si elle n'est présente que sur un seul serveur dont l'accès est privé et qu'elle n'est pas propagée à d'autres serveurs sur Usenet), alors la valeur de cette variable doit être True, de sorte que les checkgroups ne soient pas crucipostés dans news.admin.hierarchies ;

CHECKGROUPS_FILE est le nom du fichier qui contiendra en permanence la liste des groupes (au format checkgroups) de votre hiérarchie ;

ENCODING est l'encodage utilisé par votre système pour générer les articles de contrôle. Usuellement, c'est « ISO-8859-1 ».

Maintenant que tout est paramétré, vous pouvez lancer le script.

Utilisation

L'interface d'utilisation est normalement très simple et plutôt bien détaillée. Elle permet de générer les articles de contrôle pour la création d'un nouveau groupe ou son changement de statut/description, pour la suppression d'un groupe et pour le récapitulatif de la liste des groupes actuels.

Il vous est aussi possible de gérer vos clefs PGP. Si vous n'en avez actuellement pas, vous pouvez en générer une et l'utiliser immédiatement. Toutes les explications pour cela sont données lors de l'exécution du programme. Lisez bien tout ce qu'il dit !
Si vous avez déjà une clef PGP pour administrer votre hiérarchie Usenet, vous pouvez l'importer dans le programme.

Si vous possédez votre propre serveur de news, vous pouvez automatiquement envoyer les articles de contrôle générés par le script avec IHAVE (décommentez les lignes à la fin de la fonction sign_message et placez-y vos identifiants de connexion éventuels et le nom du serveur de news en question). Sinon, il faut trouver un serveur de news acceptant de telles commandes.

Il est même possible d'appeler le script depuis d'autres scripts. Cela se fait très facilement. Par exemple :

#!/usr/bin/python # -*- coding: latin1 -*- import signcontrol config = signcontrol.read_configuration(signcontrol.CONFIGURATION_FILE) groups = signcontrol.read_checkgroups(config['CHECKGROUPS_FILE']) for group in file('list-of-groups-to-remove'): signcontrol.generate_rmgroup(groups, config, group.rstrip()) for group in file('list-of-groups-to-add'): signcontrol.generate_newgroup(groups, config, group.rstrip(), status[group], description[group])

On peut ainsi générer de manière aisée un grand nombre d'articles de contrôle ! Et si le statut ou la description ne sont pas fournies, le script vous les demandera interactivement. Un quatrième argument (optionnel) à generate_rmgroup et un sixième argument (optionnel) à generate_newgroup peuvent être utilisés pour indiquer un message à utiliser différent de celui par défaut. Il est aussi possible de fournir un cinquième argument à generate_rmgroup et un septième à generate_newgroup contenant votre passphrase (bien que cela ne soit pas conseillé pour des raisons de sécurité).

Conseils

Je vous recommande vivement de lire intégralement la FAQ sur l'administration d'une hiérarchie Usenet. Il est notamment conseillé de posséder un site web d'administration sur lequel sont disponibles au moins le checkgroups actuel de votre hiérarchie et votre clef PGP. N'oubliez pas d'annoncer la création de votre hiérarchie sur news.admin.hierarchies !