Jak skonfigurować powiadomienia i szablony powiadomień w usłudze Azure API Management

DOTYCZY: Developer | Podstawowa | Podstawowa, wersja 2 | Standardowa | Standardowa, wersja 2 | Premium | Premium, wersja 2

Usługa Azure API Management umożliwia konfigurowanie powiadomień e-mail dla określonych zdarzeń oraz konfigurowanie szablonów poczty e-mail używanych do komunikowania się z administratorami i deweloperami wystąpienia usługi API Management. W tym artykule pokazano, jak skonfigurować powiadomienia dla dostępnych zdarzeń i przedstawiono omówienie konfigurowania szablonów wiadomości e-mail używanych na potrzeby tych zdarzeń.

Wymagania wstępne

Jeśli nie masz wystąpienia usługi API Management, wykonaj czynności opisane w następującym przewodniku „Szybki start”: Tworzenie wystąpienia usługi Azure API Management.

Przejdź do wystąpienia API Management

1. W portalu Azure wyszukaj i wybierz usługi API Management.

   

2. Na stronie usług API Management wybierz wystąpienie usługi API Management:

   

Konfigurowanie powiadomień w witrynie Azure Portal

1. Z menu paska bocznego wystąpienia usługi API Management wybierz pozycję Wdrażanie i infrastruktura, a następnie wybierz pozycję Powiadomienia , aby wyświetlić dostępne powiadomienia.

   Na potrzeby powiadomień można skonfigurować następującą listę zdarzeń.

   • Żądania subskrypcji (wymagające zatwierdzenia): określeni adresaci poczty e-mail i użytkownicy otrzymują powiadomienia e-mail dotyczące żądań subskrypcji dotyczących produktów wymagających zatwierdzenia.
   • Nowe subskrypcje: określeni adresaci poczty e-mail i użytkownicy otrzymują powiadomienia e-mail dotyczące nowych subskrypcji produktów.
   • Żądania galerii aplikacji: następujący adresaci poczty e-mail i użytkownicy otrzymują powiadomienia e-mail po przesłaniu nowych aplikacji do galerii aplikacji.
   • BCC: Określeni odbiorcy i użytkownicy otrzymują kopie ukryte wszystkich wiadomości e-mail wysyłanych do deweloperów.
   • Nowy problem lub komentarz: następujący adresaci poczty e-mail i użytkownicy otrzymują powiadomienia e-mail po przesłaniu nowego problemu lub komentarza w portalu deweloperów.
   • Zamknij wiadomość o koncie: określeni adresaci poczty e-mail i użytkownicy otrzymują powiadomienia e-mail po zamknięciu konta.
   • Zbliżanie się do limitu przydziału subskrypcji: określeni adresaci poczty e-mail i użytkownicy otrzymują powiadomienia e-mail, gdy użycie subskrypcji zbliża się do limitu przydziału użycia.

2. Wybierz powiadomienie i określ co najmniej jeden adres e-mail, który ma zostać powiadomiony:

   • Aby dodać adres e-mail administratora, wybierz pozycję + Dodaj administratora.
   • Aby dodać kolejny adres e-mail, wybierz pozycję + Dodaj wiadomość e-mail, wprowadź adres e-mail i wybierz pozycję Dodaj.
   • Kontynuuj dodawanie adresów e-mail zgodnie z potrzebami.

   

Konfigurowanie szablonów powiadomień

Usługa API Management udostępnia szablony powiadomień dla administracyjnych wiadomości e-mail, które są wysyłane automatycznie do deweloperów podczas uzyskiwania dostępu do usługi i korzystania z nich. Dostępne są następujące szablony powiadomień:

• List pożegnalny dla deweloperów
• Powiadomienie: zbliża się limit przydziału dla deweloperów
• List powitalny dla deweloperów
• Powiadomienie o zmianie wiadomości e-mail
• Zaproś użytkownika
• Potwierdzenie nowego konta dewelopera
• Aktywowano nową subskrypcję
• Potwierdzenie zmiany hasła
• Odrzucono żądanie subskrypcji
• Odebrano żądanie subskrypcji

Każdy szablon wiadomości e-mail ma wiersz tematu w postaci zwykłego tekstu i definicję treści w formacie HTML. Każdy element można dostosować zgodnie z potrzebami.

Uwaga

Zawartość HTML w szablonie musi być dobrze sformułowana i zgodna ze specyfikacją XML. Znak   nie jest dozwolony.

