NFC-верификация: API для биометрических паспортов и eID

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

Преимущества

Преимущество	Описание
Максимальная безопасность	Проверяет криптографические подписи, выданные непосредственно государственными органами
Простота использования	Автоматически работает с любым телефоном, оснащённым NFC
Защита от подделок	Выявляет манипуляции с документом, невидимые невооружённым глазом
Полнота данных	Извлекает дополнительные данные, недоступные с помощью одного лишь OCR
Гибкий фолбэк	Корректно переключается на стандартную верификацию, если NFC недоступен

Как включить NFC-верификацию

Интеграция с помощью нативных SDK (рекомендуется)

NFC-верификация доступна через наши нативные SDK, которые предоставляют полный доступ к возможностям NFC устройства:

Платформа	Поддержка NFC	Документация
iOS	✅ Полная поддержка	Документация iOS SDK
Android	✅ Полная поддержка	Документация Android SDK

iOS SDK берёт на себя всю настройку NFC в автоматическом режиме, включая:

Идентификаторы приложений ISO7816 для электронных паспортов
Настройку разрешений и системных возможностей
Считывание чипа в реальном времени с визуальной обратной связью

Веб-интеграция

⚠️ Ограничения браузеров NFC-верификация недоступна в веб-браузерах из-за ограничений платформ:
Браузер Поддержка NFC
Chrome (Android) Экспериментальный Web NFC API - нестабилен, требует явных разрешений
Safari (iOS) Нет поддержки Web NFC API
Другие браузеры Поддержка отсутствует
При веб-интеграциях NFC-верификация автоматически пропускается, и пользователи переходят к стандартной верификации «документ + селфи».

Браузер	Поддержка NFC
Chrome (Android)	Экспериментальный Web NFC API - нестабилен, требует явных разрешений
Safari (iOS)	Нет поддержки Web NFC API
Другие браузеры	Поддержка отсутствует

Как это работает

Инициация сессии

Пользователь начинает процесс верификации через ваше приложение или платформу:

Нативный SDK: запуск процесса верификации напрямую в вашем приложении
Веб/Мобильный веб: пользователю предлагается использовать Didit App для верификации с поддержкой NFC, либо продолжить стандартную верификацию

Фотографирование документа

Пользователь фотографирует свой документ, удостоверяющий личность, фиксируя:

MRZ (машиночитаемую зону) — используется для получения ключей доступа к чипу
Изображения лицевой и оборотной сторон документа — визуальные данные и элементы защиты
Визуальные элементы защиты — голограммы, водяные знаки, микропечать

Определение поддержки NFC

Система автоматически проверяет совместимость устройства и документа:

Проверка	Описание
Тип документа	Является ли это электронным паспортом/eID с NFC-чипом?
Возможности устройства	Поддерживает ли телефон считывание NFC?
Разрешения	Предоставлены ли необходимые разрешения для NFC?

Если NFC недоступен, процесс проверки продолжается в стандартном режиме: документ + биометрическая верификация.

Считывание NFC-чипа

Для совместимых устройств и документов:

Пользователю предлагается приложить документ к NFC-модулю телефона
Визуальные подсказки отображают прогресс считывания в реальном времени
Устанавливается защищённое соединение с чипом по протоколам PACE/BAC

Извлечение данных

Система извлекает подробные данные с чипа в соответствии со стандартами ICAO 9303:

Группа данных	Содержимое	Описание
SOD	Объект безопасности документа	Цифровые подписи для всех групп данных
DG1	Персональные данные	Имя, номер документа, дата рождения, срок действия
DG2	Изображение лица	Цифровая фотография владельца в высоком разрешении
DG7	Подпись	Цифровое представление подписи владельца
DG11-14	Дополнительные данные	Могут включать отпечатки пальцев, снимки радужной оболочки глаза (если записаны)

Криптографическая проверка

Извлечённые данные проходят строгую криптографическую проверку:

Проверка цифровой подписи

Хеш каждой группы данных сверяется с подписями, хранящимися в SOD, что гарантирует целостность данных.

Валидация цепочки сертификатов

Проверяется цепочка доверия: сертификат документа → удостоверяющий центр страны → корневой сертификат ICAO PKD, со сверкой по мастер-спискам CSCA и каталогу открытых ключей ICAO.

Проверка отзыва сертификатов

Сертификаты проверяются по спискам отзыва сертификатов (CRL), чтобы убедиться, что они не были отозваны, а документ не числится украденным или скомпрометированным.

Перекрёстная проверка

Данные, извлечённые через NFC, перекрёстно сверяются с данными OCR с фотографий документа, результатами биометрического сравнения лиц и проверкой контрольных сумм MRZ.

Результат и оценка уверенности

Итоговый результат верификации включает:

Выходные данные	Описание
Статус NFC-верификации	Успешно, неуспешно или пропущено
Оценка согласованности данных	Насколько точно данные NFC совпадают с визуальными данными
Валидация сертификата	Статус полной проверки цепочки
Повышение уверенности	NFC значительно повышает итоговую уверенность в результатах верификации

