Технология HCE

Многие устройства Android с поддержкой NFC уже поддерживают эмуляцию карт NFC. В большинстве случаев карта эмулируется отдельным чипом в устройстве, который называется защитным элементом. Многие SIM-карты, предоставляемые операторами беспроводной связи, также содержат защитный элемент.

В Android 4.4 и более поздних версиях предусмотрен дополнительный метод эмуляции карт, не требующий защитного элемента, – эмуляция карт на хосте. Это позволяет любому приложению для Android эмулировать карту и напрямую взаимодействовать со считывателем NFC. В этой статье рассказывается, как работает эмуляция карт на хосте (HCE) в Android и как разработать приложение, которое эмулирует карту NFC с помощью этой технологии.

Эмуляция карты с защитным элементом

Если эмуляция карты NFC выполняется с помощью защитного элемента, то эмулируемая карта добавляется в защитный элемент на устройстве через приложение Android. Когда пользователь подносит устройство к терминалу NFC, контроллер NFC на устройстве направляет все данные со считывателя непосредственно в защитный элемент. Это показано на рисунке 1.

Диаграмма, на которой показано, как считыватель NFC получает информацию из защитного элемента через контроллер NFC
Рисунок 1. Эмуляция карты NFC с защитным элементом.

Защитный элемент сам обменивается данными с терминалом NFC, и в транзакции не участвует ни одно приложение для Android. После завершения транзакции приложение для Android может напрямую запросить у защитного элемента статус транзакции и уведомить пользователя.

Эмуляция карт на хосте

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

Схема, на которой показано, как считыватель NFC получает информацию от ЦП через контроллер NFC
Рисунок 2. Эмуляция карты NFC без защитного элемента.

Поддерживаемые карты и протоколы NFC

Схема стека протоколов HCE
Рисунок 3. Стек протоколов HCE в Android.

Стандарты NFC поддерживают множество различных протоколов, и вы можете эмулировать разные типы карт.

Android 4.4 и более поздние версии поддерживают несколько протоколов, которые сейчас широко используются на рынке. Многие существующие бесконтактные карты, например платежные, уже работают на основе этих протоколов. Эти протоколы также поддерживаются многими NFC-считывателями, представленными на рынке, в том числе устройствами Android с NFC, которые сами могут работать как считыватели (см. класс IsoDep). Это позволяет создавать и развертывать комплексные решения NFC на основе HCE, используя только устройства Android.

В частности, Android 4.4 и более поздние версии поддерживают эмуляцию карт на основе спецификации NFC-Forum ISO-DEP (на основе ISO/IEC 14443-4) и обрабатывают блоки данных протокола приложений (APDU), как определено в спецификации ISO/IEC 7816-4. Android требует эмуляции ISO-DEP только поверх технологии Nfc-A (ISO/IEC 14443-3 Type A). Поддержка технологии Nfc-B (ISO/IEC 14443-4 Type B) необязательна. На рисунке 3 показано, как эти спецификации накладываются друг на друга.

Сервисы HCE

Архитектура HCE в Android основана на компонентах Service (известных как сервисы HCE). Одно из ключевых преимуществ сервиса заключается в том, что он может работать в фоновом режиме без пользовательского интерфейса. Это удобно для многих приложений, использующих эмуляцию хост-карты, например для карт постоянного клиента или транспортных карт, которые пользователь должен иметь возможность использовать без запуска приложения. Вместо этого прикладывание устройства к NFC-терминалу запускает нужный сервис, если он ещё не запущен, и выполняет транзакцию в фоновом режиме. При необходимости вы можете запустить дополнительные элементы интерфейса (например, уведомления) из своего сервиса.

Выбор сервиса

Когда пользователь подносит устройство к считывателю NFC, системе Android нужно знать, с каким сервисом HCE хочет связаться считыватель. В спецификации ISO/IEC 7816-4 описан способ выбора приложений на основе идентификатора приложения (AID). Идентификатор приложения состоит из 16 байт. Если вы эмулируете карты для существующей инфраструктуры считывателей NFC, идентификаторы AID, которые ищут эти считыватели, обычно хорошо известны и общедоступны (например, идентификаторы AID платежных сетей, таких как Visa и MasterCard).

