Külső értesítések

A következőre vonatkozik: Configuration Manager (aktuális ág)

Összetett informatikai környezetben előfordulhat, hogy rendelkezik egy olyan automatizálási rendszerrel, mint az Azure Logic Apps. Az ügyfelek ezeket a rendszereket használják automatizált munkafolyamatok meghatározására és szabályozására több rendszer integrálásához. A Configuration Manager integrálhatja egy különálló automatizálási rendszerbe a termék SDK API-ján keresztül. Ez a folyamat azonban összetett és kihívást jelenthet a szoftverfejlesztési háttérrel nem rendelkező informatikai szakemberek számára.

A 2107-es verziótól kezdve engedélyezheti, hogy a webhely értesítéseket küldjön egy külső rendszernek vagy alkalmazásnak. Ez a funkció webszolgáltatás-alapú módszerrel egyszerűsíti a folyamatot. Az előfizetéseket úgy konfigurálja, hogy elküldjék ezeket az értesítéseket. Ezek az értesítések adott, meghatározott eseményekre reagálnak, amikor bekövetkeznek. Például az állapotüzenetek szűrőszabályai.

Megjegyzés:

A külső rendszer vagy alkalmazás határozza meg és biztosítja azokat a metódusokat, amelyeket ez a szolgáltatás meghív.

A szolgáltatás beállításakor a hely megnyit egy kommunikációs csatornát a külső rendszerrel. Ez a rendszer ezután elindíthat egy összetett munkafolyamatot vagy műveletet, amely nem létezik Configuration Manager.

A 2111-es verziótól kezdve a Configuration Manager-konzol használatával hozhat létre vagy szerkeszthet előfizetéseket külső értesítésekhez. Ez a cikk most erre a felületre összpontosít. Ha a 2107-es verziót használja, tekintse meg Configuration Manager 2107-es verziót.

Előfeltételek

• Hozza létre az előfizetést a hierarchia legfelső szintű webhelyén. Ez a hely vagy önálló elsődleges hely, vagy központi adminisztrációs hely (CAS). A meglévő előfizetéseket a hierarchia bármely webhelyén megtekintheti és módosíthatja.

• A hely szolgáltatáskapcsolódási pontjának online módban kell lennie. További információ: Tudnivalók a szolgáltatáskapcsolódási pontról.

• Ez a funkció jelenleg csak az Azure Logic Appst támogatja külső rendszerként. Logikai alkalmazás létrehozásához aktív Azure-előfizetésre van szükség.

  A szolgáltatáskapcsolódási pontnak kommunikálnia kell az értesítési szolgáltatással, például az Azure Logic Appsszel. További információ: Internet-hozzáférési követelmények.

• Ahhoz, hogy eseménytípust hozzon létre egy alkalmazás-jóváhagyási kérelemhez, a webhelynek szüksége van egy jóváhagyást igénylő alkalmazásra, amely egy felhasználói gyűjteményben van üzembe helyezve. További információ: Alkalmazások üzembe helyezése és Alkalmazások jóváhagyása.

Engedélyek

A NotificationSubscription objektumhoz a következő engedélyeket konfigurálhatja: Olvasás, Törlés, Módosítás, Létrehozás.

• A Teljes rendszergazda alapértelmezett biztonsági szerepkör rendelkezik ezekkel az engedélyekkel.
• A Csak olvasási elemző alapértelmezett biztonsági szerepkör olvasási engedéllyel rendelkezik.

A 2107-es verzióban a felhasználóknak a Minden biztonsági hatókörre is szükségük van. A 2111-es és újabb verziókban nem lehet hatókörbe állítani az előfizetési objektumokat. Szükség esetén hatóköröket használhat a Webhely objektumon, amelyhez a felhasználóknak legalább olvasási engedélyre van szükségük.

Az egyéni szerepkörökhöz más engedélyekre is szükség lehet. Az alábbi táblázatból megtudhatja, hogy mire van szükség:

Művelet	Figyelmeztetések: Olvasni	Oldalon: Olvasni	Értesíti: Olvasni	Értesíti: Módosítani	Értesíti: Létrehozás	Értesíti: Törlés	Oldalon: SFR kezelése
Előfizetés megtekintése	X		X
Előfizetés módosítása	X	X	X	X
Előfizetés létrehozása – 1. megjegyzés	X	X	X		X
Előfizetés törlése	X		X			X
Új SFR létrehozása	X	X	X	2. megjegyzés	2. megjegyzés		X
Meglévő SFR hozzáadása	X	X	X	2. megjegyzés	2. megjegyzés
Alkalmazás-jóváhagyás hozzáadása	X	X	X	2. megjegyzés	2. megjegyzés

A fenti táblázat a következő rövidítést használja:

• Értesítés: Értesítés-előfizetés objektumai
• SFR: Állapotszűrő szabály

1. megjegyzés: Legfelső szintű hely a hierarchiában

Hozza létre az előfizetést a hierarchia legfelső szintű webhelyén. Ez a hely vagy önálló elsődleges hely, vagy CAS. A meglévő előfizetéseket a hierarchia bármely webhelyén megtekintheti és módosíthatja.

2. megjegyzés: Az eseményműveletek engedélyeinek módosítása és létrehozása

Az előfizetés eseményeinek kezelésekor az Értesítési előfizetés objektum módosítási vagy létrehozási engedélyei attól függenek, hogy módosítania vagy létre kell-e hoznia az eseményt. Ha például rendelkezik Létrehozás engedéllyel, hozzáadhat egy állapotszűrő szabályt az előfizetéshez. Ha nem rendelkezik Módosítás engedéllyel, akkor nem módosíthatja az előfizetési eseményeket.

Azure-beli logikai alkalmazás és munkafolyamat létrehozása

Az alábbi eljárással hozzon létre egy mintaalkalmazást az Azure Logic Appsben az értesítés fogadásához Configuration Manager.

Megjegyzés:

Ez a folyamat példaként szolgál az első lépésekhez. Nem éles használatra készült.

1. Jelentkezzen be az Azure portálra.

2. Az Azure keresőmezőbe írja be a kifejezést logic apps, majd válassza a Logic Apps lehetőséget.

3. Válassza a Hozzáadás , majd a Felhasználás lehetőséget. Ez a művelet létrehoz egy új logikai alkalmazást.

4. Az Alapvető beállítások lapon adja meg a környezethez szükséges projektadatokat: előfizetés neve, erőforráscsoport, logikai alkalmazás neve és régió.

5. Válassza az Áttekintés + létrehozás lehetőséget. Az érvényesítési lapon erősítse meg a megadott adatokat, majd válassza a Létrehozás lehetőséget.

6. A Következő lépések területen válassza az Erőforrás megnyitása lehetőséget.

7. A Gyakori eseményindítóval való kezdés szakasz alatt válassza a HTTP-kérés fogadásakor lehetőséget.

8. Az eseményindító-szerkesztő alján válassza a Minta hasznos adat használata séma létrehozásához lehetőséget.

9. Illessze be a következő hasznos adatokat:

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

10. Válassza a Kész , majd a Mentés lehetőséget.

11. Másolja ki a logikai alkalmazás generált URL-címét. Ezt az URL-címet később fogja használni, amikor létrehozza az előfizetést Configuration Manager.

    Megjegyzés:

    A logikai alkalmazás Azure-ból származó URL-címe tartalmazza a titkos kulcsot. Ha Configuration Manager menti, ugyanúgy védett, mint bármely más jelszó vagy titkos kulcs. Ha a környezet proxykiszolgálót vagy más hálózatvizsgáló eszközt használ, fennáll a veszélye annak, hogy naplózza ezt az URL-címet, és elérhetővé teszi a titkos kulcsot. Szabályozhatja az ilyen rendszerekhez való hozzáférést, és készen áll arra, hogy megújítsa a logikai alkalmazás titkos kulcsát a Azure Portal. A titkos kulcs lejárati dátumát is beállíthatja a Azure Portal. További információ: A logikai alkalmazások védelme.

12. Ha új lépést szeretne hozzáadni a tervezőben, válassza az + Új lépés lehetőséget. Válassza ki a megfelelő műveletet, amikor értesítést kap Configuration Manager. Például:

    • E-mail küldéséhez használja az Office 365 Outlook-összekötőt.
    • Ha üzenetet szeretne közzétenni a Teamsben, használja a Microsoft Teams-összekötőt.

    Ha szükséges, jelentkezzen be, és töltse ki a művelethez szükséges információkat. További információkért tekintse meg a Logikai alkalmazások létrehozása rövid útmutatót az Azure Logic Apps dokumentációjában.

Értesítési séma

Ezek az értesítések a következő szabványosított sémát használják:

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

Esemény létrehozása

Jelenleg kétféle eseménytípus támogatott:

• A webhely egy állapotüzenetet jelenít meg, amely megfelel a külső értesítés állapotszűrő szabályában megadott feltételeknek. Létrehozhat egy új szabályt, vagy használhat egy meglévőt.

