Setting up Slack for resource notifications [Technical Preview]

You can enable Slack as a delivery channel to receive resource notifications as Slack messages.

To enable the Slack integration, the Cloudera Notifications application needs to be added to the Slack workspace. After the connection is established between the Notification service and Slack, you can provide the Slack channel ID for the Distribution list to receive the resource notifications as Slack messages.

Integrating the Notification service with Slack🔗

Before enabling Slack for the Distribution lists, you need to ensure that the Cloudera Notifications application can access your Slack workspace.

The Cloudera Notifications application depends on the Cloudera Control Plane region. When searching for the application, the name reflects which region the application is tied to:

Cloudera Notifications - US1
Cloudera Notifications - EU1
Cloudera Notifications - AP1

The Notification service uses OAuth authentication to connect to your Slack workspace. When connecting to Slack, you are asked to grant access to the following actions:

Viewing content and information: This means that the Notification service is able to read basic information about the Slack channel and conversations strictly to verify channel metadata.
Performing actions in channel and conversation: This means that the Notification service is able to send messages to the Slack channel as @cloudera_notification.

Ensure that you have administrative access to the Slack workspace that will be used to integrate with the Notification service. Administrator access is required to install the Cloudera Notifications application on the workspace.

Required role: PowerUser

Click Notifications in Cloudera Management Console.
Select Channel Integrations.
Click Connect to Slack.
You are redirected to the Slack interface to grant access to the Cloudera Notifications application.
Review the scope of the permissions, and ensure you only give permissions to the read and write actions.

important
If you are prompted to grant more permissions for the Cloudera Notifications application than the view and read described above, you should immediately cancel the authentication, and contact Cloudera Support as the Cloudera Notifications application does not require more access than reading general metadata about the channel, and sending messages to the connected channel.
Click Allow.
You are redirected to the Cloudera Management Console, where the connection is established.

note
You can use Disconnect from Slack when you no longer wish to have an integration with Slack.

After the integration between the Notification service and Slack is successful, you can add Slack as a delivery channel for Distribution lists to receive the resource notifications as Slack messages.

Enabling Slack notifications for Distribution lists🔗

After subscribing to a resource notification, you can add Slack as a delivery channel to an existing or newly created Distribution list.

Ensure that you have a Distribution list created.
For more information, see the Creating and managing distribution lists documentation

Required role: NotificationDistributionListAdmin

Select Manage Distribution Lists on the Notifications page.
Click , and select Edit.
Provide the Slack Channel ID on the Distribution List configuration page.
- Public Channel
- Private Channel
Navigate to the Slack interface.

Copy the channel ID of the public Slack channel from the About page.
Before adding a private Slack channel to a Distribution list, you need to ensure that the private Slack channel is integrated with the Cloudera Notifications application.

Navigate to the private Slack channel on the Slack interface.

Click on the name of the private Slack channel.

Select Integrations.

Click Add app.

Search for Cloudera Notifications.

Click Add.
Cloudera Notifications is added as an app.

warning
If you do not add the Cloudera Notifications application to the private Slack channel before adding the Slack channel to the Distribution list, the configuration will fail with an error as the integration is not present in the Slack channel.

Copy the channel ID of the private Slack channel from the About page.
Click Add.
Select Slack under Delivery to for the resource notification.
Click Save.

note
You can add more people to the Slack channel that need to receive the resource notifications as Slack messages.

Setting up Slack for resource notifications [Technical Preview]

Integrating the Notification service with Slack🔗

Enabling Slack notifications for Distribution lists🔗

We want your opinion

How can we improve this page?