Skip to content

Commit 3a9b8eb

Browse files
Joffcomimchairmanm
andauthored
Add information for Slack signing secret (#3436)
Co-authored-by: Justin Ellingwood <[email protected]>
1 parent 51bd634 commit 3a9b8eb

File tree

3 files changed

+17
-4
lines changed

3 files changed

+17
-4
lines changed

.prettierignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
**/*.md

docs/integrations/builtin/credentials/slack.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,10 @@ Refer to the Slack API [Quickstart](https://api.slack.com/quickstart) for more i
5252

5353
To use your Slack app with the [Slack Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.slacktrigger.md) node:
5454

55-
1. Go to **Features** > **Event Subscriptions**.
56-
2. Turn on the **Enable Events** control.
57-
3. In n8n, copy the **Webhook URL** and enter it as the **Request URL** in your Slack app.
55+
1. Go to [Your Apps](https://api.slack.com/apps/) in Slack and select the app you want to use.
56+
2. Go to **Features** > **Event Subscriptions**.
57+
3. Turn on the **Enable Events** control.
58+
4. In n8n, copy the **Webhook URL** and enter it as the **Request URL** in your Slack app.
5859

5960
/// note | Request URL
6061
Slack only allows one request URL per app. If you want to test your workflow, you'll need to do one of the following:
@@ -63,11 +64,18 @@ To use your Slack app with the [Slack Trigger](/integrations/builtin/trigger-nod
6364
- Use the **Production URL** with execution logging.
6465
///
6566

66-
4. Once verified, select the bot events to subscribe to. Use the **Trigger on** field in n8n to filter these requests.
67+
5. Once verified, select the bot events to subscribe to. Use the **Trigger on** field in n8n to filter these requests.
6768
- To use an event not in the list, add it as a bot event and select **Any Event** in the n8n node.
6869

6970
Refer to [Quickstart | Configuring the app for event listening](https://api.slack.com/quickstart#listening) for more information.
7071

72+
n8n recommends enabling request signature verification for your Slack Trigger for additional security:
73+
74+
1. Go to [Your Apps](https://api.slack.com/apps/) in Slack and select the app you want to use.
75+
2. Go to **Settings** > **Basic Information**.
76+
3. Copy the value of **Signing**.
77+
4. In n8n, Paste this value into the **Signature Secret** field for the credential.
78+
7179
## Using OAuth2
7280

7381
--8<-- "_snippets/integrations/builtin/credentials/cloud-oauth-button.md"

docs/integrations/builtin/trigger-nodes/n8n-nodes-base.slacktrigger.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,10 @@ You must add the appropriate scopes to your Slack app for this trigger node to w
6969

7070
The node requires scopes for the [conversations.list](https://api.slack.com/methods/conversations.list) and [users.list](https://api.slack.com/methods/users.list) methods at minimum. Check out the [Scopes | Slack credentials](/integrations/builtin/credentials/slack.md#scopes) list for a more complete list of scopes.
7171

72+
## Verify the webhook
73+
74+
From [version `1.106.0`](/release-notes.md#n8n11060), you can set a [Slack Signing Secret](https://api.slack.com/authentication/verifying-requests-from-slack#signing_secrets_admin_page) when configuring your [Slack credentials](/integrations/builtin/credentials/slack.md#slack-trigger-configuration). When set, the Slack trigger node automatically verifies that requests are from Slack and include a trusted signature. n8n recommends setting this to ensure you only process requests sent from Slack.
75+
7276
## Common issues
7377

7478
Here are some common errors and issues with the Slack Trigger node and steps to resolve or troubleshoot them.

0 commit comments

Comments
 (0)