BugBase Documentation
  • 👋Welcome to BugBase Docs
  • Overview
    • 💡What we do
    • ⚡Changelogs
    • ✨Our Features
    • 📂Programs at BugBase
      • Vulnerability Disclosure Program (VDP)
      • Bug Bounty Program
      • Private Bounty Program
      • Pentest Program (VAPT)
  • Report Lifecycle
    • Bug Report
    • Report Status
  • How To
    • 👨‍💻Invite Organization Members to BugBase (RBAC)
    • 🚩Setup a Campaign for better program engagement
    • 🐛Submit a Bug Report on BugBase
    • 📑Create a Bug Bounty Program on BugBase
    • ⬇️Download the mobile app
  • Company Guide
    • 👨‍💼Create a Company Account
    • 🧭Navigation
    • 🛡️Assets Dashboard
    • 🗝️Credential Vaults
      • Creating a Credential Vault
      • Adding Credentials to Vault
      • Connect Credential Vault to an Asset
      • Require Whitelisting for a Credential
    • 🔐VPN Servers
      • Create, Configure and Deploy VPN server
      • Monitor Live Statistics and Logs
    • 🗂️Programs Dashboard
      • ⛳Create a Program
    • 📢Customer Support
    • 💵Bounty Bin
    • ⚙️Company Settings
      • 👨‍🏫Profile
      • 🏢Organisation
      • 👨‍🏭Roles and Permissions
      • 🔐Security & Authentication
        • Multi-Factor Authentication
        • SSO with SAML
          • Okta SSO setup via SAML
          • Google SSO setup via SAML
      • 🎨Customization
        • Automations
        • Report Tags
      • 📙Manage Access
    • 📈Insights Dashboard
    • 🔊Campaigns
    • 💲Understanding Currencies Used in BugBase
    • 🤝Whitelist
  • Program guide
    • Bug Bounty Dashboard
      • Program Reports Section
        • Report Components
        • Report Actions
        • Duplicating Reports
        • Assigning Swags
        • Assigning Bounties
        • Assigning Thanks to Reporters
        • Assigning Bonus Bounty
        • Automatic Response Generator using ChatGPT
      • Program Policy
        • Editing Program Policy
          • Best Practices For Designing Policy
          • Best Practices For Bounty Tables
      • Payouts
      • Settings
    • Private Bug Bounty Dashboard
      • Invite Hackers
      • Manage Credentials
    • VDP Dashboard
    • Pentest Dashboard
      • Pentest Overview
      • Vulnerabilities Section
        • Pentest Report Components
        • Pentest Report Actions
      • Global Pentest Chat
    • Competition Dashboard
      • Dashboard
      • Creating a Competition
        • Adding Challenges
      • Manage Competitions
        • Statistics
        • Leaderboard
        • Manage Users
  • Bounty Hunter Guide
    • Bounty Hunter Dashboard
    • Bounty Hunter Profile
    • Programs Directory
      • Program Policy Page
      • Credentials
      • VPN Access
      • Whitelist
      • Collaborate
    • Bounty Hunter Reports Section
      • Submitting Reports
      • Interaction with Program Representees
      • Collaboration
      • Response Generation through ChatGPT on Report Chat
    • Competitions
    • Discord Community
    • Leaderboard
    • Multi-Factor Authentication
    • Settings
      • Verify KYC
    • Email Alias
    • 🚀Apollo Community
  • Integrations
    • 🔗Supported Integrations
    • Webhooks
    • JIRA
      • Creating a JIRA Issue
    • Slack
      • Managing Integration
    • Microsoft Teams
    • Github
    • Asana
    • Sumo Logic
    • PagerDuty
  • on-premise
    • Running Automated Testing
    • Sandbox Environment
Powered by GitBook
On this page
  • Discord Notifications with Webhooks
  • Creating a Webhook - Discord
  • Adding the Discord Webhook in BugBase
  • List of triggers for your webhooks:

Was this helpful?

  1. Integrations

Webhooks

Webhooks are Trigger based, notifications will be sent when a particular event occurs

PreviousSupported IntegrationsNextJIRA

Last updated 8 months ago

Was this helpful?

To show the workings of webhooks, we'll try and integrate webhooks with Discord

Discord Notifications with Webhooks

Pre-requisites

  • A Discord Server with access to create Webhook URLs

  • BugBase Company Account with an Active Program

Helpful Links

Creating a Webhook - Discord

Before starting the setup, ensure you are logged into your Discord Account and have alteast 1 channel in your Discord server.

For this example we will use the #bugbase-webhook channel.

  1. Click on the settings for the channel, navigate to the integrations tab and click on add a new webhook channel > settings > integrations > create webhook

  2. Once you click on Create Webhook a page will open asking you to enter a name for the webhook and choose a channel. Enter a name for the webhook and select the #bugbase-webhook channel.

  1. Click on the Save Changes button and copy the webhook URL. The webhook URL will look something like this: https://discord.com/api/webhooks/123456789/abcdefghijklmnopqrstuvwxyz

Adding the Discord Webhook in BugBase

  1. Navigate to the integrations tab located in the settings page of your BugBase Program.

  2. Click on the Add button on the Webhooks Integration Card.

  3. A modal will appear in which you will need to enter the Webhook URL, params, headers, triggers and the body.

  1. Enter your Webhook URL and choose the method as POST. The params and headers are optional.

Discord provides it's Webhook execution documentation, refer the embed below

  1. You can select multiple triggers for your webhook. The list of all available triggers are given below:

List of triggers for your webhooks:

For Reports

  • New Report is Submitted

  • Report is Triaged

  • Report priority is changed

  • New message sent in report chat

  • Reward is assigned to the Report

  • Report is marked as Duplicate

  • Report is marked as Invalid

  • Report is marked as Resolved

  • Report is marked as Informational

  • Report is Closed

For Vulnerabilities

  • New Vulnerability is Reported

  • Vulnerability is marked as Resolved

  • Vulnerability is marked as Ignored

  • Vulnerability is marked as Unresolved

  • Vulnerability is Retested

In this example we would be using the New Report is Submitted trigger so that whenever a new report is submitted we will send a message to the Discord channel.

  1. For the body of this webhook we will use the following template:

{
  "content": "Hey! Please check your dashboard",
  "username": "BugBase Webhook"
}

Alternatively, discord also supports embeds

{
  "username": "BugBase Webhook",
  "embeds": [
    {
      "description": "Please check BugBase dashboard",
      "title": "A new bug reported!"
    }
  ]
}
  1. Click on the Save / Update button. This will set the webhook up in BugBase.

  2. You can enable/disable the webhook as per your need.

Now the Webhook will send a message on Discord whenever a new report is submitted.

Preview of the Webhook

Simple Message

Embed

Create a new channel (or you can use an existing one) in your Discord server.

Congratulations! You've successfully integrated a Webhook with your BugBase Program

🎉
👨‍💼Create a Company Account
📂Programs at BugBase
How do I create a server?Discord
Logo
Discord Developer Portal — API Docs for Bots and DevelopersDiscord Developer Portal
Logo
Popup
Embed