Értesítések és értesítési sablonok konfigurálása az Azure API Managementben

A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Alap | Alap v2 | Standard | Standard v2 | Prémium | Prémium v2

Az Azure API Management lehetővé teszi az e-mail-értesítések konfigurálását adott eseményekhez, valamint az API Management-példány rendszergazdáival és fejlesztőivel való kommunikációhoz használt e-mail-sablonok konfigurálását. Ez a cikk bemutatja, hogyan konfigurálhatja az értesítéseket az elérhető eseményekhez, és áttekintést nyújt az eseményekhez használt e-mail-sablonok konfigurálásáról.

Előfeltételek

Ha nem rendelkezik API Management szolgáltatáspéldánysal, végezze el az alábbi rövid útmutatót: Azure API Management-példány létrehozása.

Nyissa meg az API Management-példányát

1. Az Azure portálonkeresse meg és válassza ki a API Management szolgáltatásokat:

   

2. Az API Management-szolgáltatások lapon válassza ki az API Management-példányt:

   

Értesítések konfigurálása az Azure Portalon

1. Az API Management-példány oldalsáv menüjében válassza az Üzembe helyezés + infrastruktúra lehetőséget, majd az Értesítések lehetőséget az elérhető értesítések megtekintéséhez.

   Az alábbi események listája konfigurálható értesítésekhez.

   • Előfizetési kérelmek (jóváhagyást igényel): A megadott e-mail-címzettek és felhasználók e-mailben kapnak értesítést a jóváhagyást igénylő termékekre vonatkozó előfizetési kérelmekről.
   • Új előfizetések: A megadott e-mail-címzettek és felhasználók e-mailben kapnak értesítést az új termék-előfizetésekről.
   • Alkalmazáskatalógus-kérelmek: A következő e-mail-címzettek és felhasználók e-mail-értesítést kapnak, amikor új alkalmazásokat küld az alkalmazáskatalógusba.
   • Titkos másolat: A megadott e-mail-címzettek és felhasználók titkos másolatot kapnak az összes olyan e-mailről, amelyeket a fejlesztőknek küldtek.
   • Új probléma vagy megjegyzés: A következő e-mail címzettjei és felhasználói e-mail-értesítéseket kapnak, ha új probléma vagy megjegyzés érkezik a fejlesztői portálra.
   • Fióküzenet bezárása: A megadott e-mail-címzettek és felhasználók e-mail-értesítéseket kapnak egy fiók bezárásakor.
   • Az előfizetési kvóta korlátjának megközelítése: A megadott e-mail-címzettek és felhasználók e-mail-értesítéseket kapnak, ha az előfizetés kihasználtsága megközelíti a használati kvótát.

2. Jelöljön ki egy értesítést, és adjon meg egy vagy több értesítendő e-mail-címet:

   • A rendszergazdai e-mail-cím hozzáadásához válassza a + Rendszergazda hozzáadása lehetőséget.
   • Másik e-mail-cím hozzáadásához válassza a + E-mail hozzáadása lehetőséget, adjon meg egy e-mail-címet, és válassza a Hozzáadás lehetőséget.
   • Szükség szerint folytassa az e-mail-címek hozzáadását.

   

Értesítési sablonok konfigurálása

Az API Management értesítési sablonokat biztosít a rendszergazdai e-mailekhez, amelyeket a rendszer automatikusan küld a fejlesztőknek a szolgáltatás elérésekor és használatakor. A következő értesítési sablonok érhetők el:

• Fejlesztői búcsúlevél
• A fejlesztői kvóta korlátjának közeledéséről szóló értesítés
• Fejlesztői üdvözlőlevél
• E-mail változásértesítés
• Felhasználó meghívása
• Új fejlesztői fiók megerősítése
• Új előfizetés aktiválva
• Jelszómódosítás megerősítése
• Az előfizetési kérelem elutasítva
• Előfizetési kérelem érkezett

Minden e-mail-sablonhoz tartozik egy egyszerű szöveges tárgysor és egy HTML formátumú szövegtörzsdefiníció. Minden elem igény szerint testre szabható.

Feljegyzés

A sablon HTML-tartalmának jól formázottnak kell lennie, és be kell tartania az XML-specifikációt. A   karakter nem engedélyezett.

