Перейти к основному содержимому

Apple Safari

Для настройки Web Push в браузер Safari необходимо иметь расширение Developer в Apple аккаунте.
предупреждение

Все действия выполняются на macOS X устройстве.

Отправка пушей в PWA приложения

В версиях iOS 16.4+ Apple добавила поддержку push-уведомлений от PWA-приложений.

PWA (от англ. "progressive web app") — это технология, которая позволяет установить сайт на смартфон или на компьютер как приложение. Установка не требует загрузки через магазин приложений — пользователь просто заходит на сайт и добавляет иконку на рабочий стол своего устройства. Такое приложение обладает функционалом нативного мобильного приложения: оно может работать в автономном офлайн режиме, кэшировать данные и принимать пуши.

Чтобы отправлять push-уведомления пользователям PWA-приложений, необходимо настроить провайдер APNS для Safari в ресурсе. При сохранении настроек автоматически подключится провайдер PWA.

Обратите внимание, идентификатор подписки на PWA пуши привязан к конкретному ресурсу. Если вы перенесёте подписки из одного ресурса в другой, они не будут работать.

Шаг 1. Регистрация нового идентификатора

1. Перейдите по ссылке https://developer.apple.com/account/ios/certificate (Certificates, Identifiers & Profiles) и войдите в аккаунт разработчика Apple.

2. Слева в панели навигации выберите вкладку "Identifiers" и нажмите на значок + рядом с заголовком "Identifiers":

3. В открывшемся окне выберите Website Push IDs, поскольку мы хотим отправлять пуш-уведомления на устройства macOS с веб-сайта:

4. Введите Description (Описание) и Identifier (Идентификатор).

подсказка

Идентификатор должен иметь формат web.com.domainname.appname.

Важно! Первая часть всегда — web. Частей может быть сколько угодно, но в разумных пределах. Рекомендуется использовать стиль обратного домена, например, web.org.example.push.


5. Нажмите кнопки Continue, затем Register.

Итак, вы создали и зерегистрировали Website Push ID. Теперь вы можете в любой момент посмотреть информацию об этом идентификаторе на вкладке "Identifiers":

подсказка

Чтобы увидеть идентификаторы для рассылки push уведомлений именно с веб-сайтов, откройте выпадающий список в правом углу и выберите Website Push IDs.

Шаг 2. Создание сертификата

1. Для каждого идентификатора требуется Сертификат. Найдите только что созданный Web Push ID в списке и кликните по нему.

2. Обратите внимание на поле "Identifier". Информация из этого поля потребуется для настройки ресурса в платформе Altcraft, а именно — при заполнении поля Website Push ID.

3. Нажмите "Create Certificate", чтобы создать сертификат:

4. Теперь необходимо сгенерировать Сертификат. Для этого требуется Certificate Signing Request (CSR) (формат запроса - .certSigningRequest). Для создания запроса кликните Learn more:

5. Откроется новая страница. Следуйте инструкциям, приведённым на ней.

6. После создания Certificate Signing Request вернитесь на предыдущую страницу. Нажмите "Choose File" и выберите созданный CSR.

7. Нажмите "Continue".

Шаг 3. Сохранение сертификата

1. На следующей странице нажмите "Download", чтобы скачать сертификат в формате .cer на ваш Mac:

2. Найдите загруженный файл на вашем устройстве и дважды кликните по нему, чтобы установить его в Keychain:

3. Найдите установленный сертификат в Keychain, кликните правой кнопкой мыши и экспортируйте его на диск в формате .p12:

4. В процессе экспорта вам будет предложено ввести пароль. Запомните этот пароль, поскольку он потребуется для настройки push-рассылок в платформе Altcraft.

Шаг 4. Настройка ресурса в платформе Altcraft

1. Вернитесь в платформу Altcraft и откройте настройки ресурса, в рамках которого вы хотите настроить рассылку браузерных push-уведомлений. Перейдите в настройки push-канала.

2. Выберите платформу Safari и активируете сервис Apple Safari:

3. Заполните следующие поля:

  • Website Push ID — идентификатор в аккаунте разработчика Apple. Это значение берется из поля "Identifier" в вашем Apple Developer аккаунте.

  • Website Client SSL Certificate — файл сертификата с расширением .p12. Этот сертификат экспортируется из Keychain Access на вашем Mac-устройстве.

  • Website Client SSL Certificate пароль — пароль, использованный при экспорте сертификата .p12

  • API token — токен платформы. Позволяет APNS отправлять запросы на подписку в платформу. Создать токен можно в разделе Настройки → Токены. Если токен удалить, платформа перестанет принимать подписки от Safari для данного ресурса.

  • Иконка — изображение в формате .png, которое будет показано в push-уведомлении. Иконка помогает пользователю идентифицировать источник уведомления. Рекомендуется использовать размер 256x256 пикселей или больше. Safari поддерживает только одно изображение для ресурса (веб-сайта).

подсказка