Если вы хотите развернуть новую инфраструктуру считывателей для своего приложения, вам нужно зарегистрировать собственные идентификаторы AID. Процедура регистрации идентификаторов AID описана в спецификации ISO/IEC 7816-5. Если вы развертываете приложение HCE для Android, рекомендуем зарегистрировать AID в соответствии со стандартом 7816-5, чтобы избежать конфликтов с другими приложениями.

Группы AID

В некоторых случаях для реализации определенного приложения сервису HCE может потребоваться зарегистрировать несколько идентификаторов AID и быть установленным в качестве обработчика по умолчанию для всех идентификаторов AID. Перенос некоторых идентификаторов AID из группы в другой сервис не поддерживается.

Список идентификаторов приложений, которые хранятся вместе, называется группой идентификаторов приложений. Для всех идентификаторов AID в группе Android гарантирует одно из следующих условий:

  • Все идентификаторы приложений в группе направляются в этот сервис HCE.
  • Ни один идентификатор приложения из группы не направляется в этот сервис HCE (например, потому что пользователь выбрал другой сервис, который также запросил один или несколько идентификаторов приложений из вашей группы).

Другими словами, промежуточного состояния, когда некоторые идентификаторы AID в группе могут быть направлены в один сервис HCE, а некоторые – в другой, не существует.

Группы и категории AID

Каждую группу AID можно связать с категорией. Это позволяет Android группировать сервисы HCE по категориям, а пользователю – задавать настройки по умолчанию на уровне категории, а не AID. Не упоминайте идентификаторы AID в пользовательском интерфейсе приложения, поскольку они не имеют значения для обычного пользователя.

В Android 4.4 и более поздних версиях поддерживаются две категории:

  • CATEGORY_PAYMENT (включая стандартные платежные приложения)
  • CATEGORY_OTHER (для всех остальных приложений HCE)

Приложения, регистрирующие идентификаторы AID в категории CATEGORY_PAYMENT, могут обрабатывать транзакции, только если:

  • Пользователь устанавливает приложение в качестве платежного приложения по умолчанию (держатель роли Кошелька на устройствах с Android 15 и более поздними версиями).
  • Приложение работает в активном режиме и вызывает setPreferredService.

Реализация сервиса HCE

Чтобы эмулировать NFC-карту с помощью HCE, необходимо создать компонент Service, который обрабатывает NFC-транзакции.

Проверьте поддержку HCE

Чтобы проверить, поддерживает ли устройство HCE, приложение может использовать функцию FEATURE_NFC_HOST_CARD_EMULATION. Чтобы указать, что приложение использует функцию HCE, и сообщить, требуется ли она для его работы, добавьте в манифест тег <uses-feature>.

Реализация сервиса

В Android 4.4 и более поздних версиях есть удобный класс Service, который можно использовать в качестве основы для реализации сервиса HCE: класс HostApduService.

Сначала расширьте класс HostApduService, как показано в примере кода ниже.

class MyHostApduService : HostApduService() {

    override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
        // ...
    }

    override fun onDeactivated(reason: Int) {
        // ...
    }
}

HostApduService объявляет два абстрактных метода, которые необходимо переопределить и реализовать. Один из них, processCommandApdu(), вызывается каждый раз, когда NFC-считыватель отправляет блок данных протокола приложения (APDU) в ваш сервис. Блоки APDU определены в спецификации ISO/IEC 7816-4. APDU – это пакеты уровня приложения, которыми обмениваются NFC-считыватель и ваш сервис HCE. Этот протокол уровня приложения является полудуплексным: считыватель NFC отправляет вам командный APDU и ожидает, пока вы отправите ответный APDU.

Как упоминалось ранее, Android использует AID, чтобы определить, с каким сервисом HCE хочет связаться считыватель. Обычно первый APDU, который NFC-считыватель отправляет на устройство, – это SELECT AID APDU. Он содержит AID, с которым считыватель хочет связаться. Android извлекает этот AID из APDU, сопоставляет его с сервисом HCE, а затем пересылает этот APDU сопоставленному сервису.

