plugMicrosoft Teams

The Microsoft Teams integration delivers real-time notifications from Interlynk to your Teams channels via incoming webhooks.


Purpose

  • Receive notifications for vulnerability discoveries, policy violations, license issues, and SBOM uploads in Microsoft Teams channels.

  • Route notifications by severity level.

Webhook Setup

Creating a Teams Incoming Webhook

  1. In Microsoft Teams, navigate to the target channel.

  2. Click the channel name > Manage channel > Connectors (or Apps > search for "Incoming Webhook").

  3. Click Configure on the Incoming Webhook connector.

  4. Enter a name (e.g., "Interlynk Notifications") and optionally upload an icon.

  5. Click Create.

  6. Copy the generated webhook URL.

Configuring in Interlynk

  1. Navigate to Settings > Organization > Integrations.

  2. Click Microsoft Teams.

  3. Click Add New to add a webhook configuration.

  4. Enter:

    • Teams Webhook URL: The incoming webhook URL from your Teams channel.

    • Notification Type: Select the notification level (All, Alert, Warning, or Info).

    • Frequency: Currently supports Instant delivery.

  5. Click Save.

You can add multiple webhook configurations for different channels or notification levels.

Message Types

Teams notifications include the same event categories as other messaging integrations:

Category
Examples

Vulnerabilities

New critical/high vulnerability discovered

Licenses

License compliance violation detected

Policies

Policy scan completed with failures

Uploads

SBOM uploaded and processed

Messages are formatted as adaptive cards or connector cards with:

  • Event summary and severity

  • Affected product and environment

  • Link to the relevant Interlynk dashboard page

Required Permissions

Microsoft Teams

  • Permission to manage connectors/webhooks in the target channel.

Interlynk

Permission
Purpose

view_connections

View Teams integration settings

edit_connections

Add or update Teams webhooks

delete_connections

Remove Teams webhook configurations

Security Notes

  • Webhook URLs are encrypted at rest.

  • Teams webhook URLs are secret — do not share them publicly or commit to source control.

  • If a webhook URL is compromised, delete the connector in Teams and create a new one.

Troubleshooting

Issue
Cause
Resolution

No messages appearing

Invalid or expired webhook URL

Verify the webhook is still active in Teams channel settings

Connector removed

Teams admin deleted the connector

Re-create the incoming webhook in Teams and update the URL

Messages delayed

Teams webhook rate limits

Reduce notification frequency or filter to higher-severity events only

Last updated