Prerequisites

Before integrating Slack with Secret Server, ensure the following requirements are met:

Secret Server Prerequisites

  • Your Secret Server user account has admin permissions.

If you are using Secret Server On-Premises, ensure that the following additional prerequisites are met:

  • Secret Server is properly installed and configured in your environment.

  • Secret Server version 11.6 or later.

  • Set up a human-friendly URL for your Secret Server instance to help users easily identify it when accessing it from Slack.

  • An external domain name with DNS and routing is configured and points to your Secret Server instance. This is necessary to enable the Slack integration to communicate with your Secret Server over the Internet.

Slack Prerequisites

  • You have configured a workspace for your company in Slack.

  • You are a Workspace Owner (or a regular workspace member on Enterprise Grid) of your company's Slack workspace, with permissions to approve the app installation when prompted during configuration.

If your organization uses Enterprise Grid or Business+ plans, the Slack app must be installed by a regular workspace owner or member account. Never use a Slack Org Admin or Secret Server cloudadmin account; installing with an admin account can cause Event Subscriptions to fail silently. See the Enterprise Grid column on the table in the Configuration section.

For more information about Slack roles, see Types of Roles in Slack.

Network Prerequisites

Enterprise environments often have additional firewalls, proxies, or network security appliances. Confirm that Slack’s servers can reach your Secret Server instance at the following endpoints:

  • https://<Secret Server instance>/api/v1/slack/interaction

  • https://<Secret Server instance>/api/v1/slack/event

Always use the endpoint paths shown above. Do not use /Slack/EventReceiver or /Slack/Command; these are not valid Secret Server endpoints and will cause the integration to fail.