> ## 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 لـ KYC

> يكشف 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 من إظهار إعادة الاستخدام المشبوهة دون دمج مستخدمين لا صلة بينهم بشكل مفرط.في درس Academy حول قراءة نتيجة التحقق، يستعرض فصل الدقيقة 9:49 إشارات تحليل الجهاز وعنوان IP.[تحليل الجهاز وعنوان IP - أكاديمية Didit](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 تراعي الخصوصية مع إشارات أجهزة الويب أو الأجهزة المحمولة:| نقطة البيانات | الوصف |
| - | - |
| **معرّف الجهاز المستمر** | معرّف الطرف الأول يُستخدم لكشف نفس الجهاز بدقة عند استمرار التخزين. |
| **التجزئة المركبة** | تجزئة إشارات مجمعة ومستقرة تُستخدم لفحوصات التكرار الحتمية مع حماية ضد التعارض. |
| **متجه الإشارات** | سمات الجهاز والمتصفح/التطبيق المحوَّلة إلى متجهات للاستعادة عالية الثقة. |
| **سياق المنصة** | إشارات المتصفح ونظام التشغيل والتطبيق والعتاد وWebGL/canvas والوسائط والإعدادات المحلية والمنطقة الزمنية وسلامة الأجهزة المحمولة حيثما كانت متاحة. |**2. تحليل عنوان IP والاتصال**تثري Didit بيانات الاتصال المرصودة بمعلومات مخاطر الشبكة:- الموقع الجغرافي لعنوان IP حسب الدولة والمنطقة والمدينة والإحداثيات
- كشف VPN والبروكسي وTor ومراكز البيانات والشبكات الخاصة
- فحوصات عنوان IP المتوقع عند توفير عنوان IP مسموح به للجلسة
- فحوصات قائمة الحظر المكوَّنة في تطبيقك لعناوين IP**3. مطابقة الأجهزة المكررة والمستعادة**تتحقق Didit مما إذا كانت الجلسة الحالية تطابق جلسات سابقة من قيمة `vendor_data` أخرى:| الفحص | الغرض |
| - | - |
| **عنوان IP مكرر** | يكشف عن نفس عنوان IP عبر مستخدمين مختلفين. |
| **بصمة جهاز مكررة** | يكشف عن إعادة الاستخدام الدقيقة لنفس هوية الجهاز المستمرة. |
| **جهاز مستعاد** | يكشف عن استعادة عالية الثقة لبصمة v2 عند تغير المعرّف المستمر. |
| **حماية التعارض** | يستبعد التجزئات المجمعة منخفضة الجودة بدلاً من دمج أجهزة غير مرتبطة. |**4. المطابقة المتقاطعة للموقع الجغرافي**يقارن تحليل الجهاز وعنوان IP سياق الموقع الجغرافي بنقاط مرجعية موثوقة:- دولة المستند وإحداثيات العنوان
- عنوان IP المتوقع للجلسة
- دولة ومدينة عنوان IP
- المسافة والاتجاه بين العنوان وموقع عنوان IP**5. الإجراء وإعداد التقارير**يمكنك تكوين كل فئة مخاطر بشكل مستقل واستخدام النتيجة في جميع مخرجات Didit:| القناة | الوصف |
| - | - |
| **إجراءات سير العمل** | الموافقة أو المراجعة أو الرفض لـ VPN/البروكسي، وعدم تطابق الموقع، وتكرار عنوان IP، والجهاز المكرر المطابق تمامًا، والجهاز المستعاد. |
| **لوحة التحكم** | مراجعة التحذيرات والجلسات المتطابقة ومعلومات الجهاز وتفاصيل الشبكة في لوحة تحكم Didit. |
| **webhook وواجهات API** | تلقي تحذيرات ومطابقات منظمة في payload الخاصة بالقرارات. |
| **التقارير** | تصدير تفاصيل تحليل الجهاز وعنوان IP في ملفات PDF للتحقق. |## نموذج المطابقةيفصل تحليل الجهاز وعنوان IP بين المطابقات الدقيقة والمطابقات المستعادة حتى تتمكن من ضبط الاستجابة للاحتيال بأمان:| الطبقة | ما تكشفه | الموقف من النتائج الإيجابية الكاذبة |
| - | - | - |
| **المعرّف المستمر الدقيق** | ظهور نفس هوية جهاز الطرف الأول في جلسة مستخدم آخر. | أقوى إشارة. تُستخدم لـ `DUPLICATED_DEVICE_FINGERPRINT`. |
| **التجزئة المركبة** | ظهور نفس تجزئة الجهاز الحتمية في جلسة مستخدم آخر. | محمية بكشف التعارض بحيث يتم استبعاد تجمعات WebView/المتصفح الشائعة. |
| **الجهاز المستعاد v2** | تغير المعرّف المستمر، ولكن إشارات الجهاز الغنية تطابق جهازاً سابقاً بثقة عالية. | متحفظ. يُستخدم لـ `DEVICE_RECOVERED_HIGH_CONFIDENCE` فقط بعد اجتياز بوابات صارمة. |
| **إعادة استخدام عنوان IP** | ظهور نفس عنوان IP عبر المستخدمين. | سياقي. مفيد لشبكات الاحتيال، ولكن المكاتب المشتركة والمنازل ومشغلي شبكات الهاتف المحمول قد تكون مشروعة. |تستخدم مطابقة الأجهزة المستعادة فهرس استعادة متجهات مخصصاً. إذا لم يكن هذا الفهرس متاحاً، تواصل Didit إجراء فحوصات التكرار الدقيقة ولا تُصدر مرشحي استعادة تقريبية.في **Networks**، تسلط Didit الضوء أيضاً على إعادة استخدام البروكسي السكني عندما تظهر معلومات استخبارات عنوان IP نفسه، غير التابع لمركز بيانات عبر عدة مستخدمين أو شركات مختلفة. يعرض المخطط إشارة المخاطر المجمعة، وعدد الكيانات، ونوع الاتصال، وسياق مزود خدمة الإنترنت (ISP) ورقم النظام المستقل (ASN)؛ ولا يكشف عن عنوان IP الخام أو بيانات الملف التعريفي لمؤسسة أخرى.## أنماط الاحتيال المكتشفةيساعد تحليل الجهاز وعنوان IP على تحديد الأنماط التالية والحد منها:- إنشاء حسابات متعددة وحسابات مكررة
- محاولات تجاوز KYC باستخدام نفس الجهاز عبر هويات مختلفة
- شبكات الاحتيال التي تنسق حسابات متعددة من أجهزة أو بنية تحتية مشتركة
- إساءة استخدام المكافآت، وإساءة استخدام الإحالات، وإساءة استخدام العروض الترويجية، وإساءة استخدام الفترات التجريبية المجانية
- تسجيل الهويات الاصطناعية من أجهزة مستخدمة مرارًا
- أنماط تسجيل البغال المالية
- مخاطر الاستيلاء على الحسابات من أجهزة غير مألوفة أو عالية المخاطر
- هجمات حشو بيانات الاعتماد ومحاولات التسجيل الآلية
- تجربة البطاقات، وإساءة استخدام رد المبالغ المدفوعة، وإساءة استخدام طلبات الاسترداد المدعومة بأنماط أجهزة أو شبكات متكررة
- التهرب عبر شبكات VPN، والوكيل، وTor، ومراكز البيانات، والوكلاء السكنيين
- التلاعب بالجهاز، واستخدام المحاكيات، ومخاطر كسر الحماية (Jailbreak/Root)، واستنساخ التطبيقات عند توفر إشارات الهاتف المحمول
- انتحال الموقع الجغرافي وحالات عدم التطابق بين المستند، وعنوان IP، والمنطقة الزمنية، وشركة الاتصالات، وسياق الجهاز
- محاولات التحقق المعتمدة على البوتات باستخدام المتصفحات غير المزودة بواجهة رسومية أو البرامج العميلة التي تعمل بنصوص برمجية## الإمكانات الرئيسية#### أخذ بصمة الجهاز واستعادته- **الكشف الدقيق عن الأجهزة المكررة**: اكتشاف هوية الجهاز نفسها عبر الجلسات من قيم `vendor_data` مختلفة.
- **الاستعادة عالية الثقة**: استعادة العلاقات التي يُرجح أنها للجهاز نفسه عندما يغير التخزين أو التصفح المتخفي/الخاص المعرّف الدائم.
- **الحماية من التعارض**: تجنب دمج مستخدمين غير مرتبطين عندما تبدو تجزئة الجهاز شائعة للغاية عبر العديد من المعرّفات الدائمة المختلفة.
- **تغطية الويب والهواتف المحمولة**: استخدام إشارات متصفح الويب وإشارات الهاتف المحمول الأصلية، بما في ذلك الحقول المتعلقة بالنزاهة عند توفرها.#### المعلومات الاستخباراتية الخاصة بعناوين IP والشبكة- **كشف VPN والوكيل**: تحديد الاتصالات المستترة أو مجهولة الهوية.
- **كشف Tor ومراكز البيانات**: تمييز البنية التحتية عالية المخاطر بعلامة.
- **إعادة استخدام وكيل سكني**: اكتشاف الاستخدام المتكرر للشبكة السكنية الظاهرة نفسها عبر أطراف متميزة دون كشف قيمة عنوان IP الخام في مخطط Networks.
- **قوائم حظر عناوين 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/ar/core-technology/ip-analysis/warnings-ip-analysis.md) لمعرفة جميع وسوم المخاطر، و[تكوينات ميزات سير العمل](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#تحليل-الجهاز-وعنوان-ip) لحقول API.


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