Перейти к основному содержимому
Didit привлёк $7,5 млн на инфраструктуру для идентификации и борьбы с мошенничеством
Didit
В блог
Блог · 20 ноября 2026 г.

Digital Credentials API: как сайты подключаются к ID-кошелькам

W3C Digital Credentials API для бизнеса: запрос ID из кошелька без редиректа, поддержка браузерами в 2026, кросс-девайс QR, приватность, iframes и опыт Didit с Google Wallet.

Автор: DiditОбновлено
digital-credentials-api-cover.png

Коротко

Digital Credentials API представляет собой браузерный API консорциума W3C, который позволяет веб-сайту запрашивать данные идентификации у цифрового кошелька с помощью одного вызова: navigator.credentials.get() с элементом digital. Браузер и операционная система показывают запрос кошелька, а кошелек отправляет обратно подписанный и зашифрованный ответ.[1][2]

  • Chrome включает его по умолчанию начиная с версии 141, как Google объявила 3 октября 2025; Safari 26 поддерживает его для запросов ISO mdoc.[2][3]
  • Он передает запросы OpenID4VP или ISO/IEC 18013-7, Приложение C, без перенаправления и без собственного QR-кода.[1]
  • Didit использует его для приема цифровых удостоверений Google Wallet в пяти странах.[8]

Дата последней проверки: 20 ноября 2026 · Не является юридической консультацией

Подтверждение личности в интернете долгое время означало фотографию документа и селфи. Цифровые удостоверения в кошельке на телефоне меняют это, но веб-сайту все еще нужен безопасный способ связаться с кошельком. Digital Credentials API служит таким мостом.

Это руководство объясняет работу API для продакт-менеджеров и архитекторов: как проходит запрос, где он работает сегодня, передача между устройствами, конфиденциальность, iframe и то, как Didit использует его для Google Wallet. Внутреннее устройство протокола описано в нашем руководстве по верификатору OpenID4VP, а форматы учетных данных рассмотрены в SD-JWT VC vs mdoc.

Что такое Digital Credentials API

Digital Credentials API является спецификацией рабочей группы W3C Federated Identity Working Group. Ее последняя версия представляет собой Working Draft от 19 ноября 2026 на треке Recommendation.[1] Спецификация определяет API, который позволяет браузерам "выступать посредником при предъявлении и выдаче цифровых учетных данных, таких как водительские права, государственное удостоверение личности". Она опирается на Credential Management Level 1 и "разработана так, чтобы не зависеть от форматов учетных данных".[1]

На практике это еще один тип учетных данных для того браузерного вызова, который сайты уже используют для passkey. Во время origin trial API находился в navigator.identity.get(); Chrome перенес его в navigator.credentials.get() к моменту релиза.[2] API только передает запрос в кошелек и ответ обратно; содержимое определяют протоколы нижнего уровня.

УровеньЧто делаетПримеры
Браузерный APIПередает запрос со страницы и ответ обратноW3C Digital Credentials API
Протокол предъявленияОпределяет запрос и ответ, которые понимает кошелекOpenID4VP 1.0, ISO/IEC 18013-7, Приложение C
Формат учетных данныхПодписанная структура данных внутри ответаISO mdoc, SD-JWT VC
ПлатформаНаходит кошельки, способные ответить, и показывает окно выбораAndroid Credential Manager, iOS
КошелекХранит учетные данные, запрашивает согласие пользователя, подписывает ответGoogle Wallet

Стек, стоящий за одним вызовом Digital Credentials API.[1][2][4]

Как проходит запрос Digital Credentials API

Верификация занимает один цикл от вашей страницы к кошельку и обратно. Ваш сервер формирует запрос, ваша страница передает его в браузер при клике, а зашифрованный ответ возвращается на ваш сервер для проверки.[2][6]

Ваш сервер Ваша веб-страница Браузер и ОС Кошелек
1Пользователь нажимает «Подтвердить»
2Подписанный запрос
3credentials.get, digital

Браузер добавляет origin, показывает окно выбора

4Запрос и origin

Пользователь проверяет и подтверждает

5Зашифрованный ответ
6Объект DigitalCredential
7Передача протокола и данных

Расшифровать, проверить подписи

Упрощенное предъявление на одном устройстве через Digital Credentials API.[1][2][6]

Каждый запрос указывает протокол и содержит объект data в этом протоколе. Браузеры должны поддерживать каждый протокол предъявления из таблицы спецификации:[1]

ИдентификаторПротоколФормат запроса
openid4vp-v1-unsignedOpenID4VP 1.0Неподписанный запрос
openid4vp-v1-signedOpenID4VP 1.0Подписанный запрос
openid4vp-v1-multisignedOpenID4VP 1.0Запрос, подписанный несколькими сторонами
org-iso-mdocISO/IEC 18013-7:2025, Приложение CЗапрос ISO mdoc

Протоколы предъявления в реестре W3C, рабочий проект от 19 ноября 2026 года.[1]

Перед отображением кнопки страница проверяет typeof DigitalCredential и DigitalCredential.userAgentAllowsProtocol().[2][3] Ответ возвращается в виде объекта DigitalCredential с зашифрованной полезной нагрузкой data, которую страница передает на свой бэкенд.[2] Синтаксис запроса и режимы ответов относятся к вопросам протокола, рассмотренным в руководстве по верификатору OpenID4VP.

Почему нет перенаправления

До появления этого API веб-сайт связывался с кошельком, уводя пользователя со страницы: через редирект или кастомный URI, передаваемый приложению, который на десктопе часто показывался в виде QR-кода. Digital Credentials API удерживает пользователя на вашей странице и возвращает ответ в ту же вкладку.[2]

Старый маршрут

Редирект или кастомный URI

  • Пользователь покидает вашу страницу и переходит в приложение или на стороннюю страницу
  • Ваша страница сама генерирует QR-код на десктопе
  • Кошелек узнает запрашивающую сторону из содержимого запроса
  • Каждому кошельку требуется свой формат ссылок

Зависит от схемы

Маршрут через браузер

Digital Credentials API

  • Пользователь остается на вашей странице, браузер показывает системный запрос
  • Браузер сам генерирует QR-код на десктопе
  • Браузер самостоятельно определяет запрашивающий origin
  • Один вызов для любого кошелька, найденного платформой

W3C Digital Credentials

Как страница связывается с кошельком: до и после появления API.[1][2]

Главное отличие заключается в определении источника (origin). Спецификация требует, чтобы браузер использовал «собственное определение источника документа», а не значение, переданное страницей, поэтому «сторона, которая показывается пользователю», совпадает с тем, что зафиксировал браузер.[1] Подписанный запрос OpenID4VP также может перечислять ожидаемые источники, что руководство Google рекомендует «для предотвращения relay-атак».[6] Архитектура EUDI Wallet делает тот же акцент на сценариях с кастомными URI между устройствами, как объясняется в нашем руководстве для полагающихся сторон.

Поддержка в браузерах и на платформах в конце 2026 года

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

Браузер или платформаГдеПредъявлениеПротоколыИсточник
ChromeAndroid, Windows, macOS, Linux, ChromeOSВключено по умолчанию начиная с версии 141 (3 октября 2025)OpenID4VP и Приложение CChrome, W3C CG[2][5]
EdgeAndroid, Windows, macOSС версии 141OpenID4VP и Приложение CW3C CG[5]
SafariiOS 26, iPadOS 26, macOS 26ПоддерживаетсяТолько Приложение C (org-iso-mdoc)WebKit, W3C CG[3][5]
Другие браузеры для iOSiOS 26Как и Safari, они работают на WebKitТолько Приложение CChrome, W3C CG[2][5]
FirefoxmacOSС версии 149Только Приложение CW3C CG[5]
FirefoxAndroid, Windows, LinuxВ разработкеПока нетW3C CG[5]
Приложения для AndroidAndroid 9 (уровень API 28) и вышеCredential ManagerOpenID4VP для Google WalletAndroid, Google[4][6]

W3C CG = таблица поддержки W3C Web Identity and Credentials Adoption Community Group.[5]

Пользователям также требуется совместимое устройство: Android с Google Play services 24.0 или новее либо iOS 26 или новее, а также приложение кошелька с поддержкой API.[2] Google Wallet отвечает на запросы цифровых удостоверений на базе ISO mdoc через OpenID4VP 1.0 на Android 9 и новее.[6] WebKit отмечает, что это пока не работает внутри WKWebView, компонента веб-просмотра в приложениях для iOS.[3] Там также указана известная проблема: запрос, объединяющий OpenID4VP и Приложение C, может приводить к бесконечной загрузке на iOS при сканировании QR-кода из Chrome на macOS.[3]

Примечание

Поддержка меняется с каждым релизом. Проверяйте поддержку функции и протокола во время выполнения и сохраняйте резервный маршрут для остальных пользователей.

На одном устройстве и между устройствами

Если кошелек находится на том же устройстве, Android показывает окно выбора подходящих учетных данных. Если нет, браузер предлагает продолжить на телефоне.[2][7]

1Страница вызывает API при клике

Один и тот же запрос в каждом случае.

Подходящие учетные данные есть на этом устройстве

Да

Одно устройство

Системное окно выбора перечисляет доступные учетные данные; кошелек открывается поверх страницы.

Нет

Между устройствами

Браузер показывает собственный QR-код; телефон сканирует его и проходит проверку близости по Bluetooth.

2Ответ возвращается на ту же страницу

В зашифрованном виде, через браузер.

Где появляется запрос кошелька.[2][6]

Chrome заявляет, что сканирование QR-кода устанавливает «безопасное, защищенное сквозным шифрованием и устойчивое к фишингу соединение» между компьютером и телефоном, используя протокол CTAP через Bluetooth Low Energy, чтобы проверить, что пользователь физически присутствует и контролирует оба устройства.[2] Google добавляет два условия для Google Wallet: Bluetooth должен быть включен, чтобы найти устройство поблизости, а сценарий между устройствами «доступен только тогда, когда партнер внедрил Signed Requests».[7]

Ваша страница не рисует QR-код сама. Ограничения задают платформы: iOS не поддерживает предъявление учетных данных с другого устройства, а Safari на macOS передает только запросы по Приложению C, поэтому из Safari запрос OpenID4VP не может попасть в кошелек на Android.[5]

Конфиденциальность и безопасность: что защищает API

Вместо изображения документа целиком кошелек возвращает только указанные в запросе атрибуты, подписанные эмитентом. Chrome называет этот принцип «выборочным раскрытием»: сайты «получают только минимально необходимую информацию».[2]

ЗащитаЧто это означает на практикеИсточник
Выборочное раскрытиеКошелек передает только запрошенные поляChrome[2]
Действие пользователяДля запроса требуется клик; сайты не могут запрашивать данные скрытно или повторноW3C[1]
Медиация при каждом запросеДиалоговое окно платформы запрашивает подтверждение пользователя при каждом запросеW3C[1]
Origin, заданный браузеромСтраница не может выдать себя за другой сайтW3C[1]
Зашифрованный ответЗашифровано вашим ключом; расшифровать может только ваш серверW3C, Chrome[1][2]
Подтверждение передачи данныхGoogle Wallet запрашивает биометрию, PIN или графический ключ перед передачей данныхGoogle[7]

Google заявляет, что не сохраняет связанные с учетными данными сведения на своих серверах.[7] Экран согласия принадлежит кошельку: Google Wallet отображает название, логотип и политику конфиденциальности, предоставленные проверяющей стороной, чтобы пользователь видел, кто запрашивает данные, перед их передачей.[7]

Действительная подпись подтверждает подлинность данных, но Chrome напоминает разработчикам, что они «обязаны проверить, что эмитент подходит и заслуживает доверия» для их сценария использования.[2] Работа на стороне сервера с ответом mdoc по руководству Google:[6]

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

Использование API внутри iframe: digital-credentials-get

Многие процессы верификации выполняются внутри iframe на сайте клиента. Спецификация предусматривает этот случай с помощью управляемой политиками функции digital-credentials-get, чей список разрешений по умолчанию равен 'self'.[1] Страница из другого origin может вызывать API только тогда, когда встраивающая страница разрешает это через атрибут allow у iframe:[1]

<iframe src="https://verifier-service.example.com" allow="digital-credentials-get"></iframe>

Обратите внимание

