> For the complete documentation index, see [llms.txt](https://gerobug.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gerobug.gitbook.io/documentation/settings.md).

# Settings

**The setting page is only accessible by admin.**

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FADER2nVgntZustbmHmkJ%2FScreen%20Shot%202023-05-17%20at%203.33.06%20PM.png?alt=media&amp;token=f549b98d-239a-4846-af58-fd3501165042" alt=""><figcaption><p>Admin Setting Page</p></figcaption></figure>

## Mailbox Settings

Gerobug need a GMAIL Email with [App Password](https://support.google.com/accounts/answer/185833?hl=en) implemented. Without this, Gerobug can not receive any reports submitted by the bug hunter. It is **RECOMMENDED** to use a **dedicated email** for this. Do not use the mailbox email for other purposes to avoid issues / conflicts during the parsing process.

<div align="left"><figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FqIJNi9PhnTCqk8Pf2wtl%2FScreenshot%202024-04-14%20at%2002.44.41.png?alt=media&amp;token=8fc175c4-601a-48f4-9ea1-8db29c0400ea" alt=""><figcaption><p>Sample Configured Mailbox</p></figcaption></figure></div>

If the email is configured successfully, you will see that the email is **ACTIVE**, and Gerobug will able to receive bug reports and send emails.

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FoWoOTWrFegQp7vM514aL%2FScreenshot%202024-04-14%20at%2002.46.01.png?alt=media&amp;token=d8f24c4b-a045-4df6-98e8-d1cbe4960510" alt=""><figcaption><p>Submission Guideline Page will be Updated Automatically</p></figcaption></figure>

## User Account Settings

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FHKe7QjbaAPEQTR8DuUY6%2FScreen%20Shot%202023-05-17%20at%203.41.58%20PM.png?alt=media&amp;token=53a9e04d-9b8e-4ceb-ba3a-2c7df2e313cd" alt=""><figcaption><p>User Account Setting</p></figcaption></figure>

You can change user email and password from this setting.

## Personalization

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FUwiPx9eYXzNpk7bPpJB7%2FScreenshot%202024-04-14%20at%2002.47.04.png?alt=media&amp;token=5999dc26-e104-4e50-9888-bacee77ca227" alt=""><figcaption><p>Personalization Setting</p></figcaption></figure>

You can change the Gerobug logo to your own company/organization logo&#x20;

(Will affect the homepage and certificate generated)

## Edit Rules and Guidelines

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FaImzhg9dfgsjKonyJGuO%2FScreen%20Shot%202023-05-17%20at%203.47.57%20PM.png?alt=media&amp;token=ffd5388b-7ed4-4a16-ab6f-63d26f32a950" alt=""><figcaption><p>Edit Rules and Guidelines</p></figcaption></figure>

You can change the rules and guidelines for your bug bounty program.

## Manage Roles

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FGn1TP4J6mnU3gC6ct87x%2FScreen%20Shot%202023-05-17%20at%203.50.41%20PM.png?alt=media&amp;token=6b5c3d4b-16da-46e6-a610-81b8f1eb1ed7" alt=""><figcaption><p>Manage Roles</p></figcaption></figure>

Admin can create and delete users with lesser privilege (Reviewer). These users can be used to manage bug reports (Review and Triage) without having the permission to access the setting page.

The default password for the reviewer users are <mark style="color:red;">`G3r0bUg_@dM!n_1337yipPie13579246810121337`</mark>&#x20;

Each users can reset the password using the forgot password feature.&#x20;

{% hint style="info" %}
Please enforce the users to change the default password to minimize security risks!
{% endhint %}

## Notification Channels

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2F2CcU5dvChy1txsTvtBNl%2FScreen%20Shot%202023-05-17%20at%203.55.54%20PM.png?alt=media&amp;token=120875d4-0499-4d9a-9f17-e5a6fb1d577f" alt=""><figcaption><p>Notification Channels</p></figcaption></figure>

Gerobug support Slack and Telegram as notification channels, which Gerobug will send notification when there are new reports.

### [Slack Webhook](https://api.slack.com/messaging/webhooks)

Format: <https://hooks.slack.com/services/><mark style="color:orange;">T00000000</mark>/<mark style="color:orange;">B00000000</mark>/<mark style="color:orange;">XXXXXXXXXXXXXXXXXXXXXXXX</mark>

![](https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2F6E3Al8G4jcbjf6jc2fk4%2FScreen%20Shot%202023-05-17%20at%204.07.31%20PM.png?alt=media\&token=6d4f78d8-e0d7-4e44-9c8b-3a48c45ce917)

### [Telegram Webhook](https://core.telegram.org/bots)

Format: <https://api.telegram.org/bot><mark style="color:blue;">\<token></mark>/sendMessage?chat\_id=<mark style="color:blue;">\<channel\_id></mark>

![](https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FhgXcbeVX7FUwUXTwgh4H%2FScreen%20Shot%202023-05-17%20at%204.08.36%20PM.png?alt=media\&token=8455dc63-1526-4109-95c2-d92b0d6f83e3)

## Blacklist Rule

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FIGDYKU49Mcn0pp4h0aeP%2FScreen%20Shot%202023-05-17%20at%204.14.00%20PM.png?alt=media&amp;token=50a5dea0-b6bd-4390-a8c9-4391f89180c9" alt=""><figcaption><p>Blacklist Rule Setting</p></figcaption></figure>

Gerobug is equipped with Blacklist Rule (a simple rate limit) to block any email address that conducted Spam.

## Report Template

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FxQNK38th2JweFcDQuRy0%2FScreen%20Shot%202023-05-17%20at%204.16.05%20PM.png?alt=media&amp;token=e486f494-b43e-415f-a78d-bfaa92e4c74a" alt=""><figcaption><p>Report Template Setting</p></figcaption></figure>

You can set report template (PDF) for bug hunters, which they can download at the Rules and Guidelines Page.

## NDA Template

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FopYtzxdYwfbbZGWUG05t%2FScreen%20Shot%202023-05-17%20at%204.16.19%20PM.png?alt=media&amp;token=c673f24a-3d24-432c-a01b-df8281d72df9" alt=""><figcaption><p>NDA Template Setting</p></figcaption></figure>

You can set NDA template (PDF) for bug hunters, which will be sent to bug hunters before the bounty is processed.

## Certificate Template

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FRYANO8EptnGrvdrQGKxN%2FScreen%20Shot%202023-05-17%20at%204.19.38%20PM.png?alt=media&amp;token=0809e0af-1f3a-46f1-8eaa-0602ffc503f5" alt=""><figcaption><p>Certificate Template</p></figcaption></figure>

Gerobug will generate and send certificate of appreciation to bug hunter automatically when a report is fixed and completed.

You can update the certificate template (JPG) to your own design, but we **do not recommend** it since it may broke the generated certificate due to different sizing and positioning.&#x20;

```
Our certificate template
Dimensions: 3508 × 2480
Resolution: 300x300
```

We will produce more certificate template options in the future.

You can also change the data (Officer name, signature, and title) and generate a sample certificate.

<figure><img src="https://85781584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa4mPzYShiyS695uKo1D%2Fuploads%2FF65uwNN1KSslYzhBzemI%2FScreen%20Shot%202023-05-17%20at%204.22.21%20PM.png?alt=media&amp;token=23ae6e48-32c5-4b89-8109-1715a63376c0" alt=""><figcaption><p>Sample Certificate</p></figcaption></figure>