Aby wyświetlić i skonfigurować szablon powiadomienia w portalu:

1. W menu paska bocznego wybierz pozycję Szablony powiadomień.

2. Wybierz szablon powiadomienia i skonfiguruj szablon przy użyciu edytora.

   

   • Lista Parametry zawiera listę parametrów, które po wstawieniu do tematu lub treści są zastępowane przez wyznaczoną wartość podczas wysyłania wiadomości e-mail.
   • Aby wstawić parametr, umieść kursor w miejscu, w którym chcesz umieścić parametr, a następnie wybierz nazwę parametru.

3. Aby zapisać zmiany w szablonie wiadomości e-mail, wybierz pozycję Zapisz lub wybierz pozycję Odrzuć , aby anulować zmiany.

Konfigurowanie ustawień poczty e-mail

Możesz zmodyfikować ogólne ustawienia poczty e-mail dla powiadomień wysyłanych z instancji usługi API Management. Możesz zmienić adres e-mail administratora, nazwę organizacji wysyłającej powiadomienia oraz źródłowy adres e-mail.

Ważne

Zmiana źródłowego adresu e-mail może mieć wpływ na możliwość odbierania wiadomości e-mail przez adresatów. Zapoznaj się z zagadnieniami w poniższej sekcji.

Aby zmodyfikować ustawienia poczty e-mail:

1. W menu paska bocznego wybierz pozycję Szablony powiadomień.

2. Wybierz pozycję Ustawienia poczty e-mail.

3. Na stronie Ogólne ustawienia poczty e-mail wprowadź wartości dla:

   • Adres e-mail administratora: adres e-mail do odbierania wszystkich powiadomień systemowych i innych skonfigurowanych powiadomień.

   • Nazwa organizacji: nazwa organizacji do użycia w portalu deweloperów i powiadomieniach.

   • Źródłowy adres e-mail: wartość nagłówka From dla powiadomień z instancji zarządzania API. Usługa API Management wysyła powiadomienia w imieniu tego adresu źródłowego.

     

4. Wybierz pozycję Zapisz.

Zagadnienia dotyczące zmiany źródłowego adresu e-mail

Odbiorcy powiadomień e-mail z usługi API Management mogą zostać dotknięci zmianą adresu e-mail, z którego wysyłane są powiadomienia.

• Zmień adres Od: Po zmianie źródłowego adresu e-mail (na przykład na no-reply@contoso.com), nagłówek adresu Od będzie ustawiony na noreply@contoso.com apimgmt-noreply@mail.windowsazure.com. Dzieje się tak, ponieważ wiadomość e-mail jest wysyłana za pośrednictwem usługi zarządzania API, a nie przez serwer pocztowy powiązany z oryginalnym adresem e-mail.

• Wiadomość e-mail wysłana do folderu wiadomości-śmieci lub spamu: niektórzy adresaci mogą nie otrzymywać powiadomień e-mail z usługi API Management lub wiadomości e-mail mogą zostać wysłane do folderu wiadomości-śmieci lub spamu. Może się to zdarzyć w zależności od ustawień uwierzytelniania e-mail SPF lub DKIM organizacji.

  • Uwierzytelnianie SPF: wiadomość e-mail może przestać przechodzić przez uwierzytelnianie SPF po zmianie domeny źródłowej adresu e-mail. Aby zapewnić pomyślne uwierzytelnianie SPF i dostarczanie wiadomości e-mail, utwórz następujący rekord TXT w bazie danych DNS domeny określonej w adresie e-mail. Jeśli na przykład adres e-mail to noreply@contoso.com, skontaktuj się z administratorem contoso.com, aby dodać następujący rekord TXT: "v=spf1 include:spf.protection.outlook.com include:_spf-ssg-a.microsoft.com -all"

  • Uwierzytelnianie DKIM: aby wygenerować prawidłowy podpis dla uwierzytelniania za pomocą poczty e-mail, usługa API Management wymaga klucza prywatnego skojarzonego z domeną źródłowego adresu e-mail. Nie można jednak obecnie przesłać tego klucza prywatnego w zarządzaniu API. W związku z tym w celu przypisania prawidłowego podpisu usługa API Management używa klucza prywatnego skojarzonego z domeną mail.windowsazure.com .

Powiązana zawartość

• Omówienie portalu dla deweloperów
• Jak tworzyć i używać grup do zarządzania kontami deweloperów