GEOLOCATION، وإعداداتها هي مفاتيح geolocation_*، وتظهر نتيجتها ضمن geolocation_checks[] في قرار الجلسة.
حالات الاستخدام
- إذا كنت تحمل ترخيصاً لبعض الولايات القضائية فقط (مثل ألعاب القمار، أو الوساطة المالية، أو الإقراض) ويتعين عليك إثبات وجود الشخص داخل أحدها عند تقديم طلبه.
- إذا كان يجب عليك منع وصول الأشخاص من الأماكن المحظورة، مثل منطقة خاضعة لعقوبات أو ولاية لا تقدم فيها خدماتك.
- إذا كنت ترغب في الحصول على إشارة إضافية لاكتشاف الاحتيال: مثل تباعد موقع الجهاز عن موقع IP أو عن العنوان الوارد في مستند الهوية، أو استخدام موقع زائف، أو شبكة VPN، أو محاكي.
- إذا كنت لا تحتاج إلى تتبع تحركات الشخص أو سجله، بل تكتفي بقراءة واحدة تؤخذ أثناء الجلسة.
آلية العمل
الإشعار والإذن
يرى الشخص سبب الحاجة إلى موقعه الجغرافي وأنه يُقرأ لمرة واحدة فقط لغرض هذا التحقق.
بعد ذلك يطلب متصفحه أو هاتفه الحصول على الإذن.
تسجل Didit الإشعار الذي وافق عليه (الإصدار واللغة والتوقيت) كقيمة
consent في النتيجة.موقع جغرافي واحد لكل محاولة
يحتفظ العميل بأفضل قراءة حتى تصبح دقيقة بما فيه الكفاية أو تنتهي مهلة المحاولة (المحددة افتراضياً بـ 20 ثانية).
تحمل كل محاولة رمز تحقق (تحدٍّ) للاستخدام لمرة واحدة ويكون صالحاً لمدة 5 دقائق ومرتبطاً بالجلسة، حتى لا يمكن إعادة استخدام الإرسال المعترض عليه.
الفحوصات
تقيّم Didit الدقة، وحداثة البيانات، وأذونات الموقع التقريبي، وإشارات الانتحال، والمناطق الجغرافية، والمسافة إلى موقع IP وإلى عنوان المستند، ونتائج رصد VPN والبروكسي وTor والمحاكيات، بالإضافة إلى الفحوصات السابقة للشخص.
النتيجة
تُطلق كل نتيجة يتم رصدها تحذيراً يحدد الإجراء المضبوط له (
NO_ACTION أو REVIEW أو DECLINE) حالة الخطوة.
ويعتمد الإجراء الأشد صرامة.مصادر الموقع الجغرافي
يمكنك اختيار مصدر تحديد الموقع عبرgeolocation_position_source.
في العقدة التي تطلب الموقع من الجهاز، تُقيّم أي محاولة بدون موقع على أنها رفض أو فشل فعلي، ولا يحل موقع IP أبداً محل الموقع المفقود.
الإعدادات الافتراضية والحدود
جميع المفاتيح اختيارية. تتوفر القائمة الكاملة في مرجع تكوينات ميزات سير العمل.الإعدادات المسبقة
يحددgeolocation_preset الإجراء الافتراضي لكل إجراء تتركه دون تعيين صريح.
يقوم الإعداد licensing برفض الموقع إذا كان خارج المناطق المسموح بها، أو داخل منطقة محظورة، أو خلف VPN أو Tor، أو على محاكي، ويحيل البروكسي إلى المراجعة.
أما fraud_screening فيطبق نفس الفحوصات ولكنه يحيل كل ما كان سيرفضه licensing إلى المراجعة.
أي إجراء تحدده صراحةً يكون له الأولوية دائماً.
السياج الجغرافي
قم بتفعيلis_geolocation_geofencing_enabled وحدد قائمة geolocation_areas.
يمكن أن تكون المنطقة دولة بأكملها، أو أقاليم تابعة لدولة واحدة (ISO 3166-2)، أو دائرة جغرافية (من 1 إلى 500 كم)، أو مضلعاً (من 3 إلى 200 نقطة).
لا تنجح الخطوة إلا إذا كان الموقع داخل منطقة مسموح بها، ودائماً ما تسود المنطقة المحظورة على المنطقة المسموح بها.
تتسع القائمة لما يصل إلى 50 منطقة، وتتطلب منطقة مسموحاً بها واحدة على الأقل.
تقيّم Didit دائرة الدقة الكاملة للموقع، وليس مجرد نقطة المنتصف:
- الدائرة التي تقع بالكامل خارج كل المناطق المسموح بها تُصنف كـ
LOCATION_OUTSIDE_GEOFENCE. - الدائرة التي تتقاطع مع حد جغرافي يفصل في القرار تُصنف كـ
LOCATION_GEOFENCE_UNDETERMINED، ولا تُعتبر “خارج النطاق” مطلقاً. - الدائرة التي تقع بالكامل داخل منطقة محظورة تُصنف كـ
LOCATION_IN_BLOCKED_AREA، وتصدر بالإضافة إلى نتيجة المنطقة المسموح بها.
ip_only، ويتم تقييمها بناءً على موقع IP.
لا يزال إعداد geolocation_geofencing_by_country القديم يعمل، ولكنه لا يتوافق مع geolocation_areas.
عمليات التحقق من المسافة
يحدد
geolocation_document_distance_basis العنوان: document (مستند الهوية، ثم إثبات العنوان)، أو proof_of_address، أو declared (expected_details.address من إنشاء الجلسة).
مع تفعيل geolocation_travel_tolerance_enabled، لن يُوضَع على الشخص تنبيه إذا شوهد بالقرب من عنوانه خلال آخر geolocation_travel_max_days يوماً بسبب بعده عنه الآن.
لا يعفي التسامح مع السفر أبداً من وجود VPN، أو انتحال الموقع، أو التواجد في منطقة محظورة، أو في موقع خارج المناطق المسموح بها.
إشارات الانتحال والسلامة
- موفرو المواقع الوهمية: يبلّغ نظاما Android وiOS عندما يكون الموقع محاكياً بدلاً من قياسه فعلياً.
- إقرار الجهاز: يمكن لحزم SDK الأصلية إرفاق إقرار الجهاز. يؤدي الإقرار الفاشل دائماً إلى الرفض. ويتم تسجيل الإقرار المفقود ويكون الإجراء الافتراضي هو عدم اتخاذ أي إجراء. لا يمكن للمتصفحات تقديم إقرار ويتم تسجيلها كـ
unsupported، وليس كفشل. - VPN والبروكسي وTor: يتم اكتشافها على الاتصال الذي شارك الموقع. عندما لا يكون الإجراء المحدد لأي منها
NO_ACTION، يُطلب من الشخص إيقاف تشغيله وإعادة المحاولة طالما بقيت محاولات متاحة. - المحاكيات: يتم الإبلاغ عنها بواسطة التطبيقات الأصلية فقط. تنتهي الخطوة بسبب المحاكي في تلك المحاولة نظراً لأن إعادة المحاولة لن تغير الجهاز.
- إعادة استخدام التحدي: يؤدي التحدي المقدم في جلسة أخرى دائماً إلى الرفض.
النتائج
تحتوي المحاولة المقبولة للخطوة علىoutcome واحد:
طالما بقيت محاولات متاحة، فإن العثور على موقع ذي نصف قطر واسع، أو موقع قديم أو تقريبي، أو رفض الموقع، أو نتيجة متعلقة بالمنطقة يطلب من الشخص المحاولة مرة أخرى، وفقط المحاولة الأخيرة هي التي تثير تحذيرات.
أما الموقع الوهمي، أو المحاكي الذي يتخذ سير العمل إجراءً بشأنه، فيُنهي الخطوة في المحاولة التي أبلغت عنه.
تجربة المستخدم
الموافقة والإذن
لا تتم قراءة أي شيء قبل أن يقبل الشخص الإشعار ويستجيب لمطالبة النظام. يوضح الإشعار أنه تتم قراءة الموقع مرة واحدة فقط لعملية التحقق هذه، وأنه ليس سجلاً لتحركاته. يتم التعامل مع الشخص الذي يرفض وفقاً لـgeolocation_refusal_path:
retry_then_handoffيطلب المحاولة مرة أخرى طالما بقيت محاولات متاحة ثم يعرض المتابعة على هاتف محمول.continue_without_locationيعرض المتابعة بدون موقع، ويسجل الرفض كالنتيجة.end_sessionيُنهي الخطوة والجلسة عند أول رفض. يتطلب أن يكونgeolocation_permission_denied_actionمضبوطاً علىREVIEWأوDECLINE، ولا يتم قبول الجلسة أبداً.
geolocation_allow_skip، يمكن للشخص المتابعة بدون موقع في أي وقت، ويتم تقييم الخطوة بواسطة geolocation_unavailable_action.
المتصفح
يطلب المسار المستضاف الموقع من المتصفح ويعرض مساعدة خطوة بخطوة لمتصفحي Chrome وSafari عندما يكون الموقع الجغرافي معطلاً للموقع الإلكتروني. لا يمكن للمتصفح التمييز بين منح إذن دقيق ومنح إذن تقريبي، لذا لا تؤدي نتائج الويب أبداً إلى إثارةLOCATION_APPROXIMATE_ONLY، ولا يُبلّغ المتصفح أبداً عن موفر موقع وهمي أو محاكٍ أو إقرار الجهاز.
لا يمكن لجهاز الكمبيوتر مشاركة موقع دقيق، لذا يقدم المسار رمز QR يتيح متابعة عملية التحقق نفسها على هاتف الشخص (geolocation_allow_qr_handoff، مفعل افتراضياً)، وينتقل الكمبيوتر للمتابعة تلقائياً بمجرد انتهاء الهاتف.
عند تضمين المسار في iframe، قم بتضمين geolocation في السمة allow، راجع iframe في السياق.
تُعامل الصفحة التي تحظر سياسة إذن تحديد الموقع الجغرافي على أنها قرار من الموقع، وليس رفضاً من الشخص.
حزم SDK الأصلية
تطلب حزم SDK لنظامي iOS وAndroid الإذن من نظام التشغيل ويمكنها إرفاق إقرار الجهاز وعلامات الموقع الوهمي. في نظام iOS، أضفNSLocationWhenInUseUsageDescription إلى Info.plist، وفي نظام Android تعلن حزمة SDK عن ACCESS_FINE_LOCATION وACCESS_COARSE_LOCATION وتطلب الإذن أثناء وقت التشغيل فقط عندما يتضمن سير العمل هذه الخطوة.
راجع حزم SDK الأصلية.
يؤدي منح إذن تقريبي على iOS أو Android إلى إثارة LOCATION_APPROXIMATE_ONLY ما لم يكن geolocation_accuracy_mode مضبوطاً على approximate_allowed.
تُنهى الخطوة بالحالة unsupported_client عند استخدام إصدار من التطبيق أو حزمة SDK أقدم من هذه الخطوة، بدلاً من ترك الجلسة معلقة.
ما يعيده القرار
يتضمن قرار الجلسة وwebhook الخاص بـstatus.updated قائمتين:
geolocation_checks[]: عنصر واحد لكل خطوة Location، ويحتوي على المحاولة المقبولة لتلك الخطوة، معwarningsالخاصة بها.geolocation_attempts[]: كل محاولة لكل خطوة Location، بدءاً من الأقدم.
geolocation_checks التي يعيدها قرارك.
الأسعار
تبلغ تكلفة التحقق من الموقع $0.05 لكل فحص، وهو ليس جزءاً من المستوى المجاني. تفرض Didit الرسوم مرة واحدة لكل خطوة Location في الجلسة، أياً كانت نتيجتها، نظراً لتشغيل الفحص وإرجاع نتيجة. تكون عمليات إعادة المحاولة ضمن الخطوة نفسها مجانية. تُفرض الرسوم مجدداً على كل عملية إعادة إرسال تُكمل الخطوة مرة أخرى.البيئة التجريبية
تُشغّل جلسات البيئة التجريبية الخطوة نفسها في التدفق المستضاف نفسه، ولا يزال الجهاز أو المتصفح يبلغ عن موقع حقيقي. لا تصل جلسات البيئة التجريبية إطلاقاً إلى خدمة البحث عن عنوان IP، لذا فإن مقارنة عنوان IP تستخدم فقط ما تحتفظ به الجلسة بالفعل. يتم تسجيل الاستخدام بسعر 0، لذلك لا يتم فرض أي رسوم على جلسة البيئة التجريبية إطلاقاً. لا توجد مدخلات سحرية لهذه الخطوة.مواضيع ذات صلة
- تقرير التحقق من الموقع - كل حقل في
geolocation_checks[]وgeolocation_attempts[]. - تحذيرات التحقق من الموقع - كل رمز
LOCATION_*والإجراء الخاص به. - تكوينات ميزات سير العمل - كل مفتاح
geolocation_*. - تحليل الجهاز وعنوان IP - التحديد الجغرافي لعنوان IP وفحوصات VPN للجلسة.