Add Telegram alerting

[zufardhiyaulhaq]

Summary

• Add telegram alerting with markdown templating (issue [FEATURE] Telegram notification alerts #36)
• not support silent mode

Proposed changes

This PR fixes/implements the following bugs/features:

• Add telegram alerting

How has this been tested?

configuring teler.yaml using telegram alert provider

Proof:

example logging in telegram

######################
Warning: teler Alert
######################

 Crawler

Request:  / HTTP/1.1
Date:  +0700
IP Address: ::1
User Agent: curl/7.47.0
Referrer: -
Status code: 200
Bytes sent: 5

######################
Warning: teler Alert
######################

 Bruteforce

Request:  /_private HTTP/1.1
Date:  +0700
IP Address: 127.0.0.1
User Agent:  (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/28.0.1468.0 Safari/537.36
Referrer: -
Status code: 404
Bytes sent: 580

######################
Warning: teler Alert
######################

 Web Attack: Detects JavaScript location/document property access and window access obfuscation

Request:  /?_=1%20AND%20%28SELECT%202000%20FROM%28SELECT%20COUNT%28%2A%29%2CCONCAT%280x716b786b71%2C%28SELECT%20%28ELT%282000%3D2000%2C1%29%29%29%2C0x716a707871%2CFLOOR%28RAND%280%29%2A2%29%29x%20FROM%20INFORMATION_SCHEMA.PLUGINS%20GROUP%20BY%20x%29a%29 HTTP/1.1
Date:  +0700
IP Address: ::1
User Agent:  (http://sqlmap.org)
Referrer: -
Status code: 200
Bytes sent: 160

Closing issues

Fixes #36

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
  • I have updated the documentation accordingly.
• I have followed the guidelines in our CONTRIBUTING.md document.
• I have written new tests for my changes.
  • My changes successfully ran and pass tests locally.

[kitabisa-bot]

Please consider taking a moment for us to review this pull request.

[dwisiswant0]

Can you please provide a screenshot attachment of Telegram alert, @zufardhiyaulhaq?

[zufardhiyaulhaq]

@dwisiswant0 give you the screenshot

[dwisiswant0]

It looks like the first word of threat category got trimmed, e.g. Bad Crawler, Common Web Attack.

[zufardhiyaulhaq]

let me check, that is weird since the markdown generated from the template is normal.

\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#
*Warning: teler Alert*
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#

```Bad Crawler```

*Request*: ```GET / HTTP/1.1```
*Date*: ```28/Oct/2020:08:23:43 +0700```
*IP Address*: ```127.0.0.1```
*User Agent*: ```check_http/v2.1.2 (monitoring-plugins 2.1.2)```
*Referrer*: ```-```
*Status code*: ```200```
*Bytes sent*: ```5```

[zufardhiyaulhaq]

@dwisiswant0 this is done.

[dwisiswant0]

Hi @zufardhiyaulhaq,
After reviewing, I still need some revisions of this.

Please note that we provide the parse_mode option in the configuration file because we have to provide some formatting options for the user. If I see; you only provide MarkdownV2 when referring to currently templates you created, but not for Markdown and HTML.

References:

• https://core.telegram.org/bots/api#formatting-options

[kitabisa-bot]

We thank reviewers for the constructive comments on this pull request.
Where appropriate, we believe the additional analyses discussed and/or suggested above have helped us to substantially improve to teler development.

[dwisiswant0]

/assign @zufardhiyaulhaq

[zufardhiyaulhaq]

@dwisiswant0 I am aware that we can use MarkdownV2 or HTML, but why in the first place we can make user can customize this? since we manage the template and I believe it is not necessary for the user to select HTML or MarkdownV2 if the user cannot customize the template from the first place.

[dwisiswant0]

What I mean is, when the user choose HTML; the template format we'll use is to generate a message using table fields, since the Markdown(V2) style doesn't support generating tables for messages on Telegram.

I'm going to change the base branch to development, as I will refactor configuration requirements and so on from this. You makes a good point, @zufardhiyaulhaq!

Thanks for your contributions! Approving now.

[kitabisa-bot]

Accepted! Thanks for your patience & contributions, wait to be merged.

[dwisiswant0]

@all-contributors please add @zufardhiyaulhaq for code.

[allcontributors]

@dwisiswant0

I've put up a pull request to add @zufardhiyaulhaq! 🎉