HOWTO: Connect to Slack

Webhooks let you connect two tools to notify users, trigger automated workflows, or audit certain events. They can alert you via Slack when new vulnerabilities are detected, a noncompliant package is discovered, and when other package-related events occur.

In this page, we show you how to connect ProGet to Slack and sample payload messages to copy/paste into your own webhook.

Step 1: Create a Webhook in Slack

To connect to Slack, start by following this Slack tutorial to create your incoming webhook application inside Slack. Slack now recommends this as the best way to add webhooks (instead of the previously recommended third-party app called Incoming Webhooks).

Once you've created your Incoming Webhook application in Slack, you can optionally change the notification colors and the app's icon.

Note that to edit the webhook again, you must go to "Your Apps" inside Slack, rather than from the channel where the webhook posts.

Step 2: Create a Webhook in ProGet

In your ProGet instance, navigate to "Manage Feed" in a feed, click the "Webhooks" tab, and click "create." Note that you can create a webhook at the feed or at global level.

From here enter your Slack URL, and then select "Save"

Step 3: (Optional) Test your Webhook

The payload can be tedious to configure, so you can test it by copy/pasting this sample Slack payload we created:

{"text": "*feed:* $FeedName, *package:* $PackageId, *version:* $PackageVersion, *hash:* $PackageHash, *packageType:* $FeedType, *event:* $WebhookEvent, *user:* $UserName"}

After you've saved your webhook, take the configured action in ProGet, and your Slack should receive a notification from ProGet!

Additional Notes

You can create webhooks from the individual feed pages or by navigating to "Administration" > "Webhooks" under "Global Components" and then selecting "Create Webhook". Creating a global webhook requires selecting "(all feeds)," but for Docker feeds, you will not be able to select this due to different Docker URLs.