Доверие службы к подключению устройства

APNs устанавливает идентификационные данные соединительного устройства через TLS одноранговая аутентификация. (Обратите внимание на то, что система заботится об этом этапе доверия соединения; Вы ничего не должны реализовывать сами.) В ходе этой процедуры устройство инициирует соединение TLS с APNs, возвращающим его сертификат сервера. Устройство проверяет этот сертификат и затем отправляет его сертификат устройства в APNs, проверяющий тот сертификат.

Доверие провайдера к соединению услуг

Доверительные отношения соединения между провайдером и APNs также установлены через TLS одноранговая аутентификация. Процедура подобна описанному в Доверии Службы к подключению устройства. Провайдер инициирует соединение TLS, получает сертификат сервера от APNs и проверяет тот сертификат. Тогда провайдер отправляет свой сертификат провайдера APNs, проверяющему его на его конце. Как только эта процедура завершена, безопасное соединение TLS было установлено; APNs теперь удовлетворен, что соединение было сделано законным провайдером.

Обратите внимание на то, что соединение провайдера допустимо для поставки только одному определенному приложению, идентифицированный темой (свяжите ID), указанный в сертификате. APNs также поддерживает список аннулированных сертификатов; если сертификат провайдера находится в этом списке, APNs может аннулировать управление имуществом по доверенности провайдера (т.е. отказаться от соединения).

Маркерная генерация и рассредоточение

Приложения должны зарегистрироваться для получения удаленных уведомлений; это обычно делает это правильно после того, как это будет установлено на устройстве. (Эта процедура описана в Планировании, Регистрации и Обработке Уведомлений.) Система получает регистрационный запрос от приложения, соединяется с APNs и передает запрос. APNs генерирует маркер устройства использование информации, содержавшейся в уникальном сертификате устройства. Маркер устройства содержит идентификатор устройства. Это тогда шифрует маркер устройства с маркерным ключом и возвращает его устройству.

Устройство возвращает маркер устройства приложению запроса как NSData объект. Приложение должно тогда поставить маркер устройства своему провайдеру или в двоичном или в шестнадцатеричном формате. Рисунок 3-3 также иллюстрирует маркерную последовательность генерации и рассредоточения, но кроме того показывает роль клиентского приложения в предоставлении его провайдера с маркером устройства.

Форма этой фазы маркерного доверия гарантирует, что только APNs генерирует маркер, который это будет позже соблюдать, и это может убедиться, что маркер, врученный ему устройством, является тем же маркером, который это ранее настроило для того определенного устройства — и только для того устройства.

Маркерное доверие (уведомление)

После того, как система получает маркер устройства из APNs, как описано в Маркерной Генерации и Рассредоточении, это должно предоставить APNs маркер каждый раз, когда это соединяется с ним. APNs дешифрует маркер устройства и проверяет это, маркер был сгенерирован для соединительного устройства. Для проверки APNs гарантирует, что идентификатор устройства, содержавшийся в маркере, соответствует идентификатор устройства в сертификате устройства.

Каждое уведомление, которое провайдер отправляет в APNs для поставки устройству, должно сопровождаться маркером устройства, который это получило из приложения на том устройстве. APNs дешифрует маркер с помощью маркерного ключа, таким образом гарантируя, что уведомление допустимо. Это тогда использует устройство ID, содержавшийся в маркере устройства для определения устройства назначения для уведомления.

Доверительные компоненты

Для поддержки модели обеспечения безопасности для APNs провайдеры и устройства должны обладать определенными сертификатами, сертификатами центра сертификации (CA) или маркерами.

• Провайдер: Каждый провайдер требует уникального сертификата провайдера и частного криптографического ключа для проверки их соединения с APNs. Этот сертификат, настроенный Apple, должен идентифицировать определенную тему, опубликованную провайдером; темой является пакет ID клиентского приложения. Для каждого уведомления провайдер должен предоставить APNs маркером устройства идентификация целевого устройства. Провайдер может дополнительно хотеть проверить службу, которую он подключает к использованию общедоступного сертификата сервера, предоставленного сервером APNs.

• Устройство: система использует общедоступный сертификат сервера, переданный ему APNs для аутентификации службы, с которой это соединилось. Это имеет уникальный закрытый ключ и сертификат, который это использует, чтобы аутентифицировать себя к службе и установить соединение TLS. Это получает сертификат устройства и ключ во время активации устройства и хранит их в цепочке для ключей. Система также содержит свой определенный маркер устройства, который она получает во время процесса соединения услуг. Каждое зарегистрированное клиентское приложение ответственно за поставку этого маркера к его контент-провайдеру.

Серверы APNs также имеют необходимые сертификаты, сертификаты CA и криптографические ключи (частный и общедоступный) для проверки соединений и идентификационных данных провайдеров и устройств.

Локализованные отформатированные строки

Можно вывести на экран локализованные предупредительные сообщения двумя способами:

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

• Клиентское приложение может сохранить предупредительные строки сообщения в своем пакете, переведенном для каждой локализации, которую оно поддерживает. Провайдер включает loc-key и loc-args ключи aps словарь полезной нагрузки уведомления. (Для строк заголовка это включает title-loc-key и title-loc-args ключи в aps словаре.), Когда устройство получает уведомление (принимающий приложение не работает), оно использует их aps- свойства словаря, чтобы найти и отформатировать строку локализовали для текущего языка, который она тогда выводит на экран пользователю.

Вот то, как та вторая опция работает в немного большем количестве подробности.

