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

Коротко
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]
Подтверждение личности в интернете долгое время означало фотографию документа и селфи. Цифровые удостоверения в кошельке на телефоне меняют это, но веб-сайту все еще нужен безопасный способ связаться с кошельком. 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]
Браузер добавляет origin, показывает окно выбора
Пользователь проверяет и подтверждает
Расшифровать, проверить подписи
Упрощенное предъявление на одном устройстве через Digital Credentials API.[1][2][6]
Каждый запрос указывает протокол и содержит объект data в этом протоколе. Браузеры должны поддерживать каждый протокол предъявления из таблицы спецификации:[1]
| Идентификатор | Протокол | Формат запроса |
|---|---|---|
openid4vp-v1-unsigned | OpenID4VP 1.0 | Неподписанный запрос |
openid4vp-v1-signed | OpenID4VP 1.0 | Подписанный запрос |
openid4vp-v1-multisigned | OpenID4VP 1.0 | Запрос, подписанный несколькими сторонами |
org-iso-mdoc | ISO/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.
| Браузер или платформа | Где | Предъявление | Протоколы | Источник |
|---|---|---|---|---|
| Chrome | Android, Windows, macOS, Linux, ChromeOS | Включено по умолчанию начиная с версии 141 (3 октября 2025) | OpenID4VP и Приложение C | Chrome, W3C CG[2][5] |
| Edge | Android, Windows, macOS | С версии 141 | OpenID4VP и Приложение C | W3C CG[5] |
| Safari | iOS 26, iPadOS 26, macOS 26 | Поддерживается | Только Приложение C (org-iso-mdoc) | WebKit, W3C CG[3][5] |
| Другие браузеры для iOS | iOS 26 | Как и Safari, они работают на WebKit | Только Приложение C | Chrome, W3C CG[2][5] |
| Firefox | macOS | С версии 149 | Только Приложение C | W3C CG[5] |
| Firefox | Android, Windows, Linux | В разработке | Пока нет | W3C CG[5] |
| Приложения для Android | Android 9 (уровень API 28) и выше | Credential Manager | OpenID4VP для Google Wallet | Android, 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]
Источники
- Digital Credentials, W3C Federated Identity Working Group, рабочий проект от 19 ноября 2026.
- Digital Credentials API: Secure and private identity on the web, Chrome for Developers, 3 октября 2025.
- WebKit Features in Safari 26.0, блог WebKit, раздел Digital Credentials API.
- Request a digital credential, Android Developers.
- Ecosystem support, digitalcredentials.dev, W3C Web Identity and Credentials Adoption Community Group, дата обращения 20 ноября 2026.
- Accepting IDs from Google Wallet online, Google for Developers.
- Verify digital IDs with Google Wallet, Google for Developers.
- Digital ID wallets, документация Didit.
- Digital ID wallets standalone API, документация Didit.
- In-context iframe, документация Didit.
Digital Credentials API превращает проверку кошелька в один вызов браузера; сложная часть заключается в стороне проверяющего. Посмотрите все кошельки, принимаемые Didit, на странице цифровых кошельков удостоверений личности, а национальные eID на странице верификации eID.
Добавьте проверку через цифровое удостоверение в процесс регистрации
Предлагайте Google Wallet там, где это работает, и сохраняйте проверку документов для остальных пользователей в едином сценарии.
Похожие статьи
- Google Wallet ID или верификация документов: что выбрать
- Digital Credentials API: как сайты подключаются к ID-кошелькам
- Прием Google Wallet ID в онбординге: руководство по интеграции
- Google Wallet ID pass: что получают компании и где он работает
- Верификация по Google Wallet ID запущена в Didit
- 7 лучших программных платформ eIDAS в 2026 году