Microsoft Teams¶

Služba zasílání zpráv může odesílat oznámení do Microsoft Teams pomocí adresy URL webhooku Teams.

Používejte Microsoft Teams, když by se oznámení z LogMan.io měla zobrazit v kanálu Teams, například pro provozní upozornění, aktualizace incidentů nebo sledovací zprávy.

Služba vykreslí nakonfigurovanou šablonu a odešle vykreslenou zprávu do Microsoft Teams jako Adaptive Card.

Předpoklady¶

Než nakonfigurujete Microsoft Teams, ujistěte se, že:

přístup k týmu a kanálu Microsoft Teams, kam budou odesílána oznámení, je k dispozici
oprávnění k vytvoření nebo konfiguraci webhooku Teams pro tento kanál je k dispozici
URL webhooku Teams je k dispozici
server LogMan.io může dosáhnout URL webhooku přes HTTPS
je k dispozici bezpečné místo pro uložení URL webhooku, pokud nasazení považuje tento údaj za tajný

Požadovaná konfigurační pole¶

Pole	Popis
`webhook_url`	URL webhooku Microsoft Teams.

Vzor konfigurace¶

Upravte soubor model.yaml pro konfiguraci služby asab-iris:

/Site/model.yaml

define:
  type: rc/model

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

Nastavení Microsoft Teams¶

Otevřete Microsoft Teams.
Přejděte do týmu a kanálu, kam má služba posílat oznámení.
Vytvořte schválený koncový bod webhook pro kanál. V závislosti na zásadách tenantů to může být konektor Incoming Webhook nebo workflow v Teams, které přijímá požadavky na webhook.
Zkopírujte vygenerovanou URL webhooku.
Uložte URL webhooku do Vaultu nebo do úložiště tajemství nasazení používaného instalací LogMan.io.
Aktualizujte /Site/model.yaml.
Použijte model z Knihovny, nebo spusťte příkaz pro aplikaci nasazení používaný instalací.
Odešlete testovací oznámení Microsoft Teams.

Poznámka

Přesné umístění nastavení webhooku závisí na zásadách nájemce Microsoft Teams a konfiguraci kanálu. Microsoft přesouvá scénáře konektorů Microsoft 365 směrem k pracovním postupům Teams. Pokud příchozí webhooky nejsou k dispozici, požádejte správce Microsoft 365, aby poskytl schválenou URL adresu webhooku pracovního postupu Teams.

Ověřte konfiguraci¶

Konfigurace je připravena, když:

služba se spouští bez konfiguračních chyb Microsoft Teams
URL webhooku patří očekávanému kanálu Teams nebo workflow
v nakonfigurovaném kanálu se zobrazí testovací oznámení
v protokolech služby se nevyskytují chyby webhooku Microsoft Teams

Šablony Microsoft Teams¶

Šablony Microsoft Teams musí být uloženy v adresáři /Templates/MSTeams/ v Knihovně.

Vzorový šablona:

/Templates/MSTeams/alert.md

**{{ severity }} notification**

{{ message }}

Příklad webového požadavku¶

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

Příklad oznámení Kafka¶

Při odesílání přes Kafka nastavte type na msteams.

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