Приложение может интернационализировать ресурсы, такие как изображения, звуки и текст для каждого языка, который это поддерживает, Интернационализация собирает ресурсы и помещает их в подкаталог пакета с именем с двумя частями: код языка и расширение .lproj (например, fr.lproj). Программно выведенные на экран локализованные строки помещаются в вызванный файл Localizable.strings. Каждая запись в этом файле имеет ключ и значение локализованной строки; строка может иметь спецификаторы формата для замены значений переменных. Когда приложение просит определенный ресурс — скажем локализованная строка — это получает ресурс, локализующийся для языка, в настоящее время выбираемого пользователем. Например, если бы предпочтительный язык является французским, соответствующее строковое значение для предупредительного сообщения было бы выбрано от Localizable.strings в fr.lproj каталог в комплекте приложений. (Приложение выполняет этот запрос через NSLocalizedString макрос.)

Для создания этой расчетной организации давайте рассмотрим пример. Провайдер указывает следующий словарь как значение предупредительного свойства:

"alert" : {

    "loc-key" : "GAME_PLAY_REQUEST_FORMAT",

"loc-args" : [ "Jenna", "Frank"]

}

Когда устройство получает уведомление, оно использует "GAME_PLAY_REQUEST_FORMAT" как ключ для поиска связанного строкового значения в Localizable.strings файл в .lproj каталог для текущего языка. Принятие текущей локализации имеет a Localizable.strings запись, такая как это:

"GAME_PLAY_REQUEST_FORMAT" = "%@ and %@ have invited you to play Monopoly";

устройство выводит на экран предупреждение с сообщением “Дженна, и Франк пригласили Вас играть Монополию”.

В дополнение к спецификатору формата %@, Вы можете %n$@ спецификаторы формата для позиционной замены строковых переменных. N является индексом (начиная с 1) значения массива в loc-args занимать место. (Существует также %% спецификатор для выражения знака процента (%).) Поэтому, если запись в Localizable.strings это:

"GAME_PLAY_REQUEST_FORMAT" = "%2$@ and %1$@ have invited you to play Monopoly";

устройство выводит на экран предупреждение с сообщением “Франк, и Дженна пригласили Вас играть Монополию”.

Для полного примера полезной нагрузки уведомления, использующей loc-key и loc-arg свойства, посмотрите Примеры Полезных нагрузок JSON. Для узнавания больше об интернационализации посмотрите Руководство по Интернационализации и Локализации. Строковое форматирование обсуждено в Форматировании Строковых Объектов в Строковом Руководстве по программированию.

Примеры полезных нагрузок JSON

Следующие примеры части полезной нагрузки уведомлений иллюстрируют практическое применение свойств, перечисленных в Таблице 3-1. Свойства с «высшей точкой» на ключевое имя являются примерами пользовательских данных полезной нагрузки.

Пример 1. Следующая полезная нагрузка имеет aps словарь с простой, рекомендуемой формой для предупредительных сообщений с предупредительными кнопками по умолчанию (Близко и Представление). Это использует строку в качестве значения alert вместо словаря. Эта полезная нагрузка также имеет пользовательское свойство массива.

{

    "aps" : { "alert" : "Message received from Bob" },

    "acme2" : [ "bang",  "whiz" ]

}

Пример 2. Полезная нагрузка в примере использует aps словарь, чтобы запросить, чтобы устройство вывело на экран предупредительное сообщение с кнопкой Close слева и локализованный заголовок для кнопки «действия» на правой стороне предупреждения. В этом случае «PLAY» используется в качестве ключа в Localizable.strings файл для в настоящее время выбираемого языка для получения локализованного эквивалента «Play». aps словарь также запрашивает, чтобы значок приложения был под маркой с номером 5. На Часах Apple ключ заголовка предупреждает пользователя к новому запросу.

{

    "aps" : {

        "alert" : {

            "title" : "Game Request",

            "body" : "Bob wants to play poker",

            "action-loc-key" : "PLAY"

        },

        "badge" : 5,

    },

    "acme1" : "bar",

    "acme2" : [ "bang",  "whiz" ]

}

Пример 3. Полезная нагрузка в этом примере указывает, что устройство должно вывести на экран предупредительное сообщение с обеими кнопками Close и View. Это также запрашивает, чтобы значок приложения был под маркой с номером 9 и что связанный предупредительный звук играться, когда поставлено уведомление.

{

    "aps" : {

        "alert" : "You got your emails.",

        "badge" : 9,

        "sound" : "bingbong.aiff"

    },

    "acme1" : "bar",

    "acme2" : 42

}

Пример 4. Полезная нагрузка в этом примере использует loc-key и loc-args дочерние свойства alert словарь, чтобы выбрать отформатированную локализованную строку от пакета приложения и заменить значениями переменной строки (loc-args) в надлежащих местах. Это также указывает пользовательский звук и включает пользовательское свойство.

{

   "aps" : {

     "alert" : {

            "loc-key" : "GAME_PLAY_REQUEST_FORMAT",

            "loc-args" : [ "Jenna", "Frank"]

        },

     "sound" : "chime.aiff"

   },

   "acme" : "foo"

}

Пример 5. Полезная нагрузка в этом примере включает пользовательские действия уведомления. Обратите внимание на то, что присутствие дополнительного actions массив не влияет на действие по умолчанию, связанное с предупреждением.

{

   "aps" : {

      "alert” : {

         “body” : "Acme message received from Johnny Appleseed”,

         “action-loc-key” : “VIEW”,

         "actions" : [

            {

               “id" : “delete",

               "title" : "Delete"

            },

            {

               “id" : “reply-to”,

               "loc-key" : “REPLYTO”,

               "loc-args" : [“Jane"]

            }

         ]

      }

      "badge" : 3,

      "sound" : “chime.aiff"

   },

   "acme-account" : "jane.appleseed@apple.com",

   "acme-message" : "message123456"

}