Выбор данных, которые возвращает проверка
У каждой функции рабочего процесса есть вкладка Возвращаемые данные, которая определяет, какие поля, изображения и оценки Didit сохраняет и отдаёт. Как это работает, почему IP-адрес и MRZ находятся там, где находятся, и побочные эффекты отключения полей.
Откройте функцию в рабочем процессе и перейдите на вкладку Возвращаемые данные: у каждого поля, изображения и оценки есть переключатель, и то, что вы выключите, не сохраняется для этого шага и не возвращается в ответе API и вебхука. IP-адрес находится в Анализе устройства и IP, а не в проверке документа, и единого переключателя "MRZ" нет - вы управляете полями MRZ по отдельности.
У каждого шага рабочего процесса (проверка документа, liveness, face match, подтверждение адреса, проверка по базам данных, анализ устройства и IP, AML и так далее) есть вкладка Возвращаемые данные под заголовком Минимизация данных и конфиденциальность. Она перечисляет все данные, которые шаг может выдать, по группам (для проверки документа: Сведения о личности, Личная информация, Действительность документа, Адресная информация, Медиа-ресурсы, Оценки качества, Данные чипа), со счётчиком включённых. Что вы оставите включённым, сохраняется с сессией и возвращается в решении; что выключите - нет.
Это инструмент минимизации данных: оставьте поля, нужные вашему процессу, отбросьте остальное, и изображения, которые вы никогда не хотели хранить, не попадут ни в ваши системы, ни в консоль.
#Что на самом деле делает отключение поля
- Значение не сохраняется в сессии и не возвращается эндпоинтом решения и вебхуком
status.updatedдля этой функции. - Консоль отображает сессию из тех же данных, поэтому выключенное изображение отсутствует и там. Если вы выключили "Изображение документа" или "Портретное изображение", предпросмотр документа в карточке сессии исчезает - это настройка, а не сломанная сессия.
- Поля с пометкой Всегда выключить нельзя: от них зависит само решение.
- Применяется к сессиям, созданным после сохранения и повторной публикации. Существующие сессии сохраняют то, что уже сохранили.
Удаление изображений документа или селфи затрудняет ручную проверку: ваши проверяющие видят извлечённые значения, но не снимок, из которого они получены. Если ваш процесс комплаенса требует, чтобы человек посмотрел на документ, оставьте хотя бы изображение лицевой стороны на время окна проверки и положитесь на хранение, чтобы удалить его потом.
#Где на самом деле находятся поля, которые все ищут
| Вам нужно | Где это |
|---|---|
| IP-адрес пользователя, страна, город, признак VPN/прокси | Функция Анализ устройства и IP, в разделах Данные IP и Устройство и сессия. Добавьте эту функцию в рабочий процесс (она входит в бесплатный тариф), и решение будет содержать блок ip_analysis с IP-адресом и его сигналами. Проверка документа никогда не возвращает IP |
| MRZ паспорта или удостоверения | Проверка документа возвращает объект mrz вместе с извлечёнными полями. Единого переключателя для него нет: значения, которые он содержит (номер документа, даты, имена, гражданство), - это те же поля личности и документа, перечисленные на вкладке, поэтому вы ограничиваете их по одному. Какие строки существуют, зависит от документа, поэтому форма отличается по странам |
| Изображения селфи и liveness | Функция Liveness, в разделе Медиа-ресурсы: изображение селфи, кадр видео liveness, скрытый снимок селфи |
| Изображения и оценка face match | Функция Face Match. Если рабочий процесс выполняет сравнение лиц в составе другой проверки (например, сравнение документа с селфи внутри адаптивной проверки возраста), у той проверки своя вкладка Возвращаемые данные |
| Данные чипа, считанные по NFC | Проверка документа, раздел Данные чипа |
| Ответы реестра проверки по базам данных | Собственная вкладка функции Проверка по базам данных. См. проверку по базам данных |
#Когда вкладка заблокирована
Рабочие процессы, созданные под стандарт проверки возраста, показывают "Возвращаемые данные отключены в этом рабочем процессе для соответствия стандарту": проверка возраста возвращает только решение о возрасте, никогда - лежащие в основе персональные данные, и вкладку изменить нельзя. Если вам нужны поля личности, это другой тип рабочего процесса.
#Проверка того, что сессия содержит на самом деле
Откройте сессию в разделе Проверки и прочитайте отчёт по функциям: выключенное поле просто отсутствует, а не показывается пустым. На стороне API сравните полезную нагрузку решения с вкладкой Возвращаемые данные рабочего процесса, прежде чем считать данные потерянными. См. как читать результат проверки.
Возвращаемые данные определяют, что сохраняется и отправляется. Они не меняют того, что проверка использует для решения: liveness по-прежнему анализирует видео, а проверка документа по-прежнему читает каждое поле, даже если вы не запрашиваете их обратно.