Externí oznámení

Platí pro: Configuration Manager (Current Branch)

Ve složitém IT prostředí můžete mít automatizační systém, jako je Azure Logic Apps. Zákazníci tyto systémy používají k definování a řízení automatizovaných pracovních postupů pro integraci více systémů. Configuration Manager můžete integrovat do samostatného systému automatizace prostřednictvím rozhraní API sady SDK produktu. Tento proces ale může být složitý a náročný pro IT profesionály, kteří nemají zkušenosti s vývojem softwaru.

Od verze 2107 můžete webu povolit odesílání oznámení externímu systému nebo aplikaci. Tato funkce zjednodušuje proces pomocí metody založené na webové službě. Nakonfigurujete odběry tak, aby odesílaly tato oznámení. Tato oznámení reagují na konkrétní definované události, ke kterým dochází. Například pravidla filtru stavových zpráv.

Když nastavíte tuto funkci, otevře web komunikační kanál s externím systémem. Tento systém pak může spustit složitý pracovní postup nebo akci, která v Configuration Manager neexistuje.

Od verze 2111 můžete pomocí konzoly Configuration Manager vytvářet nebo upravovat odběry externích oznámení. Tento článek se teď zaměřuje na toto prostředí. Pokud používáte verzi 2107, přečtěte si Configuration Manager verzi 2107.

Požadavky

• Vytvořte předplatné na lokalitě nejvyšší úrovně v hierarchii. Tato lokalita je buď samostatná primární lokalita, nebo lokalita centrální správy (CAS). Existující předplatné můžete zobrazit a upravit na libovolném webu v hierarchii.

• Spojovací bod služby lokality musí být v online režimu. Další informace najdete v tématu Informace o spojovacím bodu služby.

• V současné době tato funkce podporuje jako externí systém jenom Azure Logic Apps. Vyžaduje se aktivní předplatné Azure s právy k vytvoření aplikace logiky.

  Spojovací bod služby musí komunikovat se službou oznámení, například Azure Logic Apps. Další informace najdete v tématu Požadavky na přístup k internetu.

• K vytvoření typu události pro žádost o schválení aplikace potřebuje web aplikaci, která vyžaduje schválení a je nasazená do kolekce uživatelů. Další informace najdete v tématech Nasazení aplikací a Schválení aplikací.

Oprávnění

Pro objekt NotificationSubscription můžete nakonfigurovat následující oprávnění: Read, Delete, Modify, Create.

• Tato oprávnění má výchozí úplná role zabezpečení správce.
• Výchozí role zabezpečení analytika jen pro čtení má oprávnění ke čtení .

Ve verzi 2107 potřebují uživatelé také obor zabezpečení Vše . Ve verzi 2111 a novější není možné nastavit obor objektů předplatného. V případě potřeby můžete u objektu Site použít obory, ke kterým uživatelé potřebují alespoň oprávnění ke čtení.

Pro vlastní role se můžou vyžadovat další oprávnění. Pokud chcete zjistit, co je potřeba, použijte následující tabulku:

Výše uvedená tabulka používá následující zkratku:

• Upozornit: Objekty odběru oznámení
• SFR: Pravidlo filtru stavu

Poznámka 1: Lokalita nejvyšší úrovně v hierarchii

Vytvořte předplatné na lokalitě nejvyšší úrovně v hierarchii. Tato lokalita je buď samostatná primární lokalita, nebo cas. Existující předplatné můžete zobrazit a upravit na libovolném webu v hierarchii.

Poznámka 2: Úprava a vytvoření oprávnění pro akce událostí

Při správě událostí v předplatném závisí oprávnění k úpravě nebo vytvoření u objektu odběru oznámení na tom, jestli je potřeba událost upravit nebo vytvořit. Pokud máte například oprávnění Vytvořit , můžete do předplatného přidat pravidlo filtru stavu. Pokud nemáte oprávnění k úpravě , nemůžete provádět změny událostí odběru.

Vytvoření aplikace logiky Azure a pracovního postupu

Pomocí následujícího postupu vytvořte v Azure Logic Apps ukázkovou aplikaci pro příjem oznámení z Configuration Manager.

1. Přihlaste se na portál Microsoft Azure.

2. Do vyhledávacího pole Azure zadejte logic appsa vyberte Logic Apps.

3. Vyberte Přidat a zvolte Spotřeba. Tato akce vytvoří novou aplikaci logiky.

