Skip to Content
GuidesSlack Setup

Slack Setup

This guide walks you through installing the Relynt Slack app in your workspace and configuring approval channels for your organization.

Prerequisites

  • A Relynt account with Owner or Admin role
  • A Slack workspace where you can install apps
  • A Slack channel for approval messages

Install the Relynt Slack app

  1. In the Relynt dashboard, navigate to Settings → Onboarding
  2. Click Install Slack App
  3. You’ll be redirected to Slack’s OAuth consent screen
  4. Select your workspace and authorize the Relynt app
  5. After authorization, you’ll be redirected back to the dashboard

Configure the approval channel

  1. In Settings → Onboarding, select the Slack channel where approval messages should be posted
  2. The Relynt app must be invited to this channel — the dashboard will prompt you if it isn’t
  3. Save your channel selection

Choose a channel that your security or ops team monitors actively. Approval messages need timely responses to avoid blocking agent operations.

Test the integration

  1. Navigate to Settings → Onboarding and click Test Slack Configuration
  2. A test message will be posted to your configured channel
  3. Verify the message appears and the buttons are interactive

Create approval-required policies

Create a policy rule that requires approval:

{
  "action": "update_deal",
  "resource_pattern": "crm:deal:*",
  "decision": "require_approval",
  "risk_level": "high"
}

When an agent triggers this rule, an approval message will be posted to your configured channel.

Approval message anatomy

Each Slack approval message contains:

SectionContent
HeaderAgent name, action, and resource
Risk levelColor-coded badge (low/medium/high)
Payload diffKey fields from the request payload
ReasonWhy the policy triggered approval
ButtonsApprove and Deny interactive buttons

Security considerations

Relynt verifies the Slack signing secret on every interactive callback. Never share your Slack signing secret or store it in client-side code.

  • Every Slack callback is verified using HMAC-SHA256 with the Slack signing secret
  • Approval buttons can only be clicked once — duplicate clicks are rejected
  • The Slack user who clicks a button is recorded as the approver in the receipt
  • Approval messages are scoped to the organization via the approval_id

Troubleshooting

IssueSolution
Messages not appearingEnsure the Relynt app is invited to the channel
Buttons not workingCheck that the Slack app’s interactivity URL is configured correctly
”Invalid signature” errorsVerify the Slack signing secret in your Relynt settings
Test message failsConfirm the channel exists and the app has chat:write permission
Last updated on
PythonCredential Rotation