Поддерживаемые документы

NFC-верификация работает с электронными паспортами и eID, содержащими NFC-чип. Обычно на таких документах присутствует следующий символ:

Большинство паспортов, выданных после 2006 года, содержат NFC-чипы. Доступность чипов в национальных удостоверениях личности зависит от страны. Ознакомьтесь со списком поддерживаемых документов. Карта Japan My Number Card оснащена чипом другого типа, считываемым через JPKI вместо ICAO 9303. См. раздел Japan My Number Card (JPKI).

Карта My Number в Японии (JPKI)

Японская карта My Number (マイナンバーカード) оснащена чипом, но не стандарта ICAO 9303. На ней хранятся сертификаты, выпущенные в рамках JPKI (инфраструктуры открытых ключей Японии), и закрытые ключи, которые создают подпись только после того, как владелец введет PIN-код карты. Didit считывает ее на том же шаге NFC через JPKI вместо ICAO 9303, и каждый результат NFC указывает использованный протокол в поле chip_protocol (icao или jpki).

Пока недоступно. Считывание карты My Number через JPKI еще не включено в продакшене. До его включения карта My Number, отсканированная в нативном SDK, пропускает шаг NFC с причиной пропуска JPKI_UNAVAILABLE, а карта верифицируется с помощью съемки документа и сравнения лиц, как и раньше.

Требования

Требование	Детали
Документ	Только японская карта My Number. Для японских паспортов сохраняется считывание чипа по стандарту ICAO 9303.
Интеграция	Релиз нативного SDK, поддерживающий считывание карт My Number (iOS, Android или созданные на их базе SDK для React Native и Flutter). SDK сообщает Didit, что может считывать JPKI; более старые релизы пропускают шаг с причиной `JPKI_UNAVAILABLE`. Интеграции Web и WebView пропускают его с причиной `INTEGRATION_WITHOUT_NFC_ACCESS`.
Устройство	Телефон с NFC-модулем. Без него шаг пропускается с причиной `DEVICE_WITHOUT_NFC`.
Хост-приложение для iOS	`D392F000260100000001` среди идентификаторов выбора ISO7816 в приложении. См. конфигурацию NFC для iOS.
Человек	Знает 4-значный PIN-код карты, а также пароль для подписи, если ваш сценарий запрашивает данные владельца.

Что делает человек

Сфотографировать карту

Человек фотографирует карту My Number на шаге верификации личности, как и любой другой документ. Didit распознает карту и отправляет шаг JPKI NFC вместо считывания чипа паспорта.

Ввести PIN-код карты

SDK запрашивает 4-значный PIN-код карты (利用者証明用電子証明書の暗証番号). Если в узле NFC включена настройка jpki_request_attributes (по умолчанию), он также запрашивает пароль для подписи, называемый также PIN-кодом для подписи (署名用電子証明書の暗証番号, от 6 до 16 заглавных букв и цифр).

Приложить карту к телефону

SDK считывает сертификаты карты, и карта подписывает одноразовый вызов от Didit своим ключом. SDK загружает сертификаты и подписи. PIN-коды передаются только на карту и никогда не попадают в Didit.

Карта считает неверные попытки ввода: она блокирует 4-значный PIN-код после 3 неверных попыток подряд и пароль для подписи после 5, а заблокированный PIN-код или пароль необходимо сбросить в муниципальном учреждении по месту жительства владельца. После неверного ввода SDK показывает, сколько попыток осталось. Он никогда не выполняет последнюю попытку: когда остается только одна, он останавливается и сообщает человеку, где можно выполнить сброс. Просите пользователей подготовить PIN-код и пароль для подписи перед началом.

Что проверяет Didit

Проверка	Что проверяет Didit	Предупреждение при сбое (действие по умолчанию)
Цепочка сертификатов	Каждый сертификат ведет к удостоверяющему центру JPKI своего типа, находится в пределах срока действия и является сертификатом карты My Number (`jpki.chain_valid`).	`JPKI_CERTIFICATE_INVALID` (Отклонить)
Карта и PIN-код	Подпись карты для одноразового запроса проверяется с помощью ее сертификата (`jpki.signature_valid`). Карта ставит подпись только после ввода PIN-кода, что подтверждает наличие карты у человека и знание им PIN-кода.	`JPKI_SIGNATURE_INVALID` (Отклонить)
Отзыв	Ни один сертификат не был отозван (`jpki.revocation_status`).	`JPKI_CERTIFICATE_REVOKED` при значении `revoked` (Отклонить), `JPKI_REVOCATION_UNCHECKED` при значении `unchecked` (Проверка)
Данные владельца	Имя, дата рождения, пол и адрес в сертификате подписи совпадают с данными, считанными с фотографии той же карты (`jpki.attributes_match_ocr`, `jpki.mismatched_attributes`).	`JPKI_AND_OCR_DATA_NOT_SAME` (Проверка)