Чтобы отправить ответный блок APDU, верните байты ответного блока APDU из processCommandApdu(). Обратите внимание, что этот метод вызывается в основном потоке приложения, который не должен блокироваться. Если вы не можете сразу вычислить и вернуть ответный APDU, верните null. Затем вы можете выполнить необходимые действия в другом потоке и использовать метод sendResponseApdu(), определенный в классе HostApduService, чтобы отправить ответ.

Android продолжает пересылать новые APDU от считывателя в ваш сервис, пока не произойдет одно из следующих событий:

  • NFC-считыватель отправляет ещё один блок SELECT AID APDU, который ОС сопоставляет с другим сервисом.
  • Связь между NFC-считывателем и вашим устройством прервана.

В обоих случаях вызывается реализация onDeactivated() вашего класса с аргументом, указывающим, какое из двух событий произошло.

Если вы работаете с существующей инфраструктурой считывателей, вам необходимо реализовать в сервисе HCE существующий протокол уровня приложения, который ожидают считыватели.

Если вы развертываете новую инфраструктуру считывателей, которой вы также управляете, вы можете определить собственный протокол и последовательность APDU. Постарайтесь ограничить количество APDU и размер передаваемых данных, чтобы пользователям не приходилось долго держать устройство у NFC-считывателя. Разумный верхний предел – около 1 КБ данных, которые обычно можно передать за 300 мс.

Декларация манифеста сервиса и регистрация AID

Вам нужно объявить службу в манифесте, как обычно, но также добавить в объявление некоторые дополнительные элементы:

  1. Чтобы сообщить платформе, что это сервис HCE, реализующий интерфейс HostApduService, добавьте фильтр интентов для действия SERVICE_INTERFACE в объявление сервиса.

  2. Чтобы указать, какие группы AID запрашиваются сервисом, добавьте тег SERVICE_META_DATA <meta-data> в объявление сервиса. Он должен указывать на XML-ресурс с дополнительной информацией о сервисе HCE.

  3. Задайте для атрибута android:exported значение true и запросите разрешение android.permission.BIND_NFC_SERVICE в декларации сервиса. Первое гарантирует, что сервис может быть связан с внешними приложениями. В этом случае только внешние приложения с разрешением android.permission.BIND_NFC_SERVICE смогут подключаться к вашему сервису. Поскольку android.permission.BIND_NFC_SERVICE – это системное разрешение, оно гарантирует, что к вашему сервису сможет подключаться только ОС Android.

Ниже приведен пример объявления манифеста HostApduService.

<service android:name=".MyHostApduService" android:exported="true"
         android:permission="android.permission.BIND_NFC_SERVICE">
    <intent-filter>
        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
    </intent-filter>
    <meta-data android:name="android.nfc.cardemulation.host_apdu_service"
               android:resource="@xml/apduservice"/>
</service>

Этот тег метаданных указывает на файл apduservice.xml. Ниже приведен пример такого файла с объявлением одной группы AID, содержащей два собственных AID:

<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
           android:description="@string/servicedesc"
           android:requireDeviceUnlock="false">
    <aid-group android:description="@string/aiddescription"
               android:category="other">
        <aid-filter android:name="F0010203040506"/>
        <aid-filter android:name="F0394148148100"/>
    </aid-group>
</host-apdu-service>

Тег <host-apdu-service> должен содержать атрибут <android:description> с удобным описанием сервиса, которое можно показывать в интерфейсе приложения. Вы можете использовать атрибут requireDeviceUnlock, чтобы указать, что устройство должно быть разблокировано до вызова этого сервиса для обработки APDU.

Тег <host-apdu-service> должен содержать один или несколько тегов <aid-group>. Каждый тег <aid-group> должен выполнять следующие действия:

  • Содержать атрибут android:description с удобным описанием группы AID, которое можно показывать в интерфейсе.
  • Атрибут android:category должен указывать на категорию, к которой относится группа AID, например строковые константы, определенные в CATEGORY_PAYMENT или CATEGORY_OTHER.
  • Содержать один или несколько тегов <aid-filter>, каждый из которых содержит один идентификатор AID. Укажите идентификатор приложения в шестнадцатеричном формате. Он должен содержать четное количество символов.

