https://github.com/peass-ng/botpeass

Use this bot to monitor new CVEs containing defined keywords and send alerts to Slack and/or Telegram.
https://github.com/peass-ng/botpeass

bot cve cves monitoring peass privesc slack telegram

Last synced: 1 day ago
JSON representation

Use this bot to monitor new CVEs containing defined keywords and send alerts to Slack and/or Telegram.

• Host: GitHub
• URL: https://github.com/peass-ng/botpeass
• Owner: peass-ng
• License: apache-2.0
• Created: 2021-05-07T11:30:39.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T08:20:26.000Z (about 2 months ago)
• Last Synced: 2024-10-29T09:41:08.877Z (about 2 months ago)
• Topics: bot, cve, cves, monitoring, peass, privesc, slack, telegram
• Language: Python
• Homepage:
• Size: 1.08 MB
• Stars: 224
• Watchers: 10
• Forks: 117
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# BotPEASS

![](https://github.com/carlospolop/BotPEASS/raw/main/images/botpeas.png)

Use this bot to monitor new CVEs containing defined keywords and send alerts to Slack and/or Telegram.

## See it in action

Join the telegram group **[peass](https://t.me/peass)** to see the bot in action and be up to date with the latest privilege escalation vulnerabilities.

## Configure one for yourself

**Configuring your own BotPEASS** that notifies you about the new CVEs containing specific keywords is very easy!

- Fork this repo

- Modify the file `config/botpeas.yaml` and set your own keywords

- In the **github secrets** of your forked repo enter the following API keys:

    - **VULNERS_API_KEY**: (Optional) This is used to find publicly available exploits. You can use a Free API Key.

    - **SLACK_WEBHOOK**: (Optional) Set the slack webhook to send messages to your slack group

    - **DISCORD_WEBHOOK_URL**: (Optional) Set the discord webhook to send messages to your discord channel

    - **TELEGRAM_BOT_TOKEN** and **TELEGRAM_CHAT_ID**: (Optional) Your Telegram bot token and the chat_id to send the messages to

    - **PUSHOVER_DEVICE_NAME PUSHOVER_USER_KEY PUSHOVER_TOKEN**: (Optional) Set your key and token to receive pushover notifications.

    - **NTFY_URL**: (Optional) Set the URL to send the notifications to ntfy server.

    - **NTFY_TOPIC**: (Optional) Set the topic to send the notifications to ntfy server.

    - **NTFY_AUTH**: (Optional) Set the auth token for the ntfy server.

- Check `.github/wordflows/botpeas.yaml` and configure the cron (*once every 8 hours by default*)

*Note that the slack, telegram, discord and ntfy.sh configurations are optional, but if you don't set any of them you won't receive any notifications anywhere*