Каждое действие настраивается в узле NFC, поэтому его можно изменить на Без действия, Проверка или Отклонить. См. предупреждения NFC и конфигурацию функции NFC.

Что означает статус отзыва unchecked

revocation_status: "unchecked" означает, что Didit проверил цепочку сертификатов и подпись карты, но не получил ответа о том, был ли отозван сертификат. Сертификат отзывается, например, при сообщении об утере карты. Поскольку нельзя исключить, что карта отозвана, статус unchecked никогда не считается good. Он вызывает предупреждение JPKI_REVOCATION_UNCHECKED, которое по умолчанию отправляет шаг NFC на проверку. Выберите другой результат с помощью параметра jpki_revocation_unchecked_action. Если цепочка сертификатов или подпись недействительны, Didit не запрашивает статус отзыва: статус остается unchecked, и генерируется только предупреждение для цепочки или подписи.

Данные владельца и конфиденциальность

При включенном параметре jpki_request_attributes решение включает имя владельца, дату рождения, пол и адрес из сертификата подписи в поле jpki.attributes. При отключенном параметре человек вводит только 4-значный PIN-код: считывание по-прежнему подтверждает наличие карты и PIN-код, но не содержит данных владельца и не сравнивается с фотографией карты.
На шаге NFC 12-значный индивидуальный номер (My Number) никогда не считывается с чипа.
В решении указывается то, что подтвердила карта; сами сертификаты, их серийные номера и подписи в него не включаются.

Полный результат описан в отчете о NFC-верификации.

Примеры интеграции

iOS SDK (уже доступен)

import DiditSdk

// NFC is automatically enabled when the document supports it
let config = DiditSdk.Configuration(
    // NFC configuration is handled automatically
    // Just ensure your app has the required entitlements
)

let result = try await DiditSdk.shared.startVerification(
    with: sessionId,
    configuration: config
)

Полная документация по iOS SDK →

Android SDK (уже доступен)

import me.didit.sdk.DiditSdk

// NFC is automatically enabled when the document supports it
DiditSdk.startVerification(
    token = "your-session-token"
) { result ->
    handleResult(result)
}

Документация по Android SDK →

Архитектура безопасности

┌─────────────────────────────────────────────────────────────┐
│                    NFC Verification Flow                     │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────┐  │
│  │ Document │───▶│  Phone   │───▶│   Didit Backend      │  │
│  │ NFC Chip │    │ NFC Read │    │                      │  │
│  └──────────┘    └──────────┘    │  ┌────────────────┐  │  │
│                                   │  │ ICAO PKD       │  │  │
│                                   │  │ Validation     │  │  │
│                                   │  └────────────────┘  │  │
│                                   │  ┌────────────────┐  │  │
│                                   │  │ CSCA Master    │  │  │
│                                   │  │ List Check     │  │  │
│                                   │  └────────────────┘  │  │
│                                   │  ┌────────────────┐  │  │
│                                   │  │ CRL Revocation │  │  │
│                                   │  │ Check          │  │  │
│                                   │  └────────────────┘  │  │
│                                   └──────────────────────┘  │
│                                              │               │
│                                              ▼               │
│                                   ┌──────────────────────┐  │
│                                   │  Verification Result │  │
│                                   │  + Confidence Score  │  │
│                                   └──────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Аутентификация

Верификация

Мониторинг

Платформа

NFC-верификация: API для биометрических паспортов и eID

Преимущества

Как включить NFC-верификацию

Интеграция с помощью нативных SDK (рекомендуется)

Веб-интеграция

Как это работает

Поддерживаемые документы

Карта My Number в Японии (JPKI)

Требования

Что делает человек

Что проверяет Didit

Что означает статус отзыва unchecked

Данные владельца и конфиденциальность

Примеры интеграции

iOS SDK (уже доступен)

Android SDK (уже доступен)

Архитектура безопасности

FAQ

​Преимущества

​Как включить NFC-верификацию

​Интеграция с помощью нативных SDK (рекомендуется)

​Веб-интеграция

​Как это работает

​Поддерживаемые документы

​Карта My Number в Японии (JPKI)

​Требования

​Что делает человек

​Что проверяет Didit

​Что означает статус отзыва unchecked

​Данные владельца и конфиденциальность

​Примеры интеграции

​iOS SDK (уже доступен)

​Android SDK (уже доступен)

​Архитектура безопасности

​FAQ

Преимущества

Как включить NFC-верификацию

Интеграция с помощью нативных SDK (рекомендуется)

Веб-интеграция

Как это работает

Поддерживаемые документы

Карта My Number в Японии (JPKI)

Требования

Что делает человек

Что проверяет Didit

Что означает статус отзыва unchecked

Данные владельца и конфиденциальность

Примеры интеграции

iOS SDK (уже доступен)

Android SDK (уже доступен)

Архитектура безопасности

FAQ