4. Na kartě Základy zadejte podrobnosti o projektu, které jsou potřeba pro vaše prostředí: název předplatného, skupina prostředků, název aplikace logiky a oblast.

5. Vyberte Zkontrolovat a vytvořit. Na stránce ověření potvrďte podrobnosti, které jste zadali, a vyberte Vytvořit.

6. V části Další kroky vyberte Přejít k prostředku.

7. V části Start with a common trigger (Začít s běžným triggerem) vyberte When a HTTP request is received (Při přijetí požadavku HTTP).

8. V dolní části editoru triggerů vyberte Použít ukázkovou datovou část ke generování schématu.

9. Vložte následující ukázkovou datovou část:

   {
       "EventID":0,
       "EventName":"",
       "SiteCode":"",
       "ServerName":"",
       "MessageID":0,
       "Source":"",
       "EventPayload":""
   }
   

10. Vyberte Hotovo a pak vyberte Uložit.

11. Zkopírujte vygenerovanou adresu URL aplikace logiky. Tuto adresu URL použijete později při vytváření předplatného v Configuration Manager.

    Poznámka

    Adresa URL aplikace logiky z Azure obsahuje tajný klíč. Při uložení v Configuration Manager je chráněná stejně jako jakékoli jiné heslo nebo tajný klíč. Pokud vaše prostředí používá proxy server nebo jiné zařízení pro kontrolu sítě, existuje riziko, že zapíše tuto adresu URL a zveřejní tajný klíč. Ovládejte přístup k těmto systémům a buďte připraveni obnovit tajný klíč pro aplikaci logiky v Azure Portal. Můžete také nastavit datum vypršení platnosti tajného klíče v Azure Portal. Další informace najdete v tématu Zabezpečení aplikací logiky.

12. Pokud chcete v návrháři přidat nový krok, vyberte + Nový krok. Zvolte příslušnou akci, když obdrží oznámení od Configuration Manager. Příklady:

    • K odeslání e-mailu použijte konektor Office 365 Outlook.
    • Pokud chcete publikovat zprávu do Teams, použijte konektor Microsoft Teams.

    V případě potřeby se přihlaste a vyplňte požadované informace pro akci. Další informace najdete v rychlém startu Vytváření aplikací logiky v dokumentaci k Azure Logic Apps.

Schéma oznámení

Tato oznámení používají následující standardizované schéma:

{
    "properties": {
        "EventID": {
            "type": "integer"
        },
        "EventName": {
            "type": "string"
        },
        "EventPayload": {
            "type": "string"
        },
        "MessageID": {
            "type": "string"
        },
        "ServerName": {
            "type": "string"
        },
        "SiteCode": {
            "type": "string"
        },
        "Source": {
            "type": "string"
        }
    },
    "type": "object"
}

Vytvoření události

Aktuálně se podporují dva typy událostí:

• Web vyvolá stavovou zprávu, která odpovídá podmínkám zadaným v pravidle filtru stavu pro externí oznámení. Můžete vytvořit nové pravidlo nebo použít existující pravidlo.

• Uživatel požádá o schválení aplikace v Centru softwaru.

K vytvoření události použijte následující postup:

1. V konzole Configuration Manager se připojte k lokalitě hierarchie nejvyšší úrovně. Tato lokalita je buď samostatná primární lokalita, nebo cas.

2. Přejděte do pracovního prostoru Monitorování , rozbalte Výstrahy a vyberte uzel Oznámení externích služeb .

3. Na pásu karet vyberte Vytvořit předplatné.

4. V okně Nové předplatné zadejte název předplatného, abyste ho identifikovali v konzole Configuration Manager. Maximální délka je 254 znaků. Volitelně můžete přidat popis.

5. Jako hodnotu Adresa URL externí služby vložte adresu URL aplikace logiky Azure, kterou jste předtím zkopírovali.

6. Výběrem zlaté hvězdičky přidejte do předplatného novou událost.

   1. V průvodci Vytvořit událost oznámení externí služby vyberte na stránce Typ události jeden z následujících typů událostí:

      • Nové pravidlo filtru stavu: Vytvořte nové pravidlo filtru stavu, které se použije pro tuto událost. Zadejte název pravidla filtru stavu a potom nakonfigurujte kritéria filtru. Další informace o kritériích pro pravidla stavových zpráv najdete v tématu Použití stavového systému.

        Důležité

        Při vytváření typu pravidla filtru stavu buďte opatrní. V případě externích oznámení může web každých pět minut zpracovat 300 stavových zpráv. Pokud vaše pravidlo povoluje více zpráv, než je tento limit, způsobí to na webu backlog. Vytvořte pravidla s úzkými filtry pro konkrétní scénáře. Vyhněte se obecným pravidlům, která povolují velké množství zpráv.

      • Existující pravidlo filtru stavu: Znovu použijte pravidlo filtru stavu pro externí oznámení, které už existuje. Nezobrazují se všechna pravidla filtru stavu, ale jenom pravidla, která jste vytvořili pomocí tohoto průvodce.

      • Uživatel odešle žádost o aplikaci: Odešle externí oznámení pro žádosti o schválení aplikace.

