Сведения о настройке уведомлений и шаблонов уведомлений в службе управления API Azure

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Базовая версия 2 | Стандартный | Standard v2 | Премия

Служба управления API позволяет настраивать уведомления для определенных событий, а также почтовые шаблоны, которые используются для связи с администраторами и разработчиками экземпляра службы управления API. В этой статье показано, как настраивать уведомления и почтовые шаблоны для доступных событий.

Необходимые компоненты

Если у вас нет экземпляра службы управления API, выполните инструкции из краткого руководства Создание экземпляра службы управления API Azure.

Перейдите к экземпляру службы управления API.

1. На портале Azure найдите и выберите службы Управление API.

   

2. На странице Службы Управления API выберите экземпляр Управления API.

   

Настройка уведомлений на портале

1. В левой области навигации экземпляра Управления API выберите Уведомления, чтобы просмотреть доступные уведомления.

   Следующий список событий можно настроить для уведомлений.

   • Запросы на подписку (требуется утверждение) - Указанные получатели электронной почты и пользователи будут получать почтовые уведомления о запросах подписки на продукты, для которых требуются утверждение.
   • Новые подписки - Указанные получатели электронной почты и пользователи будут получать почтовые уведомления о новых подписках на продукты.
   • BCC - Указанные получатели электронной почты и пользователи будут получать слепые копии всех сообщений электронной почты, отправленных разработчикам.
   • Сообщение о закрытии учетной записи - Указанные получатели электронной почты и пользователи будут получать почтовые уведомления при закрытии учетной записи.
   • Приближается предельная квота подписок - Указанные получатели электронной почты и пользователи будут получать почтовые уведомления, когда использование подписок приблизится к квоте использования.

2. Выберите уведомление и укажите один или несколько адресов электронной почты, которые необходимо уведомить:

   • Чтобы добавить адрес электронной почты администратора, нажмите кнопку +Добавить администратора.
   • Чтобы добавить другой адрес электронной почты, выберите +Добавить адрес электронной почты, введите адрес электронной почты, и выберите Добавить.
   • Продолжайте добавлять адреса электронной почты по мере необходимости.

   

Настройка шаблонов уведомлений

Управление API предоставляет шаблоны уведомлений для административных сообщений электронной почты, которые автоматически отправляются разработчикам при доступе и использовании службы. Предоставляются следующие шаблоны уведомлений:

• Отправка в коллекцию приложений утверждена (нерекомендуемый)
• Прощальное письмо разработчика
• Уведомление о приближении предельной квоты разработчика
• Приветственное письмо разработчика
• Уведомление об изменении адреса электронной почты
• Пригласить пользователя
• Добавлен новый комментарий по проблеме (нерекомендуемый)
• Подтверждение новой учетной записи разработчика
• Получена новая проблема (нерекомендуемый)
• Активирована новая подписка
• Подтверждение изменения пароля
• Отклонение запроса подписки
• Получен запрос подписки

Каждый почтовый шаблон имеет тему в формате обычного текста и определение тела в формате HTML. При необходимости, можно настраивать каждый элемент.

Примечание.

Html-содержимое в шаблоне должно быть хорошо сформировано и соответствовать спецификации XML. Символ   не разрешен.

Чтобы просмотреть и настроить шаблон уведомлений на портале, выполните следующие действия:

1. В меню слева выберите Шаблоны решений.

2. Выберите шаблон уведомлений и настройте шаблон с помощью редактора.

   

   • Список Параметры содержит список параметров, которые в случае вставки в тему или тело будет заменен на заданное значение при отправке сообщения электронной почты.
   • Для вставки параметра поместите курсор в то место, куда необходимо вставить параметр, и выберите имя параметра.

3. Чтобы сохранить изменения в почтовом шаблоне, щелкнитеСохранить. Для отмены изменений щелкните Отклонить.

Настройка параметров электронной почты

Вы можете изменить общие параметры электронной почты для уведомлений, отправляемых из экземпляра управления API. Вы можете изменить адрес электронной почты администратора, имя организации, отправляющей уведомление, и исходный адрес электронной почты.

Внимание

Изменение исходного адреса электронной почты может повлиять на способность получателей получать электронную почту. Ознакомьтесь с рекомендациями в следующем разделе.

Чтобы изменить параметры электронной почты:

1. В меню слева выберите Шаблоны решений.
2. Выберите параметры электронной почты.
3. На странице "Общие параметры электронной почты" введите значения для следующих значений:

   • Адрес электронной почты администратора — адрес электронной почты для получения всех системных уведомлений и других настроенных уведомлений

   • Название организации — название вашей организации для использования на портале разработчика и уведомлениях

   • Исходный адрес электронной почты — значениеFrom заголовка для уведомлений из экземпляра Управления API. Управление API отправляет уведомления от имени этого исходного адреса.

     

4. Выберите Сохранить.

Рекомендации по изменению исходного адреса электронной почты

При изменении исходного адреса электронной почты могут повлиять получатели Уведомления по электронной почте из Управление API.

• Изменение адреса из адреса. При изменении исходного адреса электронной почты (например, на no-reply@contoso.com), From заголовок адреса будет иметь значение noreply@contoso.com apimgmt-noreply@mail.windowsazure.com. Это связано с тем, что сообщение отправляется Управление API, а не сервер электронной почты исходного адреса электронной почты.

• Папка "Нежелательная почта" или "Спам" — некоторые получатели могут не получать Уведомления по электронной почте из Управление API или сообщений электронной почты, которые могут отправляться в папку нежелательной почты или нежелательной почты. Это может произойти в зависимости от параметров проверки подлинности электронной почты или DKIM организации:

  • Проверка подлинности SPF— электронная почта больше не может передавать проверку подлинности SPF после изменения исходного домена адреса электронной почты. Чтобы обеспечить успешную проверку подлинности SPF и доставку электронной почты, создайте следующую запись TXT в базе данных DNS домена, указанного в адресе электронной почты. Например, если адрес электронной почты указан noreply@contoso.com, обратитесь к администратору contoso.com, чтобы добавить следующую запись TXT: "v=spf1 include:spf.protection.outlook.com include:_spf-ssg-a.microsoft.com -all"

  • Проверка подлинности DKIM . Чтобы создать допустимую подпись для DKIM для проверки подлинности электронной почты, Управление API требует закрытый ключ, связанный с доменом исходного адреса электронной почты. Однако в настоящее время невозможно передать этот закрытый ключ в Управление API. Поэтому для назначения допустимой подписи Управление API использует закрытый ключ, связанный с доменомmail.windowsazure.com.

Следующие шаги

• Общие сведения о портале разработчика.
• Как создавать и использовать группы для управления учетными записями разработчика