Notifications

Integrate bifrost in your preferred communication channel to get realtime notifications for alerts on secured services.

Slack

To integrate bifrost with Slack, follow these steps:

1. Create an incoming webhook in Slack:

   • Go to https://api.slack.com/apps and click on “Create New App”.
   • Click on “From an app manifest”.
   • Copy the following manifest and paste it in the text area:

   {
       "display_information": {
           "name": "bifrost alerts",
           "description": "Alerts from bifrost",
           "background_color": "#225364"
       },
       "features": {
           "bot_user": {
               "display_name": "bifrost alerts",
               "always_online": false
           }
       },
       "oauth_config": {
           "scopes": {
               "bot": ["incoming-webhook", "chat:write"]
           }
       },
       "settings": {
           "org_deploy_enabled": false,
           "socket_mode_enabled": false,
           "token_rotation_enabled": false
       }
   }

   • Click on “Install to Workspace”
   • Click on “OAuth & Permissions” and copy the Bot User OAuth Token.
   • Go to Slack and navigate to the channel where you want to add the webhook.
   • Click on the app and select “Add this app to a channel”.

2. Configure bifrost to send alerts to the webhook:

   • Navigate to the bifrost portal.
   • Click on the service you want to configure.
   • Click on the “Integrations” tab.
   • Click on the “Add slack webhook” button.

3. Test the integration:

   • Navigate to the bifrost portal.
   • Click on the service you configured.
   • Click on the “Test provider” button.
   • Check the channel in Slack for the test alert.

Microsoft Teams

To integrate bifrost with Microsoft Teams, follow these steps:

1. Create an incoming webhook in Microsoft Teams:

   • Navigate to the channel where you want to add the webhook and click on the three-dot icon next to the channel name.
   • Select “Manage channel” from the dropdown menu.
   • Click on the “Settings” tab.
   • Open the “Connectors” section.
   • Click on “Edit” to add a new connector.
   • Search for “Incoming Webhook” and click “Add”.
   • Provide a name for the webhook, upload an image to associate with data from the webhook, and click “Create”.
   • Copy the webhook URL provided.

2. Configure bifrost to send alerts to the webhook:

   • Navigate to the bifrost portal.
   • Click on the service you want to configure.
   • Click on the “Integrations” tab.
   • Click on the “Add teams webhook” button.

3. Test the integration:

   • Navigate to the bifrost portal.
   • Click on the service you configured.
   • Click on the “Test provider” button.
   • Check the channel in Microsoft Teams for the test alert.

Generic webhook

Prerequisites

Webhook URL: Ensure you have a valid URL where the webhook notifications will be sent.

Set Up the Webhook

Register the Webhook: In the Bifrost portal, register the webhook with your URL by selecting the service and then selecting the INTEGRATION tab.

Webhook Request Schema

{
    "type": "object",
    "properties": {
        "url": {
            "description": "The URL to view the alert details.",
            "type": "string"
        },
        "count": {
            "description": "The number of alerts.",
            "type": "integer"
        },
        "environments": {
            "description": "The list of environments the alerts occurred in.",
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "service": {
            "description": "The service that triggered the alert.",
            "type": "string"
        },
        "text": {
            "description": "Description of the alert.",
            "type": "string"
        }
    },
    "required": ["url", "count", "environments", "service", "text"]
}

Example Webhook Request

{
    "url": "https://portal.bifrostsec.com/service/72/alert/123",
    "count": 5,
    "environments": ["dev", "prod"],
    "service": "my-service",
    "text": "There has been an alert in dev and prod."
}