RomanNum3ral
/
Sn1per
mirror of https://github.com/1N3/Sn1per.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updating new Slack notification requirements as of Sn1per v8.7

xer0dayz 2020-09-13 08:58:50 -07:00
parent b7480d33f3
commit 5947c3e3f4
1 changed files with 25 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
Slack-API-Integration.md

@ -1,8 +1,28 @@
To integrate Slack API notifications into Sn1per, edit your /root/.sniper.conf file and enter the appropriate values for the following:
### Create your Slack app
To integrate Slack API notifications into Sn1per, you will need to create a new Slack application for notifications here: [https://api.slack.com/start](https://api.slack.com/start).
1. Give the new app a name (ie. _Sn1per Notifications_) and select a workspace to add your app to.
2. Click the "**Add features and functionality**" > "**Incoming Webhooks**" link.
3. Click the radio button to "**Activate Incoming Webhooks**" and copy the full webhook URL.
4. Append the value into your ```/root/.sniper_api_keys.conf``` file (ie. _SLACK_WEBHOOK_URL="https://hooks.slack.com/services/T*ff7kL/BG9fdf9*/wddf93jvjffddjf893o_").
5. Click the "**OAuth & Permissions**" link and click the "**Add an OAuth Scope**" under the "**Scopes**" section and add the "**files:write**" permission
6. Copy the "**Bot User OAuth Access Token**" value to your ```/root/.sniper_api_keys.conf``` file (ie. _SLACK_API_TOKEN="xoxp-2dfefedf-f3554vf-123455353434-232355defdfff3f3f3f33g3g3_").
7. Click the "Basic Information" link, then click the "Install your app to your workspace" link.
### Updating your Sn1per API keys
After your Slack app has been setup, edit your ```/root/.sniper_api_keys.conf``` file and enter the appropriate values for the following:
```
SLACK_API_TOKEN="xoxp-2dfefedf-f3554vf-123455353434-232355defdfff3f3f3f33g3g3"
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/T*ff7kL/BG9fdf9*/wddf93jvjffddjf893o"
SLACK_CHANNEL="sn1per-professional"
```
Update your ```/root/.sniper.conf``` file with the following values:
```
# SLACK API
SLACK_API_KEY="_______YOUR_KEY_HERE______"
SLACK_NOTIFICATIONS="1"
SLACK_NOTIFICATIONS_THEHARVESTER="1"
SLACK_NOTIFICATIONS_EMAIL_SECURITY="1"
@ -22,9 +42,6 @@ SLACK_NOTIFICATIONS_METAGOOFIL="1"
SLACK_NOTIFICATIONS_ARACHNI_SCAN="1"
```
If you don't already have a Slack API key, you can generate one here:
https://api.slack.com/custom-integrations/legacy-tokens
After that's done, all you need to is run your Sn1per scans as normal to start receiving command output via your custom Slack channel.
You will also need to create a Slack account and channel to send your notifications to. The default channel is 'sn1per-professional', but you can update this by editing the 'SLACK_CHANNEL' variable in your /usr/share/sniper/bin/slack.sh file.
After that's done, all you need to is run your Sn1per scans as normal to start receiving command output via your custom Slack channel.
**NOTE:** Slack legacy tokens are deprecated and must be updated as of Sn1per v8.7 to Slack application notifications.