लोकेशन सत्यापन API: जियोफ़ेंसिंग और IP दूरी

Didit का स्थान सत्यापन चरण पुष्टि करता है कि कोई व्यक्ति सत्यापन के दौरान कहाँ उपस्थित है। यह डिवाइस की स्थिति (ब्राउज़र या नेटिव SDK) को एक बार पढ़कर या कनेक्शन के IP स्थान को पढ़कर किया जाता है, और इसे अनुमत व ब्लॉक किए गए क्षेत्रों, IP स्थान तथा उनके दस्तावेज़ों पर मौजूद पते के विरुद्ध जाँचा जाता है। वर्कफ़्लो और API में यह GEOLOCATION सुविधा है, इसकी सेटिंग्स geolocation_* कुंजियाँ हैं, और इसका परिणाम सत्र निर्णय पर geolocation_checks[] होता है।

​

इसका उपयोग कब करें

• आपके पास केवल कुछ क्षेत्राधिकारों (जुआ, ब्रोकरेज, लेंडिंग) के लिए लाइसेंस है और आपको यह साबित करना होगा कि आवेदन करते समय व्यक्ति उनमें से किसी एक के भीतर उपस्थित था।
• आपको लोगों को ब्लॉक किए गए स्थानों से बाहर रखना है, जैसे कि कोई प्रतिबंध वाला क्षेत्र या ऐसा राज्य जहाँ आप सेवा नहीं देते हैं।
• आप एक अतिरिक्त धोखाधड़ी संकेत चाहते हैं: IP स्थान या ID पर दिए गए पते से बहुत दूर डिवाइस की स्थिति, नकली स्थिति, VPN या एमुलेटर।
• आपको व्यक्ति की गतिविधियों या इतिहास की आवश्यकता नहीं है, केवल सत्र के दौरान ली गई एक रीडिंग की आवश्यकता है।

​

यह कैसे काम करता है

​

स्थिति के स्रोत

आप geolocation_position_source के साथ चुनते हैं कि स्थिति कहाँ से प्राप्त की जाए। जिस नोड पर डिवाइस से अनुरोध किया जाता है, वहाँ जिस प्रयास में स्थिति उपलब्ध नहीं होती, उसे अस्वीकृति या विफलता के रूप में आँका जाता है: IP स्थान कभी भी इसके विकल्प के रूप में उपयोग नहीं होता है।

​

कॉन्फ़िगरेशन डिफ़ॉल्ट और सीमाएँ

सभी कुंजियाँ वैकल्पिक हैं। पूरी सूची वर्कफ़्लो सुविधा कॉन्फ़िग संदर्भ में है।

​

प्रीसेट

geolocation_preset उन सभी कार्रवाइयों के लिए डिफ़ॉल्ट सेट करता है जिन्हें आप सेट किए बिना छोड़ देते हैं। licensing अनुमत क्षेत्रों के बाहर, किसी ब्लॉक किए गए क्षेत्र के अंदर, VPN या Tor के पीछे, या किसी एमुलेटर पर स्थिति को अस्वीकृत करता है, और प्रॉक्सी की समीक्षा करता है। fraud_screening समान निष्कर्षों को लागू करता है लेकिन उन सभी मामलों को समीक्षा के लिए भेजता है जिन्हें licensing अस्वीकृत करता। आपके द्वारा स्पष्ट रूप से सेट की गई कार्रवाई हमेशा प्राथमिकता लेती है।

​

जियोफ़ेंसिंग

is_geolocation_geofencing_enabled को चालू करें और geolocation_areas को सूचीबद्ध करें। एक क्षेत्र पूरा देश, किसी देश के क्षेत्र (ISO 3166-2), एक वृत्त (1 से 500 km) या एक बहुभुज (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 में एम्बेड करते हैं, तो allow विशेषता में geolocation शामिल करें, इन-कॉन्टेक्स्ट iframe देखें। जियोलोकेशन अनुमति नीति को ब्लॉक करने वाले पेज को साइट का निर्णय माना जाता है, न कि व्यक्ति की अस्वीकृति।

​

नेटिव SDK

iOS और Android SDK ऑपरेटिंग सिस्टम से अनुरोध करते हैं और डिवाइस अटेस्टेशन तथा मॉक-लोकेशन फ़्लैग जोड़ सकते हैं। iOS पर Info.plist में NSLocationWhenInUseUsageDescription जोड़ें, और Android पर SDK ACCESS_FINE_LOCATION और ACCESS_COARSE_LOCATION घोषित करता है और केवल तभी रनटाइम पर पूछता है जब किसी वर्कफ़्लो में यह चरण होता है। नेटिव SDK देखें। iOS या Android पर अनुमानित अनुमति LOCATION_APPROXIMATE_ONLY उत्पन्न करती है जब तक geolocation_accuracy_mode को approximate_allowed पर सेट न किया गया हो। जिसका ऐप या SDK बिल्ड इस चरण से पहले का है, उसे सत्र को अटकाए रखने के बजाय unsupported_client के साथ बंद कर दिया जाता है।

​

निर्णय क्या लौटाता है

सत्र निर्णय और status.updated webhook में दो सूचियाँ होती हैं:

• 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 जाँच।