Meldingen en meldingssjablonen configureren in Azure API Management

VAN TOEPASSING OP: Ontwikkelaar | Basic | Basic v2 | Standaard | Standard v2 | Premium | Premium v2

Met Azure API Management kunt u e-mailmeldingen configureren voor specifieke gebeurtenissen en de e-mailsjablonen configureren die worden gebruikt om te communiceren met de beheerders en ontwikkelaars van een API Management-exemplaar. Dit artikel laat zien hoe u meldingen configureert voor de beschikbare gebeurtenissen en biedt een overzicht van het configureren van de e-mailsjablonen die voor deze gebeurtenissen worden gebruikt.

Vereisten

Als u geen exemplaar van de API Management-service hebt, voltooi dan de volgende quickstart: Een Azure API Management-exemplaar maken.

Ga naar uw API Management-instantie

1. Zoek en selecteer in de Azure portalde API Management-services:

   

2. Selecteer op de pagina API Management-services uw API Management-exemplaar:

   

Meldingen configureren in Azure Portal

1. Selecteer In het zijbalkmenu van uw API Management-exemplaar de optie Implementatie en infrastructuur en kies vervolgens Meldingen om de beschikbare meldingen weer te geven.

   De volgende lijst met gebeurtenissen kan worden geconfigureerd voor meldingen.

   • Abonnementsaanvragen (waarvoor goedkeuring is vereist): de opgegeven e-mailontvangers en gebruikers ontvangen e-mailmeldingen over abonnementsaanvragen voor producten waarvoor goedkeuring is vereist.
   • Nieuwe abonnementen: de opgegeven e-mailontvangers en gebruikers ontvangen e-mailmeldingen over nieuwe productabonnementen.
   • Aanvragen voor toepassingsgalerie: de volgende e-mailontvangers en gebruikers ontvangen e-mailmeldingen wanneer nieuwe toepassingen worden verzonden naar de toepassingsgalerie.
   • BCC: de opgegeven e-mailontvangers en gebruikers ontvangen e-mailblind carbon kopieën van alle e-mailberichten die naar ontwikkelaars worden verzonden.
   • Nieuw probleem of opmerking: de volgende e-mailontvangers en gebruikers ontvangen e-mailmeldingen wanneer er een nieuw probleem of opmerking wordt verzonden in de ontwikkelaarsportal.
   • Accountbericht sluiten: de opgegeven e-mailontvangers en gebruikers ontvangen e-mailmeldingen wanneer een account wordt gesloten.
   • Limiet voor abonnementsquotum naderen: de opgegeven e-mailontvangers en gebruikers ontvangen e-mailmeldingen wanneer het abonnementsgebruik dicht bij het gebruiksquotum komt.

2. Selecteer een melding en geef een of meer e-mailadressen op die moeten worden gewaarschuwd:

   • Als u het e-mailadres van de beheerder wilt toevoegen, selecteert u + Beheerder toevoegen.
   • Als u nog een e-mailadres wilt toevoegen, selecteert u + E-mailadres toevoegen, voert u een e-mailadres in en selecteert u Toevoegen.
   • Ga zo nodig door met het toevoegen van e-mailadressen.

   

Meldingssjablonen configureren

API Management biedt meldingssjablonen voor de beheer-e-mailberichten die automatisch naar ontwikkelaars worden verzonden wanneer ze de service openen en gebruiken. De volgende meldingssjablonen zijn beschikbaar:

• Afscheidsbrief voor ontwikkelaars
• Quotumlimiet voor ontwikkelaars nadert melding
• Welkomstbrief voor ontwikkelaars
• Melding voor e-mailwijziging
• Gebruiker uitnodigen
• Bevestiging van nieuwe ontwikkelaarsaccount
• Nieuw abonnement geactiveerd
• Bevestiging van wachtwoordwijziging
• Abonnementsaanvraag geweigerd
• Ontvangen abonnementsaanvraag

Elke e-mailsjabloon heeft een onderwerpregel in tekst zonder opmaak en een hoofdtekstdefinitie in HTML-indeling. Elk item kan naar wens worden aangepast.

Een meldingssjabloon weergeven en configureren in de portal:

1. Selecteer Meldingssjablonen in het zijbalkmenu.

2. Selecteer een meldingssjabloon en configureer de sjabloon met behulp van de editor.

   

   • De lijst Parameters bevat een lijst met parameters die, wanneer deze worden ingevoegd in het onderwerp of de hoofdtekst, worden vervangen door de aangewezen waarde wanneer het e-mailbericht wordt verzonden.
   • Als u een parameter wilt invoegen, plaatst u de cursor op de plaats waar u de parameter wilt plaatsen en selecteert u de parameternaam.

3. Als u wijzigingen in de e-mailsjabloon wilt opslaan, selecteert u Opslaan of selecteert u Verwijderen om de wijzigingen te annuleren.

E-mailinstellingen configureren

U kunt algemene e-mailinstellingen wijzigen voor meldingen die worden verzonden vanuit uw API Management-exemplaar. U kunt het e-mailadres van de beheerder, de naam van de organisatie die meldingen verzendt en het e-mailadres van de afzender wijzigen.

E-mailinstellingen wijzigen:

1. Selecteer Meldingssjablonen in het zijbalkmenu.

2. Selecteer E-mailinstellingen.

3. Voer op de pagina Algemene e-mailinstellingen waarden in voor:

   • E-mailadres van beheerder: het e-mailadres voor het ontvangen van alle systeemmeldingen en andere geconfigureerde meldingen.

   • Organisatienaam: de naam van uw organisatie voor gebruik in de ontwikkelaarsportal en meldingen.

   • Oorspronkelijk e-mailadres: de waarde van de header From voor meldingen van het API Management-exemplaar. API Management verzendt meldingen namens dit oorspronkelijke adres.

     

4. Selecteer Opslaan.

Overwegingen voor het wijzigen van het oorspronkelijke e-mailadres

Ontvangers van e-mailmeldingen van API Management kunnen worden beïnvloed wanneer u het oorspronkelijke e-mailadres wijzigt.

• Wijzig het Van-adres: Wanneer u het oorspronkelijke e-mailadres wijzigt (bijvoorbeeld in no-reply@contoso.com), zal de koptekst noreply@contoso.com apimgmt-noreply@mail.windowsazure.com zijn. Dit komt doordat het e-mailbericht wordt verzonden door API Management en niet de e-mailserver van het oorspronkelijke e-mailadres.

• E-mail die wordt verzonden naar de map ongewenste e-mail of spam: sommige geadresseerden ontvangen mogelijk niet de e-mailmeldingen van API Management of e-mailberichten worden verzonden naar de map ongewenste e-mail of spam. Dit kan gebeuren, afhankelijk van de SPF- of DKIM-e-mailverificatie-instellingen van de organisatie:

  • SPF-verificatie: E-mail geeft SPF-verificatie mogelijk niet meer door nadat u het oorspronkelijke e-mailadresdomein hebt gewijzigd. Maak de volgende TXT-record in de DNS-database van het domein dat is opgegeven in het e-mailadres om een geslaagde SPF-verificatie en -bezorging van e-mail te garanderen. Als het e-mailadres bijvoorbeeld noreply@contoso.com is, neem dan contact op met de beheerder van contoso.com om de volgende TXT-record toe te voegen: "v=spf1 include:spf.protection.outlook.com include:_spf-ssg-a.microsoft.com -all"

  • DKIM-verificatie: Voor het genereren van een geldige handtekening voor DKIM voor e-mailverificatie vereist API Management de persoonlijke sleutel die is gekoppeld aan het domein van het oorspronkelijke e-mailadres. Het is momenteel echter niet mogelijk om deze persoonlijke sleutel te uploaden in API Management. Om een geldige handtekening toe te wijzen, gebruikt API Management daarom de persoonlijke sleutel die aan het mail.windowsazure.com domein is gekoppeld.

Verwante inhoud

• Overzicht van de ontwikkelaarsportal
• Groepen maken en gebruiken om ontwikkelaarsaccounts te beheren