Manual:Pywikibot/BotPasswords/pl
Jako prostszą (ale mniej bezpieczna) alternatywę dla OAuth , MediaWiki umożliwia użytkownikom botów używanie Hasła bota do ograniczania uprawnień nadawanych botowi i nie wymaga rejestracji.
Podczas korzystania z BotPasswords każda instancja otrzymuje login_name w postaci <username>@<bot suffix>
i hasła.
Ta kombinacja może uzyskać dostęp tylko do API, a nie do normalnego interfejsu webowego.
Wymagania
- Wiki, w którym chcesz użyć bota, potrzebuje MediaWiki w wersji > 1.27
- W większości instalacji oprogramowanie klienta powinno być skonfigurowane tak, aby używało protokołu
https
.
Konfiguracja
- Zaloguj się na konto twojego bota (jeśli jest inne niż twoje główne konto).
- Generate a bot password under Special:BotPasswords (or the corresponding page on another wiki):
- Fill in a 'bot name', which is the suffix which will be added to your username. For example 'replace-on-tools'.
- Udzielić odpowiednich uprawnień. For most Pywikibot scripts High-volume (bot) access (necessary to mark bot edits as bot), Edit existing pages and Create, edit, and move pages are enough. If you also want to upload files with the bot, include Upload new files and Upload, replace, and move files. Zostaw ograniczenia użytkowania takimi jak są. Kliknij 'utwórz'.
- You will receive a message like The new password to log in with Valhallasw@my-botpassword-name is mysupersecretbotpassword Nie zamykaj tego okna, dopóki nie zapiszesz hasła w pliku haseł (patrz poniżej)
- using
generate_user_files.py
script -
- This script can manage for you the creation of a
user-password.py
file. Simply runpython pwb.py generate_user_files
, 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.
- This script can manage for you the creation of a
- or creating
user-password.py
file manually -
- In the directory where your
user-config.py
is, create a file calleduser-password.py
, and make it unreadable for others (chmod 600 user-password.py
) - In the file user-password.py, add a line
('Valhallasw', BotPassword('my-botpassword-name', 'mysupersecretbotpassword'))
- In user-config.py, add the line
password_file = "user-password.py"
. Note that you should only have your username in that file and leave out the suffix "@my-botpassword-name".
- In the directory where your
- check that config is working
-
- Run
python pwb.py login
. Pywikibot should now automatically login using your bot password:
- Run
Logging in to meta:meta as Valhallasw@my-botpassword-name Logged in on meta:meta as Valhallasw.
password_file entries format
The entries in user-password.py
should be tuples with 2, 3, or 4 items:
('Username', BotPassword('BotPasswordName', 'Password'))
('FamilyName', 'Username', BotPassword('BotPasswordName', 'Password'))
- Used when the entry should only be used on a specific
FamilyName
, e.g.wikipedia
orwikisource
.
- Used when the entry should only be used on a specific
('SiteCode', 'FamilyName', 'Username', BotPassword('BotName', 'Password'))
- Used when the entry should only be used on a specific
FamilyName
andSiteCode
, e.g.wikipedia
anden
.
- Used when the entry should only be used on a specific
Entries that come later override those that come before them. For example if the password file contains:
Then the BotPassword entry will be used for https://en.wikipedia.org/.
('Username', 'AccountPassword')
('en', 'wikipedia', 'Username', BotPassword('BotName', 'Password'))