Konfigurieren von Benachrichtigungen und Benachrichtigungsvorlagen in Azure API Management

GILT FÜR: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2

Mit Azure API Management können Sie E-Mail-Benachrichtigungen für bestimmte Ereignisse konfigurieren und die E-Mail-Vorlagen konfigurieren, die für die Kommunikation mit den Administratoren und Entwicklern einer API-Verwaltungsinstanz verwendet werden. Dieser Artikel beschreibt die Konfiguration von Benachrichtigungen für verfügbare Ereignisse und bietet eine Übersicht über die Konfiguration der E-Mail-Vorlagen für diese Ereignisse.

Voraussetzungen

Wenn Sie über keine API Management-Dienstinstanz verfügen, absolvieren Sie den folgenden Schnellstart: Erstellen einer Azure API Management-Instanz.

Navigieren zur API Management-Instanz

1. Suchen Sie im Azure-Portal nach API-Verwaltungsdiensten, und wählen Sie sie aus:

   

2. Wählen Sie auf der Seite "API-Verwaltungsdienste " Ihre API-Verwaltungsinstanz aus:

   

Konfigurieren von Benachrichtigungen im Azure-Portal

1. Wählen Sie im Seitenmenü Ihrer API-Management-Instanz Deployment + Infrastruktur aus und wählen Sie dann Benachrichtigungen , um die verfügbaren Benachrichtigungen anzuzeigen.

   Sie können die folgende Liste von Ereignissen für Benachrichtigungen konfigurieren.

   • Abonnementanforderungen (genehmigung erforderlich): Die angegebenen E-Mail-Empfänger und Benutzer erhalten E-Mail-Benachrichtigungen zu Abonnementanforderungen für Produkte, die eine Genehmigung erfordern.
   • Neue Abonnements: Die angegebenen E-Mail-Empfänger und Benutzer erhalten E-Mail-Benachrichtigungen zu neuen Produktabonnements.
   • Anwendungskataloganforderungen: Die folgenden E-Mail-Empfänger und Benutzer erhalten E-Mail-Benachrichtigungen, wenn neue Anwendungen an den Anwendungskatalog übermittelt werden.
   • BCC: Die angegebenen E-Mail-Empfänger und Benutzer erhalten blinde Kopien aller E-Mails, die an Entwickler gesendet wurden.
   • Neues Problem oder Kommentar: Die folgenden E-Mail-Empfänger und Benutzer erhalten E-Mail-Benachrichtigungen, wenn ein neues Problem oder ein neuer Kommentar im Entwicklerportal übermittelt wird.
   • Kontonachricht schließen: Die angegebenen E-Mail-Empfänger und Benutzer erhalten E-Mail-Benachrichtigungen, wenn ein Konto geschlossen wird.
   • Näherung des Kontingentlimits für Abonnements: Die angegebenen E-Mail-Empfänger und Benutzer erhalten E-Mail-Benachrichtigungen, wenn die Abonnementnutzung dem Nutzungskontingent nahe kommt.

2. Wählen Sie eine Benachrichtigung aus, und geben Sie mindestens eine E-Mail-Adresse an, die benachrichtigt werden soll:

   • Zum Hinzufügen der E-Mail-Adresse des Administrators wählen Sie + Administrator hinzufügen aus.
   • Wenn Sie eine weitere E-Mail-Adresse hinzufügen möchten, wählen Sie + E-Mail-Adresse hinzufügen aus, geben Sie eine E-Mail-Adresse ein, und wählen Sie Hinzufügen aus.
   • Fügen Sie nach Bedarf weitere E-Mail-Adressen hinzu.

   

Konfigurieren von Benachrichtigungsvorlagen

API-Management stellt Benachrichtigungsvorlagen für die administrativen E-Mail-Nachrichten bereit, die es automatisch an Entwickler sendet, wenn sie auf den Dienst zugreifen und ihn nutzen. Die folgenden Benachrichtigungsvorlagen sind verfügbar:

• Entwickler-Abschiedsbrief
• Entwickler-Nutzungskontingent beinahe erreicht
• Entwickler-Begrüßungsschreiben
• Benachrichtigung über Änderung der E-Mail-Adresse
• Benutzer einladen
• Bestätigung für neues Entwicklerkonto
• Neues Abonnement aktiviert
• Bestätigung der Kennwortänderung
• Abonnementanforderung abgelehnt
• Abonnementerneuerung erhalten

Jede E-Mail-Vorlage enthält eine Betreffzeile im Nur-Text-Format und eine Textkörperdefinition im HTML-Format. Du kannst jeden Gegenstand nach Belieben anpassen.

