Краткое руководство: Настройка push-уведомлений в центре уведомлений

2025-05-03

Центры уведомлений Azure предоставляют обработчик push-уведомлений, который легко использовать и масштабируется. Используйте центры уведомлений для отправки уведомлений на любую платформу (iOS, Android, Windows) и из любой серверной части (облачной или локальной). Дополнительные сведения см. в статье Что такое Центры уведомлений Azure?.

В этом кратком руководстве вы используете параметры системы уведомлений платформы (PNS) в Центрах уведомлений для настройки push-уведомлений на нескольких платформах. В кратком руководстве показано, как выполнить действия при использовании портала Azure. Раздел Google Firebase Cloud Messaging содержит инструкции по использованию Azure CLI.

Примечание.

Сведения об устаревании и миграции Firebase Cloud Messaging см. в разделе Миграция Google Firebase Cloud Messaging.

Если вы еще не создали концентратор уведомлений, создайте его. Дополнительные сведения см. в кратких руководствах по созданию центра уведомлений Azure с помощью портала Azure и Azure CLI.

Служба push-уведомлений Apple

Чтобы настроить Службу push-уведомлений Apple (APNS), сделайте следующее:

На портале Azure на странице Центр уведомлений выберите Apple (APNS) в меню слева.
В разделе Режим проверки подлинности выберите Сертификат или Токен.
1. Если вы выбрали Сертификат:
  - Щелкните значок файла и выберите файл .p12, который нужно отправить.
  - Введите пароль.
  - Выберите режим Песочница. Если нужно отправлять push-уведомления пользователям, которые приобрели приложение в магазине, выберите режим Рабочий.
2. Если вы выбрали Токен:
  - Введите значения для параметров Идентификатор ключа, Идентификатор набора, Идентификатор команды и Токен.
  - Выберите режим Песочница. Если нужно отправлять push-уведомления пользователям, которые приобрели приложение в магазине, выберите режим Рабочий.

Для получения дополнительной информации см. Отправка push-уведомлений в приложения iOS с помощью Центров уведомлений Azure.

Google Firebase Cloud Messaging версия 1 (FCMv1)

Чтобы настроить push-уведомления для Google FCMv1, выполните приведенные действия.

На портале Azure на странице Центр уведомлений выберите Google (FCMv1) в меню слева.
Обновите значения закрытого ключа, идентификатора проекта и электронной почты клиента из JSON-файла учетной записи службы, полученного из консоли Firebase.
Выберите Сохранить.

Снимок экрана: настройка центров уведомлений для Google FCMv1.

Когда вы выполните эти шаги, появится оповещение о том, что Центр уведомлений успешно обновлен. Кнопка Сохранить отключена.

Google Firebase Cloud Messaging (FCM)

Примечание.

Firebase Cloud Messaging (FCM) устарел и больше не поддерживается.

Портал
Azure CLI

Чтобы настроить push-уведомления для Google FCM:

На портале Azure на странице Центр уведомлений выберите Google (GCM/FCM) в меню слева.
В соответствующее поле вставьте ключ API для проекта Google FCM, сохраненного ранее.
Выберите Сохранить.

Вам нужен ключ API для проекта Google Firebase Cloud Messaging (FCM).

Подготовка среды к работе с Azure CLI

Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".
Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
- Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".
- Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений и управление ими с помощью Azure CLI.
- Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Для работы с этой статьей требуется Azure CLI версии 2.0.67 или более поздней. Если вы используете Azure Cloud Shell, последняя версия уже установлена.

Настройка push-уведомлений для Google FCM

Чтобы добавить ключ API Google в центр уведомлений, используйте команду az notification-hub credential gcm update.
```
az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
```
Для подключения к центру уведомлений приложению Android нужна строка подключения. Чтобы получить список доступных политик доступа, используйте команду az notification-hub authorization-rule list. Чтобы получить строки подключения к политике доступа, используйте команду az notification-hub authorization-rule list-keys. Чтобы получить непосредственно основную строку подключения, укажите primaryConnectionString или secondaryConnectionString в параметре --query.
```
#list access policies for a notification hub
az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table

#list keys and connection strings for a notification hub access policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json

#get the primaryConnectionString for an access policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
```

Чтобы протестировать отправку сообщений в приложение Android, используйте команду az notification-hub test-send.

#test with message body
az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"

#test with JSON string
az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"

Вы можете получить ссылки Azure CLI для других платформ с помощью команды az notification-hub credential .

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

Служба push-уведомлений Windows

Чтобы настроить службу push-уведомлений Windows (WNS), сделайте следующее:

На портале Azure на странице Центр уведомлений выберите Windows (WNS) в меню слева.
Введите значения для идентификатора безопасности пакета и ключа безопасности.
Выберите Сохранить.

Дополнительные сведения см. в статье Руководство по отправке уведомлений в приложения универсальной платформы Windows с использованием Центров уведомлений Azure.

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

Дополнительные сведения см. в статье Начало работы с Центрами уведомлений с помощью Baidu.

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

В этом кратком руководстве вы узнали, как настроить параметры системы отправки уведомлений платформы для центра уведомлений на портале Azure.

Дополнительные сведения о том, как отправлять push-уведомления на различные платформы, см. в следующих учебниках: