> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Фингерпринтинг устройств и оценка IP-рисков: API для KYC

> Анализ устройства и IP от Didit выявляет дубликаты устройств, сети мошенников, VPN, прокси, Tor и несовпадение локации при KYC.

Анализ устройства и IP от Didit объединяет снятие цифрового отпечатка устройства, восстановление идентичности устройств-дубликатов, анализ IP-адресов и проверки геолокации в процессе верификации. Это помогает обнаружить попытки доступа к нескольким аккаунтам с одного и того же физического устройства, даже если пользователь меняет сессии, очищает хранилище браузера, открывает окно в режиме инкогнито или меняет параметры сети.

Промпт для интеграции анализа устройства и IP
        Скопировать промпт в буфер обмена



      
      

\<pre>

\````# Goal
Integrate Didit Device & IP Analysis (device fingerprinting + IP intelligence + geolocation) into your app.

\# Delivery mode
IP Analysis is **session-only**. The Web/Mobile SDK collects the device fingerprint and IP during the hosted flow — there is no standalone /v3/ip-analysis/ endpoint. It runs automatically on every session and does not require a workflow feature toggle for the basic signal set.

\# Steps
1\. (Optional) In the Business Console enable strict-mode rules for IP / device — e.g. "decline on VPN", "review on duplicate device", "decline on country mismatch with document".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user — the SDK collects fingerprint + IP in-band.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

curl (create session):
\```bash
curl -X POST 'https://verification.didit.me/v3/session/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_WORKFLOW_ID",
"vendor_data": "user-123",
"callback": "https://yourapp.com/post-kyc"
}'
\```

\# Decision surface
The result lands under `ip_analyses[]` on the decision payload (one entry per IP/device collection point in the workflow). Each entry carries the resolved geo, ASN, VPN / proxy / Tor flags, device fingerprint id, duplicate-device matches, and the warnings array.

\# Status enum (per ip_analyses[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.LOCATION)
Heads-up: IP Analysis emits warnings under the **LOCATION** bucket (not "IP_ANALYSIS"). Risk codes include:
VPN_DETECTED, PROXY_DETECTED, TOR_DETECTED, DATACENTER_IP, HIGH_RISK_COUNTRY, LOCATION_MISMATCH_WITH_DOCUMENT, DUPLICATED_DEVICE, POSSIBLE_DUPLICATED_DEVICE, IMPOSSIBLE_TRAVEL, DEVICE_FINGERPRINT_BLOCKLISTED, DEVICE_LINKED_TO_LIVENESS_ATTACK, DEVICE_MODEL_INCONSISTENT.
Full catalogue: /core-technology/ip-analysis/warnings-ip-analysis.

\# Failure modes to handle
\- ip_analyses[] empty — the user blocked the SDK fingerprinting script (privacy extensions, content blockers). Decide whether to fail-closed or fall back to soft signals.
\- VPN_DETECTED / PROXY_DETECTED / TOR_DETECTED — treat per your fraud policy (decline, manual review, additional liveness step).
\- DUPLICATED_DEVICE — same device previously enrolled under a different vendor_data; merge accounts or block per policy.
\- LOCATION_MISMATCH_WITH_DOCUMENT — the IP country does not match the document's issuing country; route to review.

\# See also
\- Canonical schema: /reference/data-models#ip-analysis
\- Per-feature report: /core-technology/ip-analysis/report-ip-analysis
\- Risk catalogue: /core-technology/ip-analysis/warnings-ip-analysis
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Вставьте в

Эта функция разработана для принятия решений по предотвращению мошенничества в ситуациях, когда ложные срабатывания обходятся дорого. Точные совпадения дубликатов устройств используют стабильные постоянные идентификаторы. Совпадения восстановленных устройств используют вектор сигналов отпечатков v2 и фильтры высокой степени уверенности, благодаря чему Didit может выявлять подозрительное повторное использование, не объединяя несвязанных между собой пользователей слишком агрессивно.В уроке Didit Academy о том, как читать результаты верификации, в таймкоде 9:49 подробно разбираются сигналы анализа устройства и IP.[Анализ устройства и IP - Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Обзор Анализа устройства и IP от Didit, демонстрирующий геолокацию, снятие отпечатка устройства, аналитику устройства и обнаружение VPN](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=a2fbbbdd3d6fed3d759e54f362bf4762)![Архитектурная схема Анализа устройства и IP от Didit с перекрёстной проверкой IP-адреса, отпечатка устройства и заявленного местоположения](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis-how-it-works.jpg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=3519ad9ad50091a00db5e09d5197fdfe)## Как это работаетАнализ устройства и IP запускается автоматически во время сессии верификации и объединяет контекст устройства, сети и личности в единую область оценки рисков.**1. Захват цифрового отпечатка устройства**Клиент верификации отправляет payload отпечатка v2, обеспечивающий конфиденциальность, с сигналами веб- или мобильного устройства:| Элемент данных | Описание |
| - | - |
| **Постоянный ID устройства** | Собственный идентификатор, используемый для точного обнаружения того же устройства при сохранении данных в хранилище. |
| **Составной хеш** | Стабильный хеш сгруппированных сигналов, используемый для детерминированных проверок на дубликаты с защитой от коллизий. |
| **Вектор сигналов** | Атрибуты устройства и браузера/приложения, векторизованные для восстановления с высокой степенью уверенности. |
| **Контекст платформы** | Сигналы браузера, ОС, приложения, аппаратного обеспечения, WebGL/canvas, мультимедиа, локали, часового пояса и целостности мобильного устройства (где доступно). |**2. Анализ IP и соединения**Didit обогащает наблюдаемые данные о соединении информацией о сетевых рисках:- Геолокация IP по стране, региону, городу и координатам
- Обнаружение VPN, прокси, Tor, центров обработки данных и частных сетей
- Проверка ожидаемого IP-адреса, если вы передаёте разрешённый IP для сессии
- Проверка по спискам блокировки IP, настроенным в вашем приложении**3. Поиск дубликатов и сопоставление восстановленных устройств**Didit проверяет, совпадает ли текущая сессия с предыдущими сессиями с другим значением `vendor_data`:| Проверка | Назначение |
| - | - |
| **Дублирующийся IP** | Обнаруживает один и тот же IP-адрес у разных пользователей. |
| **Дублирующийся отпечаток устройства** | Обнаруживает точное повторное использование того же постоянного идентификатора устройства. |
| **Восстановленное устройство** | Обнаруживает восстановление по отпечатку v2 с высокой степенью уверенности, если постоянный ID изменился. |
| **Защита от коллизий** | Отсекает низкокачественные хеши из общих пулов вместо ошибочного слияния не связанных между собой устройств. |**4. Перекрёстные проверки местоположения**Анализ устройства и IP сравнивает контекст местоположения с доверенными опорными точками:- Страна документа и координаты адреса
- Ожидаемый IP-адрес сессии
- Страна и город по IP
- Расстояние и направление между адресом и местоположением по IP**5. Действия и отчётность**Вы можете независимо настроить каждую категорию рисков и использовать результат в каждом выходном формате Didit:| Канал | Описание |
| - | - |
| **Действия в сценарии** | Одобрить, отправить на проверку или отклонить при обнаружении VPN/прокси, несовпадении местоположения, дублирующемся IP, точном дубликате устройства и восстановленном устройстве. |
| **Панель управления** | Просмотр предупреждений, совпадающих сессий, информации об устройстве и сведений о сети в консоли Didit. |
| **Webhook и API** | Получение структурированных предупреждений и совпадений в payload решений. |
| **Отчёты** | Экспорт сведений об анализе устройства и IP в PDF-отчётах о верификации. |## Модель сопоставленияАнализ устройства и IP разделяет точные совпадения и восстановленные совпадения, что позволяет безопасно настраивать реагирование на мошенничество:| Уровень | Что обнаруживает | Подход к ложным срабатываниям |
| - | - | - |
| **Точный постоянный ID** | Тот же собственный идентификатор устройства появляется в сессии другого пользователя. | Самый сильный сигнал. Используется для `DUPLICATED_DEVICE_FINGERPRINT`. |
| **Составной хеш** | Тот же детерминированный хеш устройства появляется в сессии другого пользователя. | Защищён механизмом обнаружения коллизий, поэтому общие пулы WebView/браузеров отсекаются. |
| **Восстановленное устройство v2** | Постоянный ID изменился, но подробный набор сигналов устройства совпадает с предыдущим устройством с высокой степенью уверенности. | Консервативный подход. Используется для `DEVICE_RECOVERED_HIGH_CONFIDENCE` только после прохождения строгих проверок. |
| **Повторное использование IP** | Один и тот же IP-адрес появляется у разных пользователей. | Зависит от контекста. Полезно для выявления сетей мошенников, однако общие офисы, домохозяйства и мобильные операторы могут быть легитимными. |Для сопоставления восстановленных устройств используется специальный индекс векторного восстановления. Если этот индекс недоступен, Didit продолжает выполнять проверки на точные дубликаты и не выдаёт кандидатов на восстановление по нечёткому совпадению.В разделе **Networks** Didit также подсвечивает повторное использование резидентных прокси, когда одни и те же сведения об IP-адресе, не относящемся к ЦОД, появляются у нескольких различных пользователей или компаний. Граф отображает совокупный сигнал риска, количество субъектов, тип соединения, а также контекст провайдера (ISP) и ASN; при этом исходный IP-адрес или данные профиля другой организации не раскрываются.## Выявляемые паттерны мошенничестваАнализ устройства и IP помогает выявлять и снижать следующие риски:- Мультиаккаунтинг и создание дублирующих аккаунтов
- Попытки обхода KYC с использованием одного и того же устройства для разных профилей личности
- Мошеннические сети, координирующие множество аккаунтов с использованием общих устройств или инфраструктуры
- Злоупотребление бонусами, реферальными программами, промоакциями и бесплатными пробными периодами
- Онбординг синтетических личностей с устройств, использовавшихся неоднократно
- Паттерны онбординга денежных мулов
- Риск захвата аккаунтов с незнакомых или высокорисковых устройств
- Атаки с подбором учётных данных и автоматизированные попытки регистрации
- Тестирование карт, злоупотребление чарджбэками и возвратами средств, сопровождающиеся повторяющимися паттернами устройств/сетей
- Обход проверок через VPN, прокси, Tor, дата-центры и резидентные прокси
- Вмешательство в работу устройства, использование эмуляторов, риски джейлбрейка/root и клонирование приложений (при наличии мобильных сигналов)
- Спуфинг геолокации и несоответствия между документом, IP-адресом, часовым поясом, оператором связи и контекстом устройства
- Попытки верификации с помощью ботов с использованием браузеров без графического интерфейса или скриптовых клиентов## Ключевые возможности#### Снятие цифровых отпечатков устройств и их восстановление- **Точное обнаружение дубликатов устройств**: выявление одного и того же устройства в сессиях с разными значениями `vendor_data`.
- **Восстановление с высокой степенью уверенности**: выявление вероятных связей между сессиями с одного устройства при изменении хранилища или смене постоянного ID в режиме инкогнито/приватного просмотра.
- **Защита от коллизий**: предотвращение ошибочного объединения несвязанных пользователей, если хэш устройства слишком распространен среди множества различных постоянных ID.
- **Охват веба и мобильных платформ**: использование сигналов веб-браузера и нативных мобильных сигналов, включая поля проверки целостности системы (когда они доступны).#### Аналитика по IP и сетям- **Обнаружение VPN и прокси**: выявление маскированных или анонимизированных подключений.
- **Обнаружение Tor и дата-центров**: маркировка высокорисковой инфраструктуры.
- **Повторное использование резидентного прокси**: выявление повторяющегося использования одной и той же сети резидентного типа разными субъектами без раскрытия исходного IP-адреса в графе сетей.
- **Списки блокировки IP**: автоматическое отклонение сессий, если IP-адрес находится в вашем списке блокировки приложения.
- **Контроль ожидаемого IP**: сравнение обнаруженного IP-адреса с ожидаемым IP, переданным при создании сессии.#### Геолокация и сопоставление с документом- **Выявление несоответствия страны**: сравнение страны документа и страны IP-адреса.
- **Геозонирование**: прием сессий только из разрешенных стран (с возможностью переопределения правил для отдельных штатов/регионов в таких странах, как США) на основе геолокации IP.
- **Проверка расстояния до адреса**: сравнение координат адреса в документе и геолокации по IP.
- **Контекст совпадений по сессиям**: предоставление совпадающих сессий с информацией об устройстве и местоположении для ручной проверки сотрудниками.## Настройка действийИспользуйте настройки сценария, чтобы выбрать действие для каждого риска. Консервативные клиенты часто сначала устанавливают для `recovered_device_action` значение `REVIEW`, отслеживают предупреждения о восстановленных устройствах в течение нескольких недель и переходят на `DECLINE` только после оценки профиля ложных срабатываний в вашей системе.| Настройка | Рекомендуемое начальное действие | Причина |
| - | - | - |
| `vpn_detection_action` | `REVIEW` или `DECLINE` | Зависит от того, разрешено ли использование VPN в вашем продукте. |
| `ip_mismatch_action` | `REVIEW` | Несоответствие местоположения — важный контекст, но оно может быть легитимным. |
| `duplicated_ip_action` | `REVIEW` | Общие сети могут приводить к ложным срабатываниям. |
| `duplicated_device_action` | `REVIEW` или `DECLINE` | Точное повторное использование одного устройства разными пользователями — сильный сигнал мошенничества. |
| `recovered_device_action` | `REVIEW` | Восстановление с высокой степенью уверенности намеренно консервативно, но требует мониторинга перед переходом к автоматическому отклонению. |
| `ip_geofencing_action` | `DECLINE` | Геозонирование обычно отражает жесткие юрисдикционные правила; используйте `REVIEW`, если предпочитаете ручную проверку ограниченных локаций. |Ознакомьтесь с разделом [Предупреждения анализа устройства и IP](https://docs.didit.me/ru/core-technology/ip-analysis/warnings-ip-analysis.md) для изучения всех меток рисков и разделом [Конфигурация функций сценария](https://docs.didit.me/ru/management-api/workflows/feature-configs.md#анализ-устройства-и-ip) для описания полей API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.