Microsoft Teams¶

ASAB IRIS can send notifications to Microsoft Teams by using a Teams webhook URL.

Use Microsoft Teams when LogMan.io notifications should appear in a Teams channel, for example for operational alerts, incident updates, or monitoring messages.

IRIS renders the configured template and sends the rendered message to Microsoft Teams as an Adaptive Card.

Prerequisites¶

Before configuring Microsoft Teams, make sure that:

access to the Microsoft Teams team and channel where notifications will be sent is available
permission to create or configure a Teams webhook for that channel is available
the Teams webhook URL is available
the LogMan.io server can reach the webhook URL over HTTPS
a secure place is available for storing the webhook URL if the deployment treats it as a secret

Required configuration fields¶

Field	Description
`webhook_url`	Microsoft Teams webhook URL.

Configuration sample¶

Edit model.yaml to configure the asab-iris service:

/Site/model.yaml

define:
  type: rc/model

services:
  asab-iris:
    instances:
      - node1
    asab:
      config:
        msteams:
          webhook_url: "{{MSTEAMS_WEBHOOK_URL}}"

Microsoft Teams setup¶

Open Microsoft Teams.
Go to the team and channel where IRIS should send notifications.
Create the approved webhook endpoint for the channel. Depending on the tenant policy, this can be an Incoming Webhook connector or a Teams workflow that receives webhook requests.
Copy the generated webhook URL.
Store the webhook URL in Vault or in the deployment secret store used by the LogMan.io installation.
Update /Site/model.yaml.
Apply the model from the Library, or run the deployment apply command used by the installation.
Send a test Microsoft Teams notification.

Note

The exact location of webhook settings depends on the Microsoft Teams tenant policy and channel configuration. Microsoft is moving Microsoft 365 connector scenarios toward Teams Workflows. If Incoming Webhooks are not available, ask the Microsoft 365 administrator to provide an approved Teams workflow webhook URL.

Verify the configuration¶

The configuration is ready when:

ASAB IRIS starts without Microsoft Teams configuration errors
the webhook URL belongs to the expected Teams channel or workflow
a test notification appears in the configured channel
the ASAB IRIS service logs do not contain Microsoft Teams webhook errors

Microsoft Teams templates¶

Microsoft Teams templates must be stored in the /Templates/MSTeams/ directory in the Library.

Example template:

/Templates/MSTeams/alert.md

**{{ severity }} notification**

{{ message }}

Web request example¶

{
  "body": {
    "template": "/Templates/MSTeams/alert.md",
    "params": {
      "severity": "High",
      "message": "New security notification"
    }
  }
}

Kafka notification example¶

When sending through Kafka, set type to msteams.

{
  "type": "msteams",
  "body": {
    "template": "/Templates/MSTeams/alert.md",
    "params": {
      "severity": "High",
      "message": "New security notification"
    }
  }
}