checkId: check.notify.teams.configured plugin: stellaops.doctor.notify severity: warn tags: [notify, teams, quick, configuration]

Teams Configuration

This Stella Ops Doctor diagnostic confirms that the Microsoft Teams notification channel is configured correctly before Doctor ever attempts to deliver an alert. It validates local configuration only and does no network I/O, so it runs in air-gapped deployments; reachability is covered separately by check.notify.teams.connectivity.

What It Checks

Verifies that the Microsoft Teams notification channel is properly configured. The check reads Notify:Channels:Teams and validates:

Webhook URL (WebhookUrl): must be set and non-empty.
URL format: validates that the URL belongs to a Microsoft domain (webhook.office.com or microsoft.com).
Enabled flag (Enabled): if explicitly false, reports a warning.

The check only runs when the Notify:Channels:Teams configuration section exists.

Why It Matters

Teams is a common enterprise notification channel. Without a valid webhook URL, notifications about release decisions, policy violations, and security findings cannot reach Teams channels.

Common Causes

Teams webhook URL not set in configuration
Webhook URL is not from a Microsoft domain (malformed or legacy URL)
Teams notifications explicitly disabled
Environment variable not bound to configuration

How to Fix

Docker Compose

environment:
  Notify__Channels__Teams__WebhookUrl: "https://YOUR_TENANT.webhook.office.com/webhookb2/..."

Security note: Teams webhook URLs are secrets. Use Docker secrets or a vault.

Bare Metal / systemd

{
  "Notify": {
    "Channels": {
      "Teams": {
        "WebhookUrl": "https://YOUR_TENANT.webhook.office.com/webhookb2/..."
      }
    }
  }
}

Kubernetes / Helm

notify:
  channels:
    teams:
      webhookUrlSecret: "stellaops-teams-webhook"

To obtain a webhook URL in Teams, open the target channel and choose Connectors → Incoming Webhook → Create, then copy the generated URL into the configuration above.

Verification

stella doctor run --check check.notify.teams.configured

check.notify.teams.connectivity — tests whether the Teams webhook endpoint is reachable
check.notify.queue.health — verifies the notification delivery queue is healthy