Slack

Send change logs and alerts from the SURF Admin console into a Slack channel using an incoming webhook.

Before you start

Requirement	Detail
Slack access	Permission to create an app in your Slack workspace and install it
SURF access	Administrator on the SURF Admin console

Go to https://api.slack.com/apps
Select Create New App in the top right.
Choose From scratch.
Enter an App Name, pick the workspace to develop it in, and click Create App.
Under Add features and functionality, select Incoming Webhooks.
Set Activate Incoming Webhooks to On.
Select Add New Webhook to Workspace.
Choose the channel the app should post to and click Allow.
Copy the generated webhook URL. You will paste it into SURF.

In SURF Admin, go to Settings → Integrations, select Slack and choose Update Integration.
Paste the webhook URL into the relevant field or fields:

Setting	Purpose
Send change logs to Slack channel	Configuration and policy changes made in the admin console
Send alert logs to Slack channel	Security alerts raised by SURF

Turn on the toggle for each type you want to receive. The two can use different webhook URLs, so change logs and alerts can go to separate channels.
Click Submit and enable the integration.

Use Edit advanced filters in the integration dialog to narrow what reaches Slack. By default all alerts are sent until rules are defined.

Symptom	Check
Nothing arrives in Slack	The integration was submitted but left toggled off, or the toggle for that log type is off
Alerts arrive but change logs do not	Only one of the two webhook URL fields was filled in
Messages post to the wrong channel	The webhook is bound to the channel chosen when it was authorised. Create a second webhook for a different channel.

For anything not covered here, contact the SURF support team.