البيانات الوصفية للجهاز

Markdown

تُعيد هذه القدرة بيانات الجهاز الذي أجرى منه المستخدم الالتقاط، إلى جانب نتائج المنتجات الأخرى المتعاقد عليها.

ما الذي تفعله

تجمع البيانات الوصفية للجهاز المستخدم في جلسة الالتقاط وإشارات المخاطر المكتشفة عليه (تفاصيل البيانات أدناه).

هي ليست عملية تحقق: لا توافق على العملية ولا ترفضها أبداً، ولا تتسبب أبداً في فشلها. استخدم البيانات في قواعد المخاطر الخاصة بك أو في محركات القرار الداخلية لديك.

المدخلات

لا حاجة إلى أي حقل إضافي. تستخدم القدرة جلسة الالتقاط الموجودة بالفعل في العملية.

• Web: الالتقاط الذي يتم في رحلة Unico.
• API مع Unico SDK: الالتقاط الذي يُجريه 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.