• A felhasználó jóváhagyást kér egy alkalmazáshoz a Szoftverközpontban.

Megjegyzés:

A hierarchiában az események hatóköre az esemény típusától függ:

• Az alkalmazás-jóváhagyási események csak az elsődleges helyeken történnek.
• Az állapotszűrő szabályok arra a webhelyre vonatkoznak, ahol a szabályt a Külső szolgáltatásértesítés létrehozása eseményvarázslóval hozza létre.
  • Ha a varázsló futtatásával hozza létre az eseményt, miközben csatlakozik a CAS-hoz, az csak a CAS-ból származó egyező eseményeken aktiválódik.
  • A gyermek elsődleges hely által kiváltott eseményekre való feliratkozáshoz csatlakozzon az elsődleges helyhez. Módosítsa az értesítési előfizetést úgy, hogy új állapotszűrő szabályt hozzon létre az elsődleges gyermekhelyhez.

Esemény létrehozásához használja a következő folyamatot:

1. Az Configuration Manager konzolon csatlakozzon a hierarchia legfelső szintű helyéhez. Ez a hely vagy önálló elsődleges hely, vagy CAS.

2. Lépjen a Figyelés munkaterületre, bontsa ki a Riasztások elemet, és válassza a Külső szolgáltatásértesítések csomópontot .

3. A menüszalagon válassza az Előfizetés létrehozása lehetőséget.

4. Az Új előfizetés ablakban adja meg az előfizetés nevét a Configuration Manager konzolon való azonosításához. A maximális hossz 254 karakter. Igény szerint adjon meg egy Leírást.

5. A Külső szolgáltatás URL-címe értékhez illessze be a korábban másolt Azure Logic App URL-címét.

6. Az arany csillagot választva új eseményt adhat hozzá az előfizetéshez.

   1. A Külső szolgáltatásértesítési esemény létrehozása varázsló Esemény típusa lapján válasszon az alábbi eseménytípusok közül:

      • Új állapotszűrő szabály: Hozzon létre egy új állapotszűrő szabályt az eseményhez. Adja meg az állapotszűrő szabály nevét, majd konfigurálja a szűrési feltételeket. Az állapotüzenet-szabályokra vonatkozó feltételekről további információt az Állapotrendszer használata című témakörben talál.

        Fontos

        Legyen óvatos a létrehozott állapotszűrő-szabály típusával. Külső értesítések esetén a webhely öt percenként 300 állapotüzenetet képes feldolgozni. Ha a szabály ennél a korlátnál több üzenetet engedélyez, az hátralékot okoz a webhelyen. Meghatározott forgatókönyvekhez keskeny szűrőkkel rendelkező szabályokat hozhat létre. Kerülje az olyan általános szabályokat, amelyek sok üzenetet engedélyeznek.

      • Meglévő állapotszűrő szabály: Az állapotszűrő szabály újbóli használata a már létező külső értesítésekhez. Nem jeleníti meg az összes állapotszűrő szabályt, csak a varázslóval létrehozott szabályokat.

      • A felhasználó elküldi az alkalmazáskérést: Külső értesítés küldése az alkalmazás-jóváhagyási kérelmekről.

Események kezelése

Az előfizetés létrehozása után a Külső szolgáltatás értesítési csomópontjának használatával hajtsa végre a következő műveleteket:

• Tulajdonságok: Az előfizetés nevének, leírásának vagy eseményeinek szerkesztése. A külső szolgáltatás URL-címe nem szerkeszthető.

• Törlés: Előfizetés eltávolítása.

Megjegyzés:

A meglévő előfizetéseket a hierarchia bármely webhelyén megtekintheti és módosíthatja.

Amikor kiválaszt egy előfizetést, a részletek panelen megjelennek a bekövetkezett eseményekre vonatkozó információk.

Esemény aktiválása

Az esemény aktiválásának folyamata az előfizetés típusától függ:

• Állapotszűrő szabály esetén aktiváljon egy eseményt a helyösszetevőhöz. Például a Configuration Manager Service Manager használatával indítsa újra az összetevőt.

• Alkalmazás-jóváhagyási kérelem esetén a Szoftverközpontban kérhet jóváhagyást igénylő alkalmazást. További információ: A Szoftverközpont felhasználói útmutatója.

A munkafolyamat figyelése

Configuration Manager-konzol

