No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2023-07-26 20:56:56 -04:00
.github/workflows Create codeql.yml (#2) 2022-12-19 13:11:51 -05:00
images Add files via upload 2019-03-23 09:49:58 -04:00
pwned_bot.py Update pwned_bot.py 2023-07-26 20:56:56 -04:00
README.md Update README.md 2023-07-26 20:54:42 -04:00
requirements.txt deleted: Procfile 2023-07-27 00:49:01 +00:00

Python 3.7 CodeQL Quality Gate Status Security Rating

pwnedBot

A Discord bot implementation of Troy Hunt's haveibeenpwned.com service,
a free resource for anyone to quickly assess if they may have been put
at risk due to an online account of their's having been compromised or
"pwned" in a data breach, using the hibpwned python library.

Prerequisites

Head over to DiscordApp and create a new app.
Record your Client_ID. On the left, click Bot, and then Add Bot.
Once you are done setting up your bot, save your Client_ID, Token, and Client Secret in a safe place.

Making calls to the haveibeenpwned API requires a key. You can purchase a HIBP-API-KEY here.

Deployment (Tested with Python 3.7, 3.8+ May be borked)

git clone https://github.com/0xgingi/pwnedBot
cd pwnedBot
pip install -r requirements.txt

Create a .env file

HIBP_API_KEY=<your HIBP-API-KEY>
APP_NAME=<a unique app name for haveibeenpwned to recognize your app/bot>
DISCORD_TOKEN=<your discord bot TOKEN>
DISCORD_CLIENT_ID=<your discord CLIENT_ID>
BOT_PREFIX=<a prefix for your bot commands>
python pwned_bot.py

Usage

To add bot to server add your Client_ID to this URL and visit in browser:
https://discordapp.com/oauth2/authorize?client_id= <Client_ID> &scope=bot
When bot is active in server type "(prefix)help" for a list of commands.

HELP BREACH_NAME PASSWORD SEARCH PASTES PASTE_ID

License

All data sourced from https://haveibeenpwned.com
Visit https://haveibeenpwned.com/API/v3 to read the Acceptable Use Policy
for rules regarding acceptable usage of this API.

This work is licensed under a Creative Commons Attribution 4.0 International License.
CCv4