From 5947c3e3f4d8683b0ec6d032875fb232cb7c4b6a Mon Sep 17 00:00:00 2001 From: xer0dayz <1N3@hushmail.com> Date: Sun, 13 Sep 2020 08:58:50 -0700 Subject: [PATCH] Updating new Slack notification requirements as of Sn1per v8.7 --- Slack-API-Integration.md | 33 +++++++++++++++++++++++++-------- 1 file changed, 25 insertions(+), 8 deletions(-) diff --git a/Slack-API-Integration.md b/Slack-API-Integration.md index ce9b0c2..b49df57 100644 --- a/Slack-API-Integration.md +++ b/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. \ No newline at end of file +**NOTE:** Slack legacy tokens are deprecated and must be updated as of Sn1per v8.7 to Slack application notifications. \ No newline at end of file