So wird eine Benachrichtigungsvorlage im Portal angezeigt und konfiguriert:

1. Wählen Sie im Randleistenmenü Benachrichtigungsvorlagen aus.

2. Wählen Sie eine Benachrichtigungsvorlage aus und konfigurieren Sie die Vorlage mithilfe des Editors.

   

   • Die Parameterliste enthält eine Liste von Parametern, die beim Einfügen in den Betreff oder Textkörper durch den festgelegten Wert ersetzt werden, wenn die E-Mail gesendet wird.
   • Um einen Parameter einzufügen, platziere den Cursor dort, wo du den Parameter haben möchtest, und wähle den Parameternamen aus.

3. Um Änderungen an der E-Mail-Vorlage zu speichern, wählen Sie Speichern. Wählen Sie Abwurf, um die Änderungen zu widerrufen.

Konfigurieren von E-Mail-Einstellungen

Sie können allgemeine E-Mail-Einstellungen für Benachrichtigungen ändern, die von Ihrer API Management-Instanz gesendet werden. Sie können die E-Mail-Adresse des Administrators, den Namen der Organisation, die Benachrichtigungen sendet, und die Ursprungs-E-Mail-Adresse ändern.

So ändern Sie E-Mail-Einstellungen:

1. Wählen Sie im Randleistenmenü Benachrichtigungsvorlagen aus.

2. Wählen Sie E-Mail-Einstellungen aus.

3. Geben Sie auf der Seite "Allgemeine E-Mail-Einstellungen " Werte für Folgendes ein:

   • Administrator-E-Mail: die E-Mail-Adresse zum Empfangen aller Systembenachrichtigungen und anderer konfigurierter Benachrichtigungen.

   • Name der Organisation: der Name Ihrer Organisation für die Verwendung im Entwicklerportal und Benachrichtigungen.

   • Absender-E-Mail-Adresse: Der Wert des From-Headers für Benachrichtigungen aus der API-Verwaltungsinstanz. API Management sendet Benachrichtigungen im Namen dieser Ursprungsadresse.

     

4. Wählen Sie Speichern aus.

Überlegungen zum Ändern der ursprünglichen E-Mail-Adresse

Die Änderung der ursprünglichen E-Mail-Adresse kann Empfänger von E-Mail-Benachrichtigungen aus API-Management beeinflussen.

• Die From-Adresse ändern: Wenn Sie die ursprüngliche E-Mail-Adresse ändern (zum Beispiel auf no-reply@contoso.com), ist der From-Adress-Header .noreply@contoso.com apimgmt-noreply@mail.windowsazure.com Diese Adresse erscheint, weil das API-Management die E-Mail versendet, nicht der E-Mail-Server der ursprünglichen E-Mail-Adresse.

• An Junk- oder Spamordner gesendete E-Mails: Einige Empfänger erhalten möglicherweise keine E-Mail-Benachrichtigungen aus der API-Verwaltung, oder E-Mails werden an den Junk- oder Spamordner gesendet. Dieses Problem kann je nach SPF- oder DKIM-E-Mail-Authentifizierungseinstellungen der Organisation auftreten:

  • SPF-Authentifizierung: E-Mail übergibt möglicherweise keine SPF-Authentifizierung mehr, nachdem Sie die ursprüngliche E-Mail-Adressdomäne geändert haben. Um eine erfolgreiche SPF-Authentifizierung und E-Mail-Zustellung sicherzustellen, erstellen Sie den folgenden TXT-Eintrag in der DNS-Datenbank der Domäne, die in der E-Mail-Adresse angegeben ist. Wenn die E-Mail-Adresse beispielsweise noreply@contoso.com ist, wenden Sie sich an den Administrator von contoso.com, um den folgenden TXT-Eintrag hinzuzufügen: "v=spf1 include:spf.protection.outlook.com include:_spf-ssg-a.microsoft.com -all"

  • DKIM-Authentifizierung: Um eine gültige Signatur für DKIM für die E-Mail-Authentifizierung zu generieren, erfordert die API-Verwaltung den privaten Schlüssel, der der Domäne der ursprünglichen E-Mail-Adresse zugeordnet ist. Allerdings kannst du diesen privaten Schlüssel derzeit nicht im API-Management hochladen. Um eine gültige Signatur zuzuweisen, verwendet API Management daher den privaten Schlüssel, der der Domäne mail.windowsazure.com zugeordnet ist.

Verwandte Inhalte

• Übersicht über das Entwicklerportal
• Erstellen und Verwenden von Gruppen für Entwicklerkonten