Чтобы зарегистрировать приложение в качестве сервиса HCE, ему также необходимо разрешение NFC.

Разрешение конфликтов AID

На одном устройстве может быть установлено несколько компонентов HostApduService, и один и тот же идентификатор AID может быть зарегистрирован несколькими сервисами. Android определяет, какой сервис вызвать, следующим образом:

  1. Если в приложении-кошельке по умолчанию зарегистрирован AID, то вызывается это приложение.
  2. Если AID не зарегистрирован в приложении кошелька по умолчанию, вызывается сервис, в котором он зарегистрирован.
  3. Если идентификатор AID зарегистрирован в нескольких сервисах, Android предлагает пользователю выбрать нужный.

Настройки активных служб

Активные приложения могут вызывать setPreferredService, чтобы указать, какой сервис эмуляции карт должен быть предпочтительным, пока определенное действие выполняется на переднем плане. Приоритет активного приложения переопределяет разрешение конфликтов AID. Это рекомендуется делать, если приложение предполагает, что пользователь может использовать эмуляцию NFC-карты.

Android 13 и более поздних версий

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

Android 12 и более ранние версии

Задайте размер баннера сервиса 260 x 96 dp, а затем укажите его в XML-файле метаданных, добавив атрибут android:apduServiceBanner в тег <host-apdu-service>, который указывает на прорисовываемый ресурс. Пример:

<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
        android:description="@string/servicedesc"
        android:requireDeviceUnlock="false"
        android:apduServiceBanner="@drawable/my_banner">
    <aid-group android:description="@string/aiddescription"
               android:category="payment">
        <aid-filter android:name="F0010203040506"/>
        <aid-filter android:name="F0394148148100"/>
    </aid-group>
</host-apdu-service>

Приложения-кошельки

В Android 15 и более поздних версиях есть роль приложения-кошелька по умолчанию, которую пользователь может выбрать в разделе Настройки > Приложения > Приложения по умолчанию. Это приложение будет открываться по умолчанию при касании кассового терминала. Сервисы HCE, в которых объявлена группа AID с категорией оплаты, считаются приложениями-кошельками.

Как проверить, является ли ваше приложение кошельком по умолчанию

Приложения могут проверять, являются ли они кошельком по умолчанию, передавая RoleManager.ROLE_WALLET в RoleManager.isRoleHeld().

Если ваше приложение не является кошельком по умолчанию, вы можете запросить эту роль, передав RoleManager.ROLE_WALLET в RoleManager.createRequestRoleIntent().

Объекты, необходимые для приложений кошельков

Чтобы сделать приложение более привлекательным, разработчики кошельков с эмуляцией карт должны добавить баннер сервиса.

Режим наблюдения

В Android 15 появился режим наблюдения. В режиме наблюдения устройство может отслеживать циклы опроса NFC и отправлять уведомления о них соответствующим компонентам HostApduService, чтобы они могли подготовиться к взаимодействию с определенным терминалом NFC. HostApduService может перевести устройство в режим наблюдения, передав true в setObserveModeEnabled(). Это указывает стеку NFC не разрешать NFC-транзакции, а пассивно наблюдать за циклами опроса.

Фильтры цикла опроса

Зарегистрировать фильтры цикла опроса для HostApduService можно одним из следующих способов:

Когда фильтр цикла опроса совпадает с нестандартными кадрами опроса, стек NFC направляет эти кадры опроса в соответствующий сервис HostApduService, вызывая его метод processPollingFrames(). Это позволяет сервису предпринять все необходимые шаги, чтобы убедиться, что пользователь готов к транзакции и намерен ее совершить, например выполнить аутентификацию пользователя. Если NFC-считыватель использует в цикле опроса только стандартные фреймы, стек NFC направляет их в предпочтительную активную службу, если она работает на переднем плане, или в кошелек по умолчанию.

