Manual:Pywikibot/BotPasswords/fr

En tant qu'alternative plus simple (mais moins sûre) à MediaWiki OAuth, cela permet aux utilisateurs de bots d'utiliser des mots de passe de bot pour limiter les autorisations accordées à un bot.

En utilisant BotPasswords, chaque instance reçoit un login_name de la forme et un mot de passe. Cette combinaison permet uniquement d'accéder à l'API, et non à l'interface web normale.

Prérequis

 * Le wiki sur lequel vous souhaitez utiliser le bot doit être équipé de MediaWiki > 1.27.
 * Dans la plupart des installations, le logiciel client doit être configuré pour utiliser le protocole.
 * Bien que les connexions semblent initialement fonctionner, le cookie généré semble incomplet et les actions de pywikibot reposant sur les droits échoueront. Voir T150645.

Configuration

 * Connectez-vous sous votre compte bot (s'il est différent de votre compte principal).
 * Générer un mot de passe pour le bot sous Special:BotPasswords (ou la page correspondante sur un autre wiki) :
 * Remplir un « nom de robot », qui est le suffixe qui sera ajouté à votre nom d'utilisateur. Par exemple « replace-on-tools ».
 * Accorder les droits correspondants. Pour la plupart des scripts Pywikibot, édition de gros volumes, modifier des pages existantes et créer, modifier et déplacer des pages sont suffisants. Si vous souhaitez également téléverser des fichiers avec le bot, ajouter téléverser de nouveaux fichiers et téléverser, remplacer et déplacer des fichiers. Laisser les restrictions d'utilisation telles quelles. Cliquer sur « créer ».
 * Vous recevrez un message du type Le nouveau mot de passe pour se connecter avec Valhallasw@my-botpassword-name est mysupersecretbotpassword Ne fermez pas cette fenêtre avant d'avoir enregistré le mot de passe dans votre fichier de mots de passe (voir ci-dessous)


 * using  script
 * This script can manage for you the creation of a  file. Simply run , and follow the prompts. After the choice of a wiki, and entering your username, you'll be able to enter the name/pass couple created on Special:BotPasswords at the previous step. The name is the one you've chosen, the pass is the one given by the website.


 * ou créer manuellement le fichier.
 * In the directory where your  is, create a file called , and make it unreadable for others
 * In the file user-password.py, add a line
 * In user-config.py, add the line . Note that you should only have you username in that file and leave out the suffix "@my-botpassword-name".


 * vérifier que la configuration fonctionne
 * Run . Pywikibot should now automatically login using your bot password:

Logging in to meta:meta as Valhallasw@my-botpassword-name Logged in on meta:meta as Valhallasw.

format d'entrées password_file
Les entrées dans  doivent être des tuples avec 2, 3 ou 4 éléments :


 * Used when the entry should only be used on a specific, e.g.   or.
 * Used when the entry should only be used on a specific  and , e.g.   and.
 * Used when the entry should only be used on a specific, e.g.   or.
 * Used when the entry should only be used on a specific  and , e.g.   and.
 * Used when the entry should only be used on a specific  and , e.g.   and.