Без этого разрешения браузер отклоняет запрос к кошельку внутри iframe, и пользователь не видит окна подтверждения. Если вы встраиваете размещенный сценарий Didit в iframe, добавьте digital-credentials-get в атрибут allow или используйте Web SDK 0.5.1 или новее.[10]

Какие кошельки отвечают сегодня

На Android окно выбора рисует система, и набор учетных данных зависит от того, как каждый кошелек регистрируется в Credential Manager, и от самого запроса.[7] Команда Chrome называет Google Wallet одним из первых, кто внедрил API.[2]

Примечание

Поскольку на тот же вызов могут ответить и другие кошельки, Google рекомендует универсальную кнопку, например «Подтвердить через цифровое удостоверение», вместо названия конкретного кошелька.[7]

На iOS, по данным WebKit, API взаимодействует с Apple Wallet или другими приложениями, зарегистрированными как Identity Document Provider.[3] В Европе архитектура EUDI Wallet указывает OpenID4VP и ISO/IEC 18013-7 поверх Digital Credentials API в качестве способов дистанционного предъявления. Вопросы регистрации описаны в руководстве для полагающихся сторон EUDI Wallet.

Как Didit помогает принимать Google Wallet через Digital Credentials API

Didit реализует сторону проверяющего для Digital Credentials API для Google Wallet в качестве одного из способов в своем продукте digital ID wallets. Google Wallet работает в Didit в рабочей среде и в песочнице для цифровых удостоверений ID pass, созданных на основе паспорта, и мобильных водительских удостоверений из поддерживаемых штатов США, в США, Великобритании, Бразилии, Сингапуре и на Тайване.[8] Сведения о продукте: верификация удостоверений личности Google Wallet. Код: руководство по интеграции.

  • Размещенный сценарий. Пользователи видят «Подтвердить через цифровое удостоверение» и подтверждают действие в собственном окне браузера или Android без перенаправления. Метод появляется только там, где браузер может отправить подписанный запрос OpenID4VP; в остальных случаях остается проверка документов.[8][9]
  • Автономный API. Didit возвращает готовый запрос, который ваша страница может передать в navigator.credentials.get() при клике или в Credential Manager на Android; полная последовательность описана в руководстве по интеграции.[9]
  • Проверки. Didit проверяет подпись эмитента по доверенным корневым сертификатам эмитентов, каждое значение по его подписанному дайджесту, а также подпись устройства для вашего origin и этого запроса. Ответ зашифрован для Didit.[9]
  • Результат. Имя, дата рождения, номер документа, срок действия, страна и орган выдачи, а также гражданство для удостоверения личности на уровне доверия Substantial. Фотография владельца не передается.[8]

Песочница не требует регистрации. Каждое приложение для рабочей среды регистрируется один раз у Google в консоли (шаг ID Verification, строка Google Wallet для поддерживаемой страны, Register with Google); эта разовая настройка занимает около одной минуты. Собственный API верификатора Google бесплатен; цена Didit за проведение проверки составляет $0.20 за завершенную верификацию, а отмененные, просроченные или отклоненные попытки входа не тарифицируются. См. тарифы.[7][8]

Didit предоставляет

  • Подписанный запрос и регистрацию в Google
  • Расшифровку и каждую проверку подписи и origin
  • Проверку документов в качестве резервного варианта в той же сессии

Остается на вашей стороне

  • Кнопка и действие пользователя на вашей странице
  • Разрешение для iframe при встраивании сценария
  • Решение по онбордингу и ваши правила

Принимайте удостоверения личности из Google Wallet без создания собственного верификатора

Включите Google Wallet в рабочем процессе, протестируйте в песочнице и платите только за завершенные проверки.

Начать бесплатноСвязаться с намиЧитать документацию

Ключевые выводы

  • Digital Credentials API представляет собой рабочий проект W3C, который передает запросы к кошелькам через navigator.credentials.get().
  • Chrome и Edge поддерживают OpenID4VP и Приложение C; Safari поддерживает только Приложение C.
  • Браузер задает origin и формирует QR-код для перехода на другое устройство.
  • Внутри iframe встраивающая страница должна предоставить разрешение digital-credentials-get.
  • Didit использует его для удостоверений в Google Wallet в пяти странах с резервной проверкой документов.

Часто задаваемые вопросы

Что такое Digital Credentials API?

Браузерный API W3C, который позволяет сайту запросить цифровые учетные данные, например государственное удостоверение личности, из кошелька через navigator.credentials.get(). Браузер и операционная система показывают окно запроса кошелька.[1][2]

Какие браузеры поддерживают Digital Credentials API?

Chrome включает его по умолчанию начиная с версии 141 на Android и компьютерах, а Edge поддерживает его начиная с версии 141. Safari 26 поддерживает его только для запросов ISO mdoc, а Firefox поддерживает его на macOS начиная с версии 149, также только для запросов по Приложению C. По состоянию на 20 ноября 2026.[2][3][5]

Работает ли Digital Credentials API на iPhone?

Safari на iOS 26 поддерживает этот API для запросов ISO mdoc (Приложение C), и все браузеры на iOS работают на одном движке. Метод Google Wallet в Didit использует подписанные запросы OpenID4VP, а размещенный сценарий показывает этот метод только там, где браузер способен его отправить, поэтому на iPhone вариант с кошельком скрыт и применяется проверка документов.[3][5][8]

Является ли Digital Credentials API тем же самым, что и OpenID4VP?

Нет. API представляет собой канал браузера; OpenID4VP является одним из протоколов, передаваемых через него, наряду с ISO/IEC 18013-7, Приложение C. Запрос указывает свой протокол, и кошелек отвечает по этому протоколу.[1]

Нужен ли origin trial для его использования?

Нет. Chrome включает этот API по умолчанию начиная с версии 141, как объявила Google 3 октября 2025. Экспериментальный код необходимо перевести с navigator.identity.get() на navigator.credentials.get().[2]

Зачем API требуется действие пользователя?

Спецификация требует кратковременной активации (transient activation), поэтому сайт не может запрашивать учетные данные скрытно или повторно. Вызывайте API из обработчика клика; вызов без действия пользователя завершается ошибкой.[1]

Как работает передача между устройствами без собственного QR-кода?

Браузер отображает QR-код, проверка через Bluetooth подтверждает, что телефон находится рядом, и кошелек отвечает по зашифрованному соединению. Google Wallet требует подписанный запрос для этого.[2][7]

Какие кошельки отвечают на запросы Digital Credentials API?

Сегодня это Google Wallet, а также другие кошельки для Android через Credential Manager. На iOS Safari обращается к зарегистрированным поставщикам удостоверений (Identity Document Providers).[3][7]

Бесплатно ли использовать Digital Credentials API?

Да. Это браузерный стандарт, а Google заявляет, что API Google Wallet бесплатен. Работа на стороне проверяющего оплачивается отдельно: Didit выставляет счета только за завершенные проверки.[7][8]

Источники

  1. Digital Credentials, W3C Federated Identity Working Group, рабочий проект от 19 ноября 2026.
  2. Digital Credentials API: Secure and private identity on the web, Chrome for Developers, 3 октября 2025.
  3. WebKit Features in Safari 26.0, блог WebKit, раздел Digital Credentials API.
  4. Request a digital credential, Android Developers.
  5. Ecosystem support, digitalcredentials.dev, W3C Web Identity and Credentials Adoption Community Group, дата обращения 20 ноября 2026.
  6. Accepting IDs from Google Wallet online, Google for Developers.
  7. Verify digital IDs with Google Wallet, Google for Developers.
  8. Digital ID wallets, документация Didit.
  9. Digital ID wallets standalone API, документация Didit.
  10. In-context iframe, документация Didit.

Digital Credentials API превращает проверку кошелька в один вызов браузера; сложная часть заключается в стороне проверяющего. Посмотрите все кошельки, принимаемые Didit, на странице цифровых кошельков удостоверений личности, а национальные eID на странице верификации eID.

Добавьте проверку через цифровое удостоверение в процесс регистрации

Предлагайте Google Wallet там, где это работает, и сохраняйте проверку документов для остальных пользователей в едином сценарии.

Начать бесплатноСвязаться с нами

Инфраструктура для идентификации и борьбы с мошенничеством.

Единый API для KYC, KYB, мониторинга транзакций и проверки кошельков. Интеграция за 5 минут.

Попросите ИИ кратко изложить эту страницу