Уведомления о фреймах опроса также включают в себя измерение напряженности поля, зависящее от поставщика, которое можно получить, вызвав getVendorSpecificGain(). Поставщики могут предоставлять измерения, используя собственную шкалу, если она помещается в один байт.

Как реагировать на циклы опроса и выйти из режима наблюдения

Когда сервис будет готов к транзакциям, он может выйти из режима наблюдения, передав false в setObserveModeEnabled(). После этого стек NFC разрешит транзакции.

Компоненты HostApduService могут указывать, что режим наблюдения должен быть включен, когда они являются предпочтительным платежным сервисом. Для этого нужно задать для shouldDefaultToObserveMode значение true в манифесте или вызвать CardEmulation.setShouldDefaultToObserveModeForService().

Компоненты HostApduService и OffHostApduService также могут указывать, что фильтры цикла опроса, соответствующие полученным кадрам цикла опроса, должны автоматически отключать режим наблюдения и разрешать транзакции. Для этого нужно задать для autoTransact значение true в объявлении PollingLoopFilter в манифесте.

Настройки активных служб

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

Поведение при выключенном и заблокированном экране

Поведение сервисов HCE зависит от версии Android, установленной на устройстве.

Android 15 и более поздних версий

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

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

Android 12 и более поздних версий

В приложениях для Android 12 (уровень API 31) и более поздних версий можно включить оплату через NFC без включения экрана устройства, задав для requireDeviceScreenOn значение false.

Android 10 и более поздних версий

Устройства с Android 10 (уровень API 29) или более поздней версии поддерживают защиту NFC. Если защита NFC включена, то при выключенном экране устройства все эмуляторы карт (размещаемые и неразмещаемые приложения) недоступны. Если защита NFC отключена, то при выключенном экране устройства доступны неразмещаемые приложения. Проверить, поддерживается ли защита NFC, можно с помощью метода isSecureNfcSupported().

На устройствах с Android 10 и более поздними версиями ОС параметр android:requireDeviceUnlock со значением true работает так же, как и на устройствах с Android 9 и более ранними версиями ОС, но только если защита NFC отключена. Это значит, что если защита NFC включена, сервисы HCE не могут работать на заблокированном экране независимо от значения параметра android:requireDeviceUnlock.

Android 9 и более ранних версий

На устройствах с Android 9 (уровень API 28) и более ранними версиями контроллер NFC и процессор приложений полностью отключаются, когда экран устройства выключен. Поэтому сервисы HCE не работают при выключенном экране.

Кроме того, на устройствах с Android 9 и более ранними версиями сервисы HCE могут работать на заблокированном экране. Однако это определяется атрибутом android:requireDeviceUnlock в теге <host-apdu-service> вашего сервиса HCE. По умолчанию разблокировка устройства не требуется, и ваш сервис вызывается, даже если устройство заблокировано.

Если вы зададите для атрибута android:requireDeviceUnlock значение true для службы HCE, Android будет предлагать пользователю разблокировать устройство в следующих случаях:

  • Пользователь подносит устройство к NFC-считывателю.
  • NFC-считыватель выбирает идентификатор приложения, который разрешается в ваш сервис.

После разблокировки Android показывает диалоговое окно с предложением нажать ещё раз, чтобы завершить транзакцию. Это необходимо, поскольку пользователь мог убрать устройство от NFC-считывателя, чтобы разблокировать его.

Сосуществование с картами с защитным элементом

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

Это сосуществование основано на принципе, называемом маршрутизацией AID. Контроллер NFC хранит таблицу маршрутизации, которая состоит из (конечного) списка правил маршрутизации. Каждое правило маршрутизации содержит AID и пункт назначения. Целевым объектом может быть как хост-процессор, на котором выполняются приложения Android, так и подключенный защитный элемент.

Когда считыватель NFC отправляет APDU с SELECT AID, контроллер NFC анализирует его и проверяет, совпадают ли AID с какими-либо AID в его таблице маршрутизации. Если совпадение найдено, этот и все последующие APDU отправляются в пункт назначения, связанный с AID, пока не будет получен другой APDU SELECT AID или не прервется NFC-соединение.

Эта архитектура показана на рисунке 4.