Správa událostí

Po vytvoření předplatného použijte uzel Oznámení externí služby k provedení následujících akcí:

• Vlastnosti: Upravte název, popis nebo události předplatného. Adresu URL externí služby nemůžete upravit.

• Odstranit: Odebere předplatné.

Když vyberete předplatné, zobrazí se v podokně podrobností informace o událostech, ke kterým došlo.

Aktivace události

Postup aktivace události závisí na typu předplatného:

• V případě pravidla filtru stavu aktivujte událost pro komponentu lokality. Pomocí Configuration Manager Service Manager například restartujte komponentu.

• V případě žádosti o schválení aplikace použijte Centrum softwaru a požádejte o aplikaci, která vyžaduje schválení. Další informace najdete v uživatelské příručce centra softwaru.

Monitorování pracovního postupu

konzola Configuration Manager

Od verze 2309, když Azure Logic Apps generuje oznámení nebo upozornění týkající se konkrétních událostí nebo podmínek, Configuration Manager teď může tato oznámení zachytávat a zobrazovat. Tato integrace umožňuje monitorování oznámení aplikace logiky Azure přímo v konzole Configuration Manager a poskytuje centralizované umístění pro sledování důležitých událostí, provádění vhodných akcí a udržování vysoké úrovně provozní efektivity. 

K použití této funkce se vyžaduje platná Microsoft Entra webová aplikace. Nasaďte služby Azure pro správu služeb správy v části Správa\Přehled\Cloud Services\Služby Azure. Pokud je služba už nasazená, může správce použít existující webovou aplikaci k zobrazení podrobností o spuštění z aplikace logiky Azure.

Další informace najdete v tématu Konfigurace služeb Azure pro použití s Configuration Manager.

K zobrazení podrobností o spuštění předplatného použijte následující postup:

1. V konzole Configuration Manager klikněte na Monitorování.
2. V pracovním prostoru Monitorování klikněte na Oznámení externích služeb a vyberte požadované předplatné.
3. Klikněte na Zobrazit podrobnosti.
4. V dialogovém okně vyberte prostředí Azure, v rozevíracím seznamu Microsoft Entra název tenanta a přihlaste se pomocí účtu Azure Správa.
5. Vyberte ID předplatného a zadejte název skupiny prostředků a název pracovního postupu .
6. Kliknutím na tlačítko Získat podrobnosti o spuštěnízobrazíte podrobnosti o spuštění.

Azure Portal

Během pěti minut událost aktivuje pracovní postup aplikace logiky. Zkontrolujte stav pracovního postupu v Azure Portal. Přejděte na stránku Historie spuštění aplikace logiky.

Další informace najdete v tématu Monitorování stavu spuštění, kontrola historie triggerů a nastavení upozornění pro Azure Logic Apps.

Řešení potíží

Při řešení tohoto procesu použijte následující Configuration Manager soubory protokolu na serveru lokality:

• ExternalNotificationsWorker.log: Zkontrolujte, jestli byla zpracována fronta a jestli se do externího systému odesílají oznámení.
• statmgr.log: Zkontrolujte, jestli se pravidla filtru stavu nezpracovala bez chyb.

Známé problémy

Pokud vytvoříte pravidlo filtru stavu, uvidíte ho v seznamu pravidel filtru stavu na webu v konzole Configuration Manager. Pokud provedete změnu na kartě Akce ve vlastnostech pravidla, externí oznámení nebude fungovat.

Po obnovení lokality centrální správy (CAS) odstraňte a znovu vytvořte předplatné.

Configuration Manager verze 2107

Další požadavky pro verzi 2107

Pokud chcete vytvořit objekty v Configuration Manager verzi 2107, musíte použít powershellový skript SetupExternalServiceNotifications.ps1. Pokud chcete správně získat skript PowerShellu pro tuto funkci, použijte následující ukázkový skript:

$FileName = ".\SetupExternalServiceNotifications.ps1"
Invoke-WebRequest https://aka.ms/cmextnotificationscript -OutFile $FileName
(Get-Content $FileName -Raw).Replace("`n","`r`n") | Set-Content $FileName -Force
(Get-Content $FileName -Raw).TrimEnd("`r`n") | Set-Content $FileName -Force

Vytvoření události ve verzi 2107

Ve verzi 2107 jsou podporované dva typy událostí:

• Web vyvolá stavovou zprávu, která odpovídá podmínkám zadaným v pravidle filtru stavu.

• Uživatel požádá o schválení aplikace v Centru softwaru.

Vytvoření události stavové zprávy ve verzi 2107

1. Na serveru lokality spusťte SetupExternalServiceNotifications.ps1. Protože ho spouštíte na serveru lokality, pokračujte zadáním příkazu y .

2. Vyberte možnost 2 pro vytvoření nového pravidla filtru stavu.

3. Zadejte název nového pravidla filtru stavu.

4. Vyberte kritéria pro porovnávání zpráv pro pravidlo a zadejte hodnoty, které se mají shodovat. Zadejte 0 , aby se nepoužít kritérium.

   K dispozici jsou následující kritéria:

   • Zdroj: Klient, poskytovatel serveru SMS, server lokality
   • Kód lokality
   • Systému
   • Součást
   • Typ zprávy: Milník, Podrobnosti, Audit
   • Závažnost: Informační, Upozornění, Chyba
   • ID zprávy
   • Vlastnost
   • Hodnota vlastnosti

   Další informace o kritériích pro pravidla stavových zpráv najdete v tématu Použití stavového systému.

   Důležité

   Při vytváření typu pravidla filtru stavu buďte opatrní. V případě externích oznámení může web každých pět minut zpracovat 300 stavových zpráv. Pokud vaše pravidlo povoluje více zpráv, než je tento limit, způsobí to na webu backlog. Vytvořte pravidla s úzkými filtry pro konkrétní scénáře. Vyhněte se obecným pravidlům, která povolují velké množství zpráv.

5. Spusťte znovu skript PowerShellu. Vyberte možnost 3 pro vytvoření nového předplatného.

6. Zadejte název a popis předplatného. Pak zadejte adresu URL aplikace logiky, kterou jste předtím zkopírovali z Azure Portal.

7. Vyberte nové pravidlo filtru stavu.

8. Tuto možnost 0 vyberte, pokud chcete skript ukončit.

Vytvoření události schválení aplikace ve verzi 2107

1. Na serveru lokality spusťte SetupExternalServiceNotifications.ps1. Protože ho spouštíte na serveru lokality, pokračujte zadáním příkazu y .

2. Vyberte možnost 3 pro vytvoření nového předplatného.

3. Zadejte název a popis předplatného. Pak zadejte adresu URL aplikace logiky, kterou jste předtím zkopírovali z Azure Portal.

4. Vyberte příslušnou událost pro žádost aplikace.

5. Tuto možnost 0 vyberte, pokud chcete skript ukončit.

Odebrání předplatného ve verzi 2107

Pokud potřebujete odstranit předplatné, použijte následující postup:

1. Spusťte skriptSetupExternalServiceNotifications.ps1 s možností 1 výpisu dostupných předplatných. Poznamenejte si ID předplatného, což je celočíselná hodnota.

2. Použijte rozhraní API NotificationSubscription služby správy. Proveďte volání DELETE identifikátoru URI https://<SMSProviderFQDN>/AdminService/v1.0/NotificationSubscription/<Subscription_ID>.

   Další informace najdete v tématu Použití služby správy v Configuration Manager.

Po odebrání předplatného web neodesílá oznámení do externího systému.

Použití skriptu ve verzi 2107

Když spustíte SetupExternalServiceNotifications.ps1, zjistí, jestli běží na serveru lokality:

• Y: Pokračovat na aktuálním serveru
• N: Zadejte plně kvalifikovaný název domény serveru lokality, který chcete použít.

Pokud skript nerozpozná server lokality, vyzve k zadání plně kvalifikovaného názvu domény.

Pak jsou k dispozici následující akce:

• 0: Přeskočit/pokračovat
• 1: Výpis dostupných předplatných
• 2: Vytvoření pravidla filtru stavu pro zveřejnění stavových zpráv
• 3: Vytvořte předplatné. Tato možnost je dostupná jenom pro web nejvyšší úrovně.

Další kroky

Použití stavového systému

Konfigurace upozornění