A 2309-es verziótól kezdődően, amikor az Azure Logic Apps adott eseményekhez vagy feltételekhez kapcsolódó értesítéseket vagy riasztásokat hoz létre, Configuration Manager mostantól rögzíthetik és megjeleníthetik ezeket az értesítéseket. Ez az integráció lehetővé teszi az Azure Logic Apps-értesítések figyelését közvetlenül a Configuration Manager konzolon, központosított helyet biztosítva a kritikus események nyomon követéséhez, a megfelelő műveletek elvégzéséhez és a magas szintű működési hatékonyság fenntartásához. 

A funkció használatához érvényes Microsoft Entra webalkalmazás szükséges. Telepítse az Azure-szolgáltatásokat a Felügyeleti szolgáltatáskezeléshez a Felügyelet\Áttekintés\Cloud Services\Azure-szolgáltatások területen. Ha a szolgáltatás már üzembe van helyezve, a rendszergazda a meglévő webalkalmazással megtekintheti a Futtatás részleteit az Azure logikai alkalmazásból.

További információ: Azure-szolgáltatások konfigurálása a Configuration Manager való használatra.

Az előfizetés futtatási részleteinek megtekintéséhez használja az alábbi folyamatot:

1. A Configuration Manager konzolon kattintson a Figyelés elemre.
2. A Figyelés munkaterületen kattintson a Külső szolgáltatásértesítések elemre, és válassza ki a kívánt előfizetést.
3. Kattintson a Részletek megjelenítése elemre.
4. A párbeszédpanelen válassza ki az Azure-környezetet, Microsoft Entra bérlő nevét a legördülő listából, és jelentkezzen be az Azure Rendszergazda-fiókjával.
5. Válassza ki az Előfizetés azonosítóját, és adja meg az Erőforráscsoport nevét és a Munkafolyamat nevét.
6. Kattintson a Futtatás részleteinek lekérése gombra a Futtatás részleteinek megtekintéséhez.

Azure Portal

Öt percen belül az esemény elindítja a logikai alkalmazás munkafolyamatát. Ellenőrizze a munkafolyamat állapotát a Azure Portal. Lépjen a logikai alkalmazás Futtatási előzmények lapjára.

További információ: Futtatási állapot monitorozása, eseményindítók előzményeinek áttekintése és riasztások beállítása az Azure Logic Appshez.

Hibaelhárítás

A folyamat hibaelhárításához használja a következő Configuration Manager naplófájlokat a helykiszolgálón:

• ExternalNotificationsWorker.log: Ellenőrizze, hogy az üzenetsor fel lett-e dolgozva, és hogy a rendszer értesítéseket küld-e a külső rendszernek.
• statmgr.log: Ellenőrizze, hogy az állapotszűrő szabályok hibák nélkül lettek-e feldolgozva

Ismert problémák

Ha létrehoz egy állapotszűrő szabályt, az megjelenik a webhely állapotszűrő szabályainak listájában az Configuration Manager konzolon. Ha módosítást végez a szabály tulajdonságainak Műveletek lapján, a külső értesítés nem fog működni.

Miután helyreállított egy központi adminisztrációs helyet (CAS), törölje és hozza létre újra az előfizetést.

Tipp

A CAS eltávolítása előtt hozza létre újra az előfizetéseket az elsődleges gyermekhelyen.

Configuration Manager 2107-es verzió

Fontos

Ez a szakasz és a PowerShell-szkript csak a 2107-es verzióra vonatkozik. A 2111-es és újabb verziókban az Configuration Manager-konzollal hozhat létre és kezelhet eseményeket.

A 2107-es verzió egyéb előfeltételei

Az objektumok Configuration Manager 2107-es verziójában való létrehozásához a PowerShell-szkriptet kell használnia SetupExternalServiceNotifications.ps1. Az alábbi példaszkripttel megfelelően lekérheti az ehhez a funkcióhoz használandó PowerShell-szkriptet:

$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

Megjegyzés:

SetupExternalServiceNotifications.ps1 a Microsoft digitálisan aláírta. Ez a példaszkript letölti a fájlt, és kijavítja a sortöréseket a digitális aláírás megőrzése érdekében.

Esemény létrehozása a 2107-es verzióban

A 2107-es verzió kétféle eseménytípust támogat:

• A webhely egy állapotüzenetet jelenít meg, amely megfelel az állapotszűrő szabályban megadott feltételeknek.

• A felhasználó jóváhagyást kér egy alkalmazáshoz a Szoftverközpontban.

Állapotüzenet-esemény létrehozása a 2107-es verzióban

1. A helykiszolgálón futtassa a SetupExternalServiceNotifications.ps1parancsot. Mivel a helykiszolgálón futtatja, a folytatáshoz írja be a következőt y : .

2. Új állapotszűrő szabály létrehozásához válassza a lehetőséget 2 .

3. Adja meg az új állapotszűrő szabály nevét.

4. Válassza ki a szabály üzenetegyeztetési feltételeit, és adja meg az egyező értékeket. Adja meg 0 , hogy ne használjon feltételt.

   A következő feltételek érhetők el:

   • Forrás: Ügyfél, SMS-szolgáltató, helykiszolgáló
   • Webhely kódja
   • Rendszer
   • Összetevő
   • Üzenet típusa: Mérföldkő, Részletek, Naplózás
   • Súlyosság: Tájékoztató, figyelmeztetés, hiba
   • Üzenet azonosítója
   • Tulajdonság
   • Tulajdonságérték

   Az állapotüzenet-szabályokra vonatkozó feltételekről további információt az Állapotrendszer használata című témakörben talál.

   Fontos

   Legyen óvatos a létrehozott állapotszűrő-szabály típusával. Külső értesítések esetén a webhely öt percenként 300 állapotüzenetet képes feldolgozni. Ha a szabály ennél a korlátnál több üzenetet engedélyez, az hátralékot okoz a webhelyen. Meghatározott forgatókönyvekhez keskeny szűrőkkel rendelkező szabályokat hozhat létre. Kerülje az olyan általános szabályokat, amelyek sok üzenetet engedélyeznek.

5. Futtassa újra a PowerShell-szkriptet. Új előfizetés létrehozásához válassza a lehetőséget 3 .

6. Adja meg az előfizetés nevét és leírását. Ezután adja meg a logikai alkalmazás korábban a Azure Portal másolt URL-címét.

7. Válassza ki az új állapotszűrő szabályt.

8. A parancsprogramból való kilépéshez válassza a lehetőséget 0 .

Alkalmazás-jóváhagyási esemény létrehozása a 2107-es verzióban

Megjegyzés:

Ehhez az eseménytípushoz jóváhagyást igénylő alkalmazásra van szükség, amely egy felhasználói gyűjteményben van üzembe helyezve. További információ: Alkalmazások üzembe helyezése és Alkalmazások jóváhagyása.

1. A helykiszolgálón futtassa a SetupExternalServiceNotifications.ps1parancsot. Mivel a helykiszolgálón futtatja, a folytatáshoz írja be a következőt y : .

2. Új előfizetés létrehozásához válassza a lehetőséget 3 .

3. Adja meg az előfizetés nevét és leírását. Ezután adja meg a logikai alkalmazás korábban a Azure Portal másolt URL-címét.

4. Válassza ki a megfelelő eseményt egy alkalmazáskéréshez.

5. A parancsprogramból való kilépéshez válassza a lehetőséget 0 .

Előfizetés eltávolítása a 2107-es verzióban

Ha törölnie kell egy előfizetést, használja a következő folyamatot:

1. Futtassa a SetupExternalServiceNotifications.ps1 szkriptet az elérhető előfizetések listázására szolgáló beállítással 1 . Jegyezze fel az előfizetés azonosítóját, amely egy egész szám.

2. Használja a felügyeleti szolgáltatás NotificationSubscription API-ját. Hozzon létre EGY DELETE-hívást az URI-hoz https://<SMSProviderFQDN>/AdminService/v1.0/NotificationSubscription/<Subscription_ID>.

   További információ: A felügyeleti szolgáltatás használata Configuration Manager.

Az előfizetés eltávolítása után a webhely nem küld értesítéseket a külső rendszernek.

Szkripthasználat a 2107-es verzióban

A SetupExternalServiceNotifications.ps1futtatásakor észleli, hogy az egy helykiszolgálón fut-e:

• Y: Folytatás az aktuális kiszolgálón
• N: Adja meg a használni kívánt helykiszolgáló teljes tartománynevét

Ha a szkript nem észlel helykiszolgálót, teljes tartománynevet kér.

Ezután a következő műveletek érhetők el:

• 0: Kihagyás/folytatás
• 1: Az elérhető előfizetések listázása
• 2: Állapotszűrő szabály létrehozása az állapotüzenetek elérhetővé tételéhez
• 3: Hozzon létre egy előfizetést. Ez a lehetőség csak a legfelső szintű webhelyen érhető el.

Megjegyzés:

Ez a szkript csak a 2107-es vagy újabb verziót futtató webhelyeken támogatott.

Következő lépések

Az állapotrendszer használata

Riasztások konfigurálása