Схема, на которой показано, как NFC-считыватель обменивается данными с защитным элементом и ЦП
Рисунок 4. Android с защитным элементом и технологией Host Card Emulation.

Контроллер NFC обычно также содержит маршрут по умолчанию для APDU. Если идентификатор AID не найден в таблице маршрутизации, используется маршрут по умолчанию. Хотя эта настройка может отличаться на разных устройствах, на устройствах Android необходимо убедиться, что идентификаторы приложений, регистрируемые вашим приложением, правильно маршрутизируются на хост.

Приложениям для Android, в которых реализован сервис HCE или используется защитный элемент, не нужно настраивать таблицу маршрутизации – это делается автоматически. Android нужно лишь знать, какие идентификаторы приложений могут обрабатываться сервисами HCE, а какие – защитным элементом. Таблица маршрутизации настраивается автоматически в зависимости от того, какие сервисы установлены и какие из них пользователь выбрал в качестве предпочтительных.

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

Регистрация идентификатора приложения в защитном элементе

Приложения, использующие защитный элемент для эмуляции карт, могут объявить в манифесте сервис вне хоста. Декларация такого сервиса практически идентична декларации сервиса HCE. Исключения:

  • Для действия, используемого в фильтре интентов, должно быть задано значение SERVICE_INTERFACE.
  • Атрибут name в метаданных должен иметь значение SERVICE_META_DATA.
  • В XML-файле метаданных должен использоваться корневой тег <offhost-apdu-service>.

    <service android:name=".MyOffHostApduService" android:secureElementName="eSE"
           android:exported="true" android:permission="android.permission.BIND_NFC_SERVICE">
      <intent-filter>
          <action android:name="android.nfc.cardemulation.action.OFF_HOST_APDU_SERVICE"/>
      </intent-filter>
      <meta-data android:name="android.nfc.cardemulation.off_host_apdu_service"
                 android:resource="@xml/apduservice"/>
    </service>

Ниже приведен пример файла apduservice.xml, в котором зарегистрированы два идентификатора приложений:

<offhost-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
           android:description="@string/servicedesc">
    <aid-group android:description="@string/subscription" android:category="other">
        <aid-filter android:name="F0010203040506"/>
        <aid-filter android:name="F0394148148100"/>
    </aid-group>
</offhost-apdu-service>

Атрибут android:requireDeviceUnlock не применяется к сервисам, не размещенным на хосте, поскольку ЦП хоста не участвует в транзакции и поэтому не может запретить защитному элементу выполнять транзакции, когда устройство заблокировано.

Атрибут android:apduServiceBanner обязателен для сервисов, которые не размещены на хосте и являются платежными приложениями, а также для сервисов, которые можно выбрать в качестве платежного приложения по умолчанию.

Вызов сервиса вне хоста

Android никогда не запускает и не привязывает сервис, объявленный как off-host, поскольку фактические транзакции выполняются защитным элементом, а не сервисом Android. Декларация сервиса позволяет приложениям регистрировать идентификаторы приложений, которые находятся в защитном элементе.

HCE и безопасность

Архитектура HCE обеспечивает один из основных элементов безопасности: поскольку ваш сервис защищен системным разрешением BIND_NFC_SERVICE, только ОС может связываться с ним и обмениваться данными. Это гарантирует, что любой полученный вами APDU действительно был получен ОС от контроллера NFC, а любой отправленный вами APDU отправляется только в ОС, которая, в свою очередь, напрямую пересылает APDU контроллеру NFC.

Последний вопрос, который нужно решить, – откуда приложение берет данные, которые отправляет на NFC-считыватель. Это сделано намеренно: для HCE не имеет значения, откуда поступают данные, главное – чтобы они были безопасно переданы контроллеру NFC и далее на считывающее устройство NFC.

Для безопасного хранения и получения данных, которые вы хотите отправлять из своего сервиса HCE, можно использовать, например, песочницу приложений для Android, которая изолирует данные вашего приложения от других приложений. Подробнее о безопасности Android…

Параметры и сведения о протоколе

Этот раздел предназначен для разработчиков, которые хотят узнать, какие параметры протокола используют устройства с HCE на этапах предотвращения конфликтов и активации протоколов NFC. Это позволяет создать инфраструктуру считывателей, совместимую с устройствами Android, поддерживающими эмуляцию карт.

Предотвращение конфликтов и активация протокола Nfc-A (ISO/IEC 14443 тип A)

В рамках активации протокола Nfc-A происходит обмен несколькими фреймами.

На первом этапе обмена устройство HCE предоставляет свой UID. Предполагается, что у устройств HCE случайный UID. Это означает, что при каждом касании UID, который предоставляется считывателю, генерируется случайным образом. Поэтому NFC-считыватели не должны использовать UID устройств HCE для аутентификации или идентификации.

Затем NFC-считыватель может выбрать устройство HCE, отправив команду SEL_REQ. В ответе SEL_RES устройства HCE должен быть установлен как минимум шестой бит (0x20), указывающий на поддержку ISO-DEP. Также могут быть установлены и другие биты SEL_RES, например указывающие на поддержку протокола NFC-DEP (p2p). Поскольку могут быть установлены и другие биты, считыватели, взаимодействующие с устройствами HCE, должны проверять только шестой бит, а не сравнивать весь байт SEL_RES со значением 0x20.

Активация ISO-DEP

После активации протокола Nfc-A NFC-считыватель инициирует активацию протокола ISO-DEP. Оно отправляет команду RATS (Request for Answer To Select). Контроллер NFC генерирует ответ RATS, ATS; ATS не настраивается сервисами HCE. Однако реализации HCE должны соответствовать требованиям NFC Forum к ответу ATS, поэтому считыватели NFC могут рассчитывать на то, что эти параметры будут установлены в соответствии с требованиями NFC Forum для любого устройства HCE.

Ниже приведена подробная информация об отдельных байтах ответа ATS, предоставляемого контроллером NFC на устройстве HCE.

  • TL – длина ответа ATS. Длина не должна превышать 20 байт.
  • T0: биты 5, 6 и 7 должны быть установлены на всех устройствах HCE, что указывает на включение TA(1), TB(1) и TC(1) в ответ ATS. Биты с 1 по 4 указывают на FSCI, кодируя максимальный размер кадра. На устройствах с HCE значение FSCI должно быть от 0h до 8h.
  • T(A)1: определяет битрейт между считывателем и эмулятором, а также то, могут ли они быть асимметричными. Для устройств с HCE нет требований к скорости передачи данных или гарантий.
  • T(B)1: биты 1–4 указывают на целое число, определяющее время защитного интервала кадра запуска (SFGI). На устройствах с HCE значение SFGI должно быть меньше или равно 8 часам. Биты с 5 по 8 указывают на целое число времени ожидания кадра (FWI) и кодируют время ожидания кадра (FWT). На устройствах с HCE значение FWI должно быть меньше или равно 8h.
  • T(C)1: бит 5 указывает на поддержку расширенных функций протокола. Устройства с HCE могут поддерживать или не поддерживать расширенные функции протокола. Бит 2 указывает на поддержку DID. Устройства с HCE могут поддерживать или не поддерживать DID. Бит 1 указывает на поддержку NAD. Устройства HCE не должны поддерживать NAD и должны устанавливать бит 1 в ноль.
  • Исторические байты: устройства HCE могут возвращать до 15 исторических байтов. NFC-считыватели, взаимодействующие с сервисами HCE, не должны делать предположений о содержимом или наличии исторических байтов.

Обратите внимание, что многие устройства с HCE, скорее всего, соответствуют требованиям протокола, которые платежные сети, объединенные в EMVCo, указали в своей спецификации Contactless Communication Protocol. В частности, нужно проверять следующее:

  • FSCI в T0 должно быть от 2 до 8 часов.
  • T(A)1 должно быть установлено на 0x80, что указывает на поддержку только скорости передачи данных 106 кбит/с и отсутствие поддержки асимметричных скоростей передачи данных между считывателем и эмулятором.
  • FWI в T(B)1 должно быть <= 7 ч.

Обмен данными APDU

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