cryptographic: провайдер удостоверений аутентифицировал человека и подписал возвращённые атрибуты. Это всё, о чём говорит данный уровень. Это не рейтинг по сравнению с двумя другими уровнями — они описывают разные типы подтверждений, а не большее или меньшее количество одного и того же — а продолжительность входа зависит от собственного процесса кошелька, который Didit не контролирует и не гарантирует.
Выберите способ интеграции
Используйте API цифровых ID-кошельков, когда ваше приложение самостоятельно управляет интерфейсом и шагами аутентификации. У каждого кошелька есть отдельный endpoint запуска, а для получения результата, поллинга и отмены используются общие endpoint’ы. Вам не нужно создавать сценарий. Используйте Sessions API для размещённого Didit пользовательского пути с кошельком, правил сценария и настроенного запасного варианта с проверкой документов. Доступность кошелька, обязательное согласие пользователя и верифицированные атрибуты личности применяются к обоим методам интеграции.Предварительные требования
Для каждого кошелька требуется активная цифровая идентичность у указанного ниже эмитента и доступ к его методу аутентификации. Аккаунт должен соответствовать требованиям для предоставления запрашиваемых атрибутов, и пользователь должен дать согласие на их передачу. Подпись подтверждает эмитента и возвращённые клеймы; она не гарантирует, что каждый запрошенный атрибут присутствует, актуален или достаточен для вашей политики комплаенса. Кошелёк без портретного фото не включает сравнение с селфи. Ниже перечислены все 25 записей о кошельках из каталога, включая обе страны BankID, ConnectID, Estonian ID-card и eParaksts mobile. Настроенный запасной вариант с проверкой документов выполняет отдельную проверку документов. Дата запуска не гарантируется. Это кошельки цифровой идентификации. Скрининг криптокошельков проверяет блокчейн-адреса на финансовые риски и является отдельным продуктом.Цены
✅ Доступно означает, что кошелёк включён в продакшене. ⏳ Скоро появится означает, что кошелёк ещё не включён в продакшене, даже если интеграционное тестирование уже началось. Сначала отображаются доступные кошельки. По запросу в столбце цен означает, что кошелёк доступен, но для него нет опубликованного розничного тарифа; это не означает бесплатную верификацию. Это стандартные цены Didit в USD за завершённую верификацию через кошелёк для перечисленных ниже продуктов идентификации. Указанная цена включает проверку личности через кошелёк; отдельная комиссия за транзакцию с использованием национальной eID к ней не добавляется. Согласованный индивидуальный тариф организации имеет приоритет.
Скоро в столбце цен означает, что кошелёк запланирован, а цена для клиентов ещё не опубликована. Это не означает, что верификация бесплатна. Флаги стран показывают покрытие кошелька по каталогу; отдельный столбец доступности показывает, можно ли его включить в данный момент.
Опубликованная цена не активирует кошелёк. Доступность выше указана на основе продакшн-каталога. Кошелёк с отметкой Скоро пока нельзя выбрать в сценарии; эти тарифы начнут действовать, когда он станет доступен.
- За подтверждённый вход через кошелёк плата взимается один раз за узел «Верификация личности» в сценарии или один раз за запрос на верификацию через отдельный API кошельков. Повторные обратные вызовы или проверки статуса не приводят к дополнительным списаниям.
- Отменённые, истекшие, отклонённые или незавершённые входы не тарифицируются как верификация через кошелёк.
- Цены на кошельки являются базовыми: скидка вашего тарифа применяется к ним так же, как и к любой другой проверке.
- Запасной вариант с проверкой документа считается отдельной проверкой, тарифицируемой в соответствии с ценами на верификацию документов. Другие завершённые функции сценария оплачиваются отдельно.
Что делает пользователь
- Выбирает свою страну на шаге удостоверения личности и выбирает кошелёк из списка разрешённых вами.
- Выполняет вход с помощью этого кошелька так же, как входит в свой банк или на государственный портал.
- Дает согласие на передачу своих атрибутов личности вам.
- Возвращается после успешной верификации.
Кошельки задаются списком разрешений
wallet.providers представляет собой список кошельков, которые может предложить страна. Это не ранжирование: порядок, в котором вы их передаёте, не имеет значения: при сохранении он нормализуется до порядка каталога, а конечный пользователь выбирает из разрешённых вами вариантов. Включите один кошелёк или все кошельки в стране — выбор остаётся за ними.
API отклоняет сценарий, если в нём включён кошелёк, который каталог не предлагает для этой страны, или кошелёк со статусом Скоро.
Список атрибутов каждого кошелька ниже включает подписанное утверждение. Didit проверяет эту подпись и передаёт результат проверки в поле
wallet_verification.signature_valid сессии; само утверждение не возвращается, поэтому нет ссылки, которую можно было бы получить или сохранить. Столбец В сессии указывает, какой из двух вариантов вы получаете для каждого атрибута.Поддерживаемые кошельки
Доступные кошельки: MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID и Mobile-ID. iDIN доступен для полной идентификации в Нидерландах. Smart-ID и Mobile-ID доступны в странах, перечисленных в каталоге ниже. Покрытие стран и запрашиваемые входные данные для Smart-ID и Mobile-ID отражают реализованную интеграцию; доступность в продакшене регулируется отдельно. Используйте руководство по интеграции для реализованных маршрутов Smart-ID и Mobile-ID.Доступность определяется каталогом возможностей, а не ведётся вручную на этой странице. Статус Скоро означает, что кошелёк виден в консоли, но пока не может быть включён; для него нет зафиксированной даты запуска.
Estonian ID-card и eParaksts mobile
Оба метода интегрированы в каталог кошельков, но в продакшене остаются со статусом Скоро. Их нельзя включить в продакшн-сценариях до тех пор, пока в продакшн-каталоге они не будут отмечены как Доступные. Идентификаторы API:idcard_ee для Эстонии (EST) и eparaksts_mobile для Латвии (LVA).
Для обоих методов установлена цена $0.55 за завершённую верификацию при наличии доступа; опубликованный тариф сам по себе не открывает доступ в продакшене.
- Estonian ID-card: пользователь продолжает процесс в браузере на компьютере, подключённом к считывателю смарт-карт, и проходит аутентификацию с помощью карты и PIN-кода через программное обеспечение карты.
- eParaksts mobile: пользователь переходит в сервис аутентификации и подтверждает действие через свой активный аккаунт eParaksts mobile. Пользователи на компьютерах могут отсканировать QR-код, чтобы продолжить на телефоне; пользователи на смартфонах продолжают напрямую.
White label применяется к экранам верификации Didit.
Внешние экраны аутентификации для этих двух методов сохраняют фирменный стиль своих сервисов.
Пользовательские логотипы, названия сервиса и стили White label не переносятся на эти внешние экраны.
Использование этих кошельков через API
Оба метода также поддерживают автономную верификацию через API безworkflow_id.
Доступность в продакшене одинакова как для автономного API, так и для сценариев; проверяйте GET /v3/id-verification/wallets/ перед тем, как предлагать любой из этих методов пользователям.
Храните ваш
x-api-key на бэкенде и зарегистрируйте хост возврата вашего приложения в настройке allowed_return_hosts.
При запуске верификации передавайте HTTPS return_url на этом хосте.
В ответе на запуск возвращаются request_id и wallet_verification.next_action.url для браузера пользователя.
Перенаправьте пользователя по этому URL, чтобы он мог пройти аутентификацию с помощью карты или приложения.
После возвращения пользователя вызовите GET /v3/id-verification/wallets/verifications/{request_id}/ со своего бэкенда, чтобы проверить подтверждённый результат, или обработайте подписанный webhook status.updated.
Не считайте простой редирект в браузере подтверждением успешной верификации.
Одинаковые правила биллинга и цена за завершённую верификацию применяются к обоим вариантам интеграции.
Google Wallet
Google Wallet позволяет человеку передать государственное удостоверение личности со своего телефона на вашу страницу или в приложение с помощью W3C Digital Credentials API. Он доступен в продакшене и в песочнице. Для приложений в песочнице регистрация не требуется. Каждое продакшн-приложение регистрируется один раз перед тем, как сможет использовать Google Wallet: в консоли откройте шаг верификации личности, найдите строку Google Wallet для поддерживаемой страны, выберите Зарегистрироваться в Google и завершите разовую настройку, которая занимает около минуты. После этого Google будет показывать ваше название и логотип, когда люди передают своё удостоверение личности. Пока приложение не зарегистрировано, сохранение сценария с включённым Google Wallet будет отклонено с сообщением “Register this application with Google before enabling Google Wallet.” Конечные пользователи ваших клиентов видят эту опцию как Verify with digital ID, поскольку помимо Google Wallet ответить на запрос может любой другой кошелёк Android, поддерживающий тот же запрос OpenID4VP и содержащий совместимое удостоверение личности (цифровой ID-пропуск или мобильное водительское удостоверение).- Страны: США, Великобритания, Бразилия, Сингапур и Тайвань.
- Удостоверения: цифровой ID-пропуск Google Wallet, созданный на основе паспорта, а также мобильные водительские удостоверения из поддерживаемых штатов США.
- Возвращаемые данные: имя, дата рождения, номер документа, срок действия документа, страна и орган выдачи, а также гражданство для ID-пропуска.
В результате также содержится вердикт
signature_validдля учётных данных. Фотография лица (портрет) не передаётся. - Конфиденциальность: Didit запрашивает только те поля, которые необходимы, и только эти поля покидают кошелёк. Пользователь подтверждает передачу данных в Google Wallet на собственном устройстве.
digital-credentials-get в атрибут allow вашего iframe: без этого браузер отклонит запрос кошелька внутри iframe.
Другие планируемые кошельки
ConnectID (Австралия) интегрирован для тестирования в песочнице и отображается в каталоге кошельков какconnectid.
Пользователь выбирает участвующий тестовый банк через селектор ConnectID, входит в систему этого банка и просматривает запрос на передачу данных.
Начальный набор идентификационных данных запрашивает имя, фамилию и дату рождения, а также идентификатор транзакции для верификации.
Он не запрашивает адрес, номер телефона, адрес электронной почты, баланс счёта или историю транзакций.
В уведомлении о передаче данных указываются Didit и компания, получающая подтверждённую личность.
Учётные данные для доступа к банку остаются у банка.
Доступ к продакшн-среде остаётся со статусом Скоро; тестирование в песочнице не позволяет выполнять верификацию личности в продакшне.
До активации необходимо утвердить сценарий использования в продакшне, завершить онбординг клиента, принять обязательные условия и пройти сертификацию.
Другие кошельки, отмеченные в таблицах как Скоро, также остаются недоступными в продакшне.
Дата запуска не обещана.
Уровень доверия
Если кошелёк предоставляет уровень доверия eIDAS (low, substantial или high), Didit фиксирует фактически заявленный уровень в результате.
Кошелёк без указанного уровня eIDAS, например ConnectID, отображается как Не указано; его интеграция не подразумевает заявления об уровне доверия eIDAS.
Если кошелёк возвращает более слабый уровень, чем запрошенный, попытка входа завершается ошибкой вместо незаметного понижения уровня.
Проверяйте wallet_verification.level_of_assurance в объекте сессии, если от этого зависят ваши комплаенс-правила.
Справочник по кошелькам
MitID
mitid · Доступно
Информация, вводимая в Didit: Имя · Дата рождения · CPR-псевдоним (псевдонимизированный)
BankID
bankid_se · Доступно
Информация, вводимая в Didit: Имя · Персональный номер
iDIN
idin · Доступно
Информация, вводимая в Didit: Имя · Дата рождения · Адрес
Finnish Trust Network
ftn · Доступно
Информация, вводимая в Didit: Имя · Личный идентификационный код
Google Wallet
google_wallet · Доступно
Информация, вводимая в Didit: Данные личности в Didit не вводятся
Smart-ID
smart_id · Доступно
Информация, вводимая в Didit: Личный идентификационный код
Mobile-ID
mobile_id · Доступно
Информация, вводимая в Didit: Личный идентификационный код · Номер телефона Mobile-ID
BankID
bankid_no · Скоро появится
Информация, вводимая в Didit: Имя · Дата рождения · Национальный идентификационный номер
Vipps
vipps · Скоро появится
Информация, введённая в Didit: Имя · Дата рождения · Национальный идентификационный номер
Buypass ID
buypass · Скоро появится
Информация, введённая в Didit: Имя · Дата рождения · Национальный идентификационный номер
itsme
itsme · Скоро появится
Информация, введённая в Didit: Имя · Дата рождения · Номер в национальном регистре
Personalausweis
personalausweis · Скоро появится
Информация, введённая в Didit: Имя · Дата рождения · Гражданство · Адрес
Freja eID
frejaid · Скоро появится
Информация, введённая в Didit: Имя · Дата рождения · Личный номер
UAE PASS
uae_pass · Скоро появится
Сведения, вносимые в Didit: Имя · Номер Emirates ID · Гражданство · Портрет
gov.br
govbr · Скоро
Сведения, вносимые в Didit: Имя · CPF
OneID
oneid · Скоро
Сведения, вносимые в Didit: Имя · Дата рождения
GOV.UK Wallet
govuk_wallet · Скоро
Сведения, вносимые в Didit: Имя · Дата рождения · Портрет
Эстонская ID-карта
idcard_ee · Скоро
Сведения, вносимые в Didit: Имя · Дата рождения · Личный идентификационный код
eParaksts mobile
eparaksts_mobile · Скоро
Данные, вводимые в Didit: Имя · Дата рождения · Персональный идентификационный код
Bank iD
bankid_cz · Скоро появится
Данные, вводимые в Didit: Имя · Дата рождения
MojeID
mojeid · Скоро появится
Данные, вводимые в Didit: Имя · Дата рождения
Diia
diia · Скоро появится
Данные, вводимые в Didit: Имя · Дата рождения · Фотография лица
FranceConnect
franceconnect · Скоро появится
Данные, вводимые в Didit: Имя · Дата рождения
Auðkenni
audkenni · Скоро появится
Информация, вводимая в Didit: Имя · Kennitala
ConnectID
connectid · Скоро появится
Информация, вводимая в Didit: Данные личности не вводятся в Didit
EUDI Wallet
eudi · Скоро появится
Информация, вводимая в Didit: PID - данные идентификации личности
Сбои и резервные сценарии
Любой результат, отличный от
verified, обрабатывается согласно переключателю wallet.on_failure для страны: fallback_to_document перенаправляет пользователя на съемку документа, decline завершает сессию со статусом отклоненной Верификации личности. fallback_to_document при отключенной съемке документов для этой страны приводит к отклонению, так как резервный вариант недоступен.
Информацию о том, как показывать съемку документов только после неудачного входа через кошелек, см. в разделе Предложение съемки документов только в качестве резервного варианта.
Тарифицируется только успешно завершенный вход. Прерванные, отмененные, завершенные по таймауту и неудачные попытки входа бесплатны.
Данные, попадающие в сессию
attributes содержит проверенные утверждения кошелька, названия которых зависят от конкретного кошелька.
Используйте full_name и date_of_birth в результате верификации личности для получения нормализованных полей данных личности.
Таблица для каждого кошелька разграничивает нормализованные поля и атрибуты, специфичные для кошелька. Поле portrait присутствует только для тех кошельков, которые передают фотографию. Поле signature_valid представляет собой результат проверки подписанного утверждения, возвращённого кошельком. Оно равно true при успешном входе: утверждение, не прошедшее проверку, приводит к ошибке входа; в этом случае применяется правило wallet.on_failure, а одобренный результат не формируется.
Полное описание типов полей см. в модели данных Верификации личности.
Настройка кошельков
Этот фрагмент конфигурации следует использовать только если в каталоге вашей среды каждый выбранный кошелек отмечен какavailable в выбранной стране.
Передача кошелька, который недоступен, приводит к отклонению сохранения всего сценария, включая любые другие методы в том же запросе.
Примеры для Smart-ID и Mobile-ID см. в руководстве по интеграции.
wallet.enabled имеет значение true, иначе сохранение будет отклонено. Полный справочник доступен в разделе Конфигурация функций сценария.
Связанные материалы
- Интеграция с Finnish Trust Network - Финляндия, банковская аутентификация и резервный сценарий с документом
- Интеграция со Smart-ID и Mobile-ID - охват стран, коды сопоставления и настройка сценариев
- Методы Верификации личности — три метода, резервные сценарии и тарификация
- Проверка без документов — метод сопоставления данных
- Методы Верификации личности в панели управления — включение кошельков по странам