البيانات الوصفية للجهاز
تُعيد هذه القدرة بيانات الجهاز الذي أجرى منه المستخدم الالتقاط، إلى جانب نتائج المنتجات الأخرى المتعاقد عليها.
ما الذي تفعله
تجمع البيانات الوصفية للجهاز المستخدم في جلسة الالتقاط وإشارات المخاطر المكتشفة عليه (تفاصيل البيانات أدناه).
هي ليست عملية تحقق: لا توافق على العملية ولا ترفضها أبداً، ولا تتسبب أبداً في فشلها. استخدم البيانات في قواعد المخاطر الخاصة بك أو في محركات القرار الداخلية لديك.
المدخلات
لا حاجة إلى أي حقل إضافي. تست خدم القدرة جلسة الالتقاط الموجودة بالفعل في العملية.
- عقد Web و Native: يتم تفعيلها في تدفق متعاقد عليه لحسابك. تُدرج العملية
PROCESS_CAPACITY_DEVICE_METADATAفيcapacities. - عقد API: يتم تفعيلها في Recipe الخاصة بمفتاح API لديك.
Unico SDK هو الذي يجمع البيانات الوصفية أثناء الالتقاط. قد يستخدم تكامل API الـ Unico SDK وقد لا يستخدمه:
- API مع Unico SDK: تُعاد البيانات الوصفية كالمعتاد.
- API بدون Unico SDK: لا توجد بيانات وصفية، وتكون الاستجابة
not_found.
تواصل مع جهة اتصالك في Unico لتفعيلها.
الاستجابات المحتملة
تأتي النتيجة في كائن deviceMetadata:
- عقد Web و Native: في
authenticationInfo.deviceMetadataمن الحصول على العملية. - عقد API: في
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 | مصفوفة سلاسل نصية | مجموعات إشارات المخاطر المكتشفة على الجهاز. تكون فارغة عندما لا يُكتشف أي منها. |
الحقل الذي لم يجمعه الجهاز يكون غائباً في عقد Web و Native، وتكون قيمته null في عقد API.
تُدرج detectedSignals المجموعات المكتشفة فقط. تُعدّ المجموعة مكتشفة عند العثور على إشارة واحدة على الأقل من إشاراتها:
| المجموعة | ما تعنيه |
|---|---|
origin_obfuscated | المصدر الحقيقي للوصول مخفي، على سبيل المثال عبر Tor أو أدوات مكافحة البصمة الرقمية. |
untrusted_location | قد يكون الموقع مزيفاً، على سبيل المثال عبر وكيل (proxy) أو VPN أو أداة لتزييف GPS. |
environment_altered | بيئة الجهاز معدّلة، على سبيل المثال محاكٍ أو جهاز مُخترق صلاحياته (root أو jailbreak). |
app_manipulated | تم العبث بالتطبيق أو اعتراضه (hooking) أو تصحيحه بأداة تصحيح الأخطاء. |
assisted_session | قد يكون شخص آخر هو من يتحكم في الجلسة، على سبيل المثال عبر مشاركة الشاشة أو بوت. |
payload_untrusted | تم العبث بالبيانات المرسلة من الجهاز. |
ليست كل إشارة موجودة على كل منصة، لذلك قد يُظهر الجهاز نفسه مجموعات مختلفة على Web وعلى SDK الأصلي.
التوافر
| السطح | مدعوم |
|---|---|
| SDK (Android, iOS, Flutter) | ✅ |
| Web (iFrame, Redirect) | ✅ |
التوليفات الصالحة
البيانات الوصفية للجهاز ليست جزءاً من كتالوج flow المُعدّ مسبقاً في التدفقات المتاحة. يتم تفعيلها في تدفق متعاقد عليه لحسابك (عقد Web و Native) أو في Recipe الخاصة بمفتاح API لديك (عقد API)، ويمكن تفعيلها مع أي منتج آخر من Unico في تكاملات Web وSDK.
حالات الاستخدام التي تستخدم هذه القدرة
يمكن إضافتها إلى أي حالة استخدام من Unico في تكاملات Web وSDK.