Értesítési sablon megtekintése és konfigurálása a portálon:

1. Az oldalsáv menüjében válassza az Értesítési sablonok lehetőséget.

2. Válasszon ki egy értesítési sablont, és konfigurálja a sablont a szerkesztővel.

   

   • A Paraméterek lista tartalmazza azoknak a paramétereknek a listáját, amelyeket a tárgyba vagy törzsbe beszúrva az e-mail küldésekor a kijelölt érték vált fel.
   • Paraméter beszúrásához helyezze a kurzort oda, ahová a paramétert el szeretné helyezni, és válassza ki a paraméter nevét.

3. Az e-mail-sablon módosításainak mentéséhez válassza a Mentés vagy az Elvetés lehetőséget a módosítások megszakításához.

E-mail-beállítások konfigurálása

Módosíthatja az általános e-mail-beállításokat a API Management-példányból küldött értesítésekhez. Módosíthatja a rendszergazda e-mail-címét, az értesítéseket küldő szervezet nevét és a feladó e-mail-címét.

Fontos

A feladó e-mail-címének módosítása befolyásolhatja a címzettek e-mail-fogadási képességét. Tekintse meg a következő szakaszban ismertetett szempontokat .

Az e-mail-beállítások módosítása:

1. Az oldalsáv menüjében válassza az Értesítési sablonok lehetőséget.

2. Válassza az E-mail beállítások lehetőséget.

3. Az Általános e-mail-beállítások lapon adja meg a következő értékeket:

   • Rendszergazdai e-mail: az összes rendszerértesítés és egyéb konfigurált értesítés fogadásához szükséges e-mail-cím.

   • Szervezet neve: a szervezet neve a fejlesztői portálon és értesítésekben való használatra.

   • Feladó e-mail-címe: Az API Management-példány értesítéseinek Feladó fejlécének értéke. Az API Management e feladó cím nevében küld értesítéseket.

     

4. Válassza a Mentés lehetőséget.

A feladó e-mail-cím módosításának szempontjai

Az API Managementtől érkező e-mail-értesítések címzettjeire hatással lehet a feladó e-mail-címének módosítása.

• Módosítsa a Feladó címet: Amikor módosítja az eredeti e-mail-címet (például no-reply@contoso.com), a Feladó cím fejléce lesz noreply@contoso.com apimgmt-noreply@mail.windowsazure.com. Ennek az az oka, hogy az e-mailt az API Management küldi el, és nem az eredeti e-mail-cím e-mail-kiszolgálója.

• Levélszemét vagy levélszemét mappába küldött e-mailek: Előfordulhat, hogy egyes címzettek nem kapják meg az e-mail-értesítéseket az API Managementtől, vagy e-maileket küldhetnek a levélszemét vagy levélszemét mappába. Ez a szervezet SPF- vagy DKIM-alapú e-mail-hitelesítési beállításaitól függően történhet:

  • SPF-hitelesítés: Előfordulhat, hogy az e-mail-cím nem felel meg az SPF-hitelesítésnek, miután módosította az eredeti e-mail-címtartományt. A sikeres SPF-hitelesítés és az e-mailek kézbesítésének biztosításához hozza létre a következő TXT rekordot az e-mail-címben megadott tartomány DNS-adatbázisában. Ha például az e-mail-cím noreply@contoso.com, lépjen kapcsolatba a contoso.com rendszergazdájával a következő TXT rekord hozzáadásához: "v=spf1 include:spf.protection.outlook.com include:_spf-ssg-a.microsoft.com -all"

  • DKIM-hitelesítés: Ahhoz, hogy érvényes aláírást hozzon létre a DKIM számára az e-mail-hitelesítéshez, az API Management megköveteli a feladó e-mail-cím tartományához társított titkos kulcsot. Ezt a titkos kulcsot azonban jelenleg nem lehet feltölteni az API Managementbe. Ezért érvényes aláírás hozzárendeléséhez az API Management a tartományhoz mail.windowsazure.com társított titkos kulcsot használja.

Kapcsolódó tartalom

• A fejlesztői portál áttekintése
• Csoportok létrehozása és használata fejlesztői fiókok kezeléséhez