> ## 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 सुरक्षा > Didit KYC के दौरान डुप्लिकेट डिवाइस, VPN, प्रॉक्सी, Tor और संदेहास्पद डिवाइस फ़िंगरप्रिंट का पता लगाकर धोखाधड़ी रोकता है। Didit का डिवाइस और IP विश्लेषण सत्यापन वर्कफ़्लो में डिवाइस फ़िंगरप्रिंटिंग, डुप्लिकेट-डिवाइस रिकवरी, IP इंटेलिजेंस और भौगोलिक स्थिति (जियोलोकेशन) संबंधी जाँचों को जोड़ता है। यह पता लगाने में मदद करता है कि क्या वही भौतिक डिवाइस एकाधिक खातों को एक्सेस करने का प्रयास कर रहा है, भले ही उपयोगकर्ता सत्र बदले, ब्राउज़र स्टोरेज साफ़ करे, गुप्त विंडो खोले, या नेटवर्क जानकारी को बदले। डिवाइस और IP विश्लेषण इंटीग्रेशन प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

\````# 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````

\
यहाँ पेस्ट करें यह सुविधा उन धोखाधड़ी-रोकथाम निर्णयों के लिए डिज़ाइन की गई है जहाँ फ़ॉल्स पॉज़िटिव बहुत महंगे साबित होते हैं। सटीक डुप्लिकेट-डिवाइस मिलान स्थिर स्थायी पहचानकर्ताओं का उपयोग करते हैं। रिकवर किए गए डिवाइस मिलान v2 फ़िंगरप्रिंट सिग्नल वेक्टर और उच्च-विश्वास गेट्स का उपयोग करते हैं, ताकि Didit असंबद्ध उपयोगकर्ताओं को बहुत अधिक आक्रामक रूप से मर्ज किए बिना संदिग्ध पुन: उपयोग को सामने ला सके।सत्यापन परिणाम पढ़ने पर Academy के पाठ में, 9:49 का अध्याय डिवाइस और IP विश्लेषण सिग्नलों के बारे में विस्तार से बताता है।[डिवाइस और IP विश्लेषण — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![जियोलोकेशन, डिवाइस फ़िंगरप्रिंटिंग, डिवाइस इंटेलिजेंस और VPN पहचान दिखाने वाला Didit के डिवाइस और IP विश्लेषण का अवलोकन](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. डिवाइस फ़िंगरप्रिंट कैप्चर**सत्यापन क्लाइंट वेब या मोबाइल डिवाइस सिग्नलों के साथ गोपनीयता-सुरक्षित v2 फ़िंगरप्रिंट payload भेजता है:| डेटा पॉइंट | विवरण | | - | - | | **स्थायी डिवाइस ID** | ठीक उसी डिवाइस का पता लगाने के लिए उपयोग किया जाने वाला फ़र्स्ट-पार्टी पहचानकर्ता जब स्टोरेज बना रहता है। | | **कंपोज़िट हैश** | कोलिज़न सुरक्षा उपायों के साथ नियतात्मक (डिटरमिनिस्टिक) डुप्लिकेट जाँचों के लिए उपयोग किया जाने वाला स्थिर समूहीकृत सिग्नल हैश। | | **सिग्नल वेक्टर** | उच्च-विश्वास रिकवरी के लिए वेक्टराइज़ किए गए डिवाइस और ब्राउज़र/ऐप विशेषताएँ। | | **प्लेटफ़ॉर्म संदर्भ** | ब्राउज़र, OS, ऐप, हार्डवेयर, WebGL/कैनवास, मीडिया, लोकेल, टाइमज़ोन और जहाँ उपलब्ध हो, मोबाइल अखंडता सिग्नल। |**2. IP और कनेक्शन विश्लेषण**Didit देखे गए कनेक्शन डेटा को नेटवर्क जोखिम जानकारी के साथ समृद्ध करता है:- देश, क्षेत्र, शहर और निर्देशांक द्वारा IP जियोलोकेशन - VPN, प्रॉक्सी, Tor, डेटा सेंटर और निजी-नेटवर्क का पता लगाना - जब आप सत्र के लिए कोई अनुमत IP प्रदान करते हैं, तो अपेक्षित IP की जाँच - आपके एप्लिकेशन में कॉन्फ़िगर की गई IP ब्लॉकलिस्ट जाँचें**3. डुप्लिकेट और रिकवरी मिलान**Didit जाँचता है कि क्या वर्तमान सत्र किसी अन्य `vendor_data` के पिछले सत्रों से मेल खाता है:| जाँच | उद्देश्य | | - | - | | **डुप्लिकेट IP** | विभिन्न उपयोगकर्ताओं में समान IP पते का पता लगाता है। | | **डुप्लिकेट डिवाइस फ़िंगरप्रिंट** | उसी स्थायी डिवाइस पहचान के सटीक पुन: उपयोग का पता लगाता है। | | **रिकवर किया गया डिवाइस** | स्थायी ID बदलने पर उच्च-विश्वास v2 फ़िंगरप्रिंट रिकवरी का पता लगाता है। | | **कोलिज़न गार्ड** | असंबद्ध डिवाइसों को मर्ज करने के बजाय कम गुणवत्ता वाले पूल्ड हैश को दबा देता है। |**4. स्थान क्रॉस-चेक**डिवाइस और IP विश्लेषण विश्वसनीय संदर्भ बिंदुओं के साथ स्थान संदर्भ की तुलना करता है:- दस्तावेज़ का देश और पते के निर्देशांक - अपेक्षित सत्र IP पता - IP देश और शहर - पते और IP स्थान के बीच की दूरी और दिशा**5. कार्रवाई और रिपोर्टिंग**आप प्रत्येक जोखिम श्रेणी को स्वतंत्र रूप से कॉन्फ़िगर कर सकते हैं और प्रत्येक Didit आउटपुट में परिणाम प्राप्त कर सकते हैं:| चैनल | विवरण | | - | - | | **वर्कफ़्लो कार्रवाइयाँ** | VPN/प्रॉक्सी, स्थान बेमेल, डुप्लिकेट IP, सटीक डुप्लिकेट डिवाइस और रिकवर किए गए डिवाइस के लिए स्वीकृत करें, समीक्षा करें, या अस्वीकृत करें। | | **डैशबोर्ड** | Didit कंसोल में चेतावनियों, मिलान वाले सत्रों, डिवाइस जानकारी और नेटवर्क विवरणों की समीक्षा करें। | | **webhook और API** | निर्णय payloads में संरचित चेतावनियाँ और मिलान प्राप्त करें। | | **रिपोर्ट** | सत्यापन PDF में डिवाइस और IP विश्लेषण विवरण एक्सपोर्ट करें। |## मिलान मॉडलडिवाइस और IP विश्लेषण सटीक मिलानों को रिकवर किए गए मिलानों से अलग करता है ताकि आप धोखाधड़ी प्रतिक्रिया को सुरक्षित रूप से ट्यून कर सकें:| स्तर | यह क्या पता लगाता है | फ़ॉल्स-पॉज़िटिव स्थिति | | - | - | - | | **सटीक स्थायी ID** | किसी अन्य उपयोगकर्ता के सत्र में वही फ़र्स्ट-पार्टी डिवाइस पहचान दिखाई देती है। | सबसे मजबूत सिग्नल। `DUPLICATED_DEVICE_FINGERPRINT` के लिए उपयोग किया जाता है। | | **कंपोज़िट हैश** | किसी अन्य उपयोगकर्ता के सत्र में वही नियतात्मक डिवाइस हैश दिखाई देता है। | कोलिज़न पहचान द्वारा संरक्षित ताकि सामान्य WebView/ब्राउज़र पूल दबा दिए जाएँ। | | **v2 रिकवर किया गया डिवाइस** | स्थायी ID बदल गई, लेकिन समृद्ध डिवाइस सिग्नल उच्च विश्वास के साथ किसी पिछले डिवाइस से मेल खाते हैं। | रूढ़िवादी (कंजर्वेटिव)। हार्ड गेट्स पास होने के बाद ही `DEVICE_RECOVERED_HIGH_CONFIDENCE` के लिए उपयोग किया जाता है। | | **IP पुन: उपयोग** | विभिन्न उपयोगकर्ताओं में समान IP पता दिखाई देता है। | प्रासंगिक। धोखाधड़ी के गिरोहों के लिए उपयोगी, लेकिन साझा कार्यालय, घर और मोबाइल ऑपरेटर वैध हो सकते हैं। |रिकवर किए गए डिवाइस का मिलान एक समर्पित वेक्टर रिकवरी इंडेक्स का उपयोग करता है। यदि वह इंडेक्स उपलब्ध नहीं है, तो Didit सटीक डुप्लिकेट जाँच जारी रखता है और फ़ज़ी रिकवरी उम्मीदवारों को उत्पन्न नहीं करता है।**नेटवर्क** में, Didit आवासीय प्रॉक्सी पुन: उपयोग को भी हाइलाइट करता है जब वही गैर-डेटासेंटर IP इंटेलिजेंस कई अलग-अलग उपयोगकर्ताओं या व्यवसायों में दिखाई देता है। ग्राफ़ कुल जोखिम सिग्नल, विषयों की संख्या, कनेक्शन प्रकार, ISP और ASN संदर्भ दिखाता है; यह रॉ IP पते या किसी अन्य संगठन के प्रोफ़ाइल डेटा को उजागर नहीं करता है।## पहचाने गए धोखाधड़ी पैटर्नडिवाइस और IP विश्लेषण निम्नलिखित की पहचान करने और उन्हें कम करने में मदद करता है:- मल्टी-अकाउंटिंग और डुप्लिकेट-अकाउंट निर्माण - विभिन्न पहचानों के लिए एक ही डिवाइस का उपयोग करके KYC बायपास करने के प्रयास - साझा किए गए डिवाइसों या इंफ्रास्ट्रक्चर से कई खातों का समन्वय करने वाले धोखाधड़ी गिरोह - बोनस दुरुपयोग, रेफ़रल दुरुपयोग, प्रोमो दुरुपयोग और निःशुल्क परीक्षण दुरुपयोग - बार-बार उपयोग किए जाने वाले डिवाइसों से सिंथेटिक पहचान ऑनबोर्डिंग - मनी म्यूल ऑनबोर्डिंग पैटर्न - अपरिचित या उच्च-जोखिम वाले डिवाइसों से खाता अधिग्रहण का जोखिम - क्रेडेंशियल स्टफ़िंग और स्वचालित साइनअप प्रयास - बार-बार दोहराए जाने वाले डिवाइस/नेटवर्क पैटर्न द्वारा समर्थित कार्ड टेस्टिंग, चार्जबैक दुरुपयोग और धनवापसी दुरुपयोग - VPN, प्रॉक्सी, Tor, डेटा सेंटर और आवासीय प्रॉक्सी का उपयोग करके बच निकलने की कोशिशें - मोबाइल सिग्नल उपलब्ध होने पर डिवाइस से छेड़छाड़, एमुलेटर का उपयोग, जेलब्रेक/रूट जोखिम और ऐप क्लोनिंग - लोकेशन स्पूफिंग और दस्तावेज़, 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/hi/core-technology/ip-analysis/warnings-ip-analysis.md) और API फ़ील्ड के लिए [वर्कफ़्लो सुविधा कॉन्फ़िगरेशन](https://docs.didit.me/hi/management-api/workflows/feature-configs.md#डिवाइस-और-ip-विश्लेषण) देखें। This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.