البيانات الوصفية للجهاز
تُعيد هذه القدرة بيانات الجهاز الذي أجرى منه المستخدم الالتقاط، إلى جانب نتائج المنتجات الأخرى المتعاقد عليها.
ما الذي تفعله
تجمع البيانات الوصفية للجهاز المستخدم في جلسة الالتقاط وإشارات المخاطر المكتشفة عليه (تفاصيل البيانات أدناه).
هي ليست عملية تحقق: لا توافق على العملية ولا ترفضها أبداً، ولا تتسبب أبداً في فشلها. استخدم البيانات في قواعد المخاطر الخاصة بك أو في محركات القرار الداخلية لديك.
المدخلات
لا حاجة إلى أي حقل إضافي. تستخدم القدرة جلسة الالتقاط الموجودة بالفعل في العملية.
- Web: الالتقاط الذي يتم في رحلة Unico.
- API مع Unico SDK: الال تقاط الذي يُجريه Unico SDK داخل تطبيقك.
Unico SDK هو الذي يجمع البيانات الوصفية أثناء الالتقاط. قد يستخدم تكامل API الـ Unico SDK وقد لا يستخدمه:
- API مع Unico SDK: تُعاد البيانات الوصفية كالمعتاد.
- API بدون Unico SDK: لا توجد بيانات وصفية، وتكون الاستجابة
not_found.
يتم تفعيل القدرة في تدفق متعاقد عليه لحسابك. تواصل مع جهة اتصالك في Unico لتفعيلها.
الاستجابات المحتملة
تأتي النتيجة في الكائن authenticationInfo.deviceMetadata من الحصول على العملية.
status | المعنى |
|---|---|
found | تم العثور على البيانات الوصفية للجهاز. الحقول أدناه مملوءة بما جمعه الجهاز. |
not_found | لا توجد بيانات وصفية للجهاز لهذا الالتقاط، على سبيل المثال عملية API بدون Unico SDK. |
unavailable | تعذّر جلب البيانات الوصفية في تلك اللحظة. لا تتأثر نتيجة العملية. |
عندما تكون قيمة status هي found:
| الحقل | النوع | الوصف |
|---|---|---|
deviceId | string | معرّف الجهاز. |
platform | string | المنصة التي جاء منها الالتقاط، مثل WEB، ANDROID، IOS. |
ip | string | عنوان IP للجهاز. |
ipCountry | string | دولة عنوان IP. |
ipGeoCoordinates | object | موقع عنوان IP (lat، lng). |
gpsCoordinates | object | الموقع الذي أبلغ عنه GPS الجهاز (lat، lng). |
osName | string | اسم نظام التشغيل. |
osVersion | string | إصدار نظام التشغيل. |
browserName | string | اسم المتصفح. Web فقط. |
userAgent | string | وكيل المستخدم (user agent) للمتصفح. Web فقط. |
appStore | string | متجر التطبيقات الذي تم تثبيت تطبيقك منه. SDK الأصلي فقط. |
detectedSignals | مصفوفة سلاسل نصية | مجموعات إشارات المخاطر المكتشفة على الجهاز. تكون فارغة عندما لا يُكتشف أي منها. |
غياب أي حقل يعني أن الجهاز لم يجمع تلك البيانات.
تُدرج detectedSignals المجموعات المكتشفة فقط. تُعدّ المجموعة مكتشفة عند العثور على إشارة واحدة على الأقل من إشاراتها:
| المجموعة | ما تعنيه |
|---|---|
origin_obfuscated | المصدر الحقيقي للوصول مخفي، على سبيل المثال عبر Tor أو أدوات مكافحة البصمة الرقمية. |
untrusted_location | قد يكون الموقع مزيفاً، على سبيل المثال عبر وكيل (proxy) أو VPN أو أداة لتزييف GPS. |
environment_altered | بيئة الجهاز معدّلة، على سبيل المثال محاكٍ أو جهاز مُخترق صلاحياته (root أو jailbreak). |
app_manipulated | تم العبث بالتطبيق أو اعتراضه (hooking) أو تصحيحه بأداة تصحيح الأخطاء. |
assisted_session | قد يكون شخص آخر هو من يتحكم في الجلسة، على سبيل المثال عبر مشاركة الشاشة أو بوت. |
payload_untrusted | تم العبث بالبيانات المرسلة من الجهاز. |
ليست كل إشارة موجودة على كل منصة، لذلك قد يُظهر الجهاز نفسه مجموعات مختلفة على Web وعلى SDK الأصلي.
التوافر
| مكونات التكامل المطلوبة |
|---|
| SDK Web or SDK |
التوليفات الصالحة
البيانات الوصفية للجهاز ليست جزءاً من التدفقات المُعدّة مسبقاً في التدفقات المتاحة. يمكن تفعيلها مع أي منتج آخر من Unico في تكاملات Web وSDK، في تدفق متعاقد عليه لحسابك.
المنتجات التي تستخدم هذه القدرة
يمكن إضافتها إلى أي منتج من Unico في تكاملات Web وSDK.