सत्यापन सेटिंग्स

Configure पेज का General टैब तय करता है कि आपके वर्कस्पेस में हर सत्यापन कैसे काम करे। यह नियंत्रित करता है कि कोड कितनी देर मान्य रहे, कितने गलत प्रयासों के बाद सत्यापन समाप्त हो, नया कोड कितनी जल्दी भेजा जा सके और कोड किस वेबसाइट से जुड़ा है।

हर फ़ील्ड प्रभावी मान दिखाता है: जहाँ आपने अपना मान सेट किया है वहाँ वही, नहीं तो Bird का प्लेटफ़ॉर्म डिफ़ॉल्ट। फ़ील्ड से बाहर निकलते ही वह सहेज लिया जाता है। Duration, Maximum Retries और Website सत्यापन बनाते समय तय हो जाते हैं, इसलिए इनमें बदलाव नए सत्यापनों पर लागू होता है। Retry Delay में बदलाव अगले create कॉल पर लागू होता है, चाहे सत्यापन पहले से चल रहा हो।

कोई सेटिंग बदलने के लिए write स्तर पर verify_management अनुमति चाहिए, जो admin और developer भूमिकाओं में शामिल है। analyst भूमिका पेज देख सकती है। उपयोगकर्ता, टीमें और भूमिकाएँ देखें।

सत्यापन चक्र

• Duration सत्यापन बनाए जाने के समय से शुरू होती है। दोबारा भेजने या किसी दूसरे चैनल पर जाने से नया कोड भेजा जाता है, लेकिन समाप्ति का मूल समय वही रहता है, इसलिए देर से दोबारा भेजने पर समय-सीमा नहीं बढ़ती। प्रमाणीकरण प्रवाहों के लिए इसे 10 मिनट या उससे कम रखें; इसका कारण सर्वोत्तम अभ्यास में बताया गया है।
• Maximum Retries सत्यापन के लिए भेजे गए हर कोड पर दर्ज गलत कोडों को एक साथ गिनता है, इसलिए दोबारा भेजने से यह गिनती शून्य नहीं होती। अगर गलत कोड वाली जाँच के बाद सत्यापन लंबित रहता है, तो वह जाँच बचे हुए प्रयास attempts_remaining में बताती है।
• Retry Delay तब लागू होता है जब आप उसी प्राप्तकर्ता के लिए फिर से create कॉल करते हैं। प्रतीक्षा अवधि के भीतर यह कॉल नया कोड भेजे बिना चालू सत्यापन लौटाती है। कोड को दूसरे चैनल पर भेजें पर यह लागू नहीं होता, क्योंकि चैनल बदलना उसी चैनल पर दोबारा माँगने से अलग अनुरोध है। हर create कॉल पर नया कोड भेजने के लिए इसे 0 पर सेट करें, जो दुरुपयोग सुरक्षा सीमाएँ में दी गई प्रति-प्राप्तकर्ता सीमाओं के भीतर रहता है।

कोड की लंबाई इस पेज पर सेट नहीं होती। डिफ़ॉल्ट रूप से कोड छह अंकों के होते हैं, और options.code_length किसी एक सत्यापन के लिए 4 से 8 अंक सेट करता है; विकल्प देखें।

ऑटोफ़िल

Website उस साइट का नाम है जहाँ आपके उपयोगकर्ता अपने कोड दर्ज करते हैं, जैसे https://login.example.com। वेबसाइट सेट होने पर ब्राउज़र कोड को केवल उसी साइट पर भरने का सुझाव दे सकते हैं, किसी और साइट पर नहीं। इससे उपयोगकर्ता को कोड कॉपी नहीं करना पड़ता। बिना किसी वेबसाइट के कोड भेजने के लिए इसे खाली छोड़ें।

वेबसाइट को https:// और उसके बाद छोटे अक्षरों वाले डोमेन के रूप में लिखें, बिना पोर्ट, पाथ या अंत में स्लैश के। अंतरराष्ट्रीय डोमेन अपना xn-- रूप इस्तेमाल करता है, उदाहरण के लिए bücher.example के लिए https://xn--bcher-kva.example। कोई भी दूसरा रूप अस्वीकार कर दिया जाता है, और सही रूप उपलब्ध होने पर संदेश में वह रूप बताया जाता है। ठीक वही साइट इस्तेमाल करें जिस पर कोड फ़ील्ड दिखता है: login.example.com पर मौजूद फ़ॉर्म के लिए https://login.example.com चाहिए, https://example.com नहीं।

किसी सत्यापन के साथ वेबसाइट जुड़ जाने पर Verify उसे कोड वाले संदेशों में जोड़ता है:

• SMS: संदेश के अंत में @login.example.com #123456 जैसी एक पंक्ति होती है। अपने कोड इनपुट पर autocomplete="one-time-code" लगाएँ ताकि Safari और दूसरे ब्राउज़र कोड भरने का सुझाव दें। अगर आप चाहते हैं कि ब्राउज़र बिना टैप के कोड भर दे, तो पेज से WebOTP API कॉल करें। यह अतिरिक्त पंक्ति एक और SMS सेगमेंट जोड़ सकती है। यूनिकोड एन्कोडिंग वाली कई भाषाओं, जैसे अरबी, ग्रीक या रूसी, में वेबसाइट से जुड़ा कोड एक की जगह दो सेगमेंट लेता है, जिससे उसका SMS शुल्क दोगुना हो जाता है। लंबा डोमेन दूसरी भाषाओं में भी ऐसा कर सकता है।
• ईमेल: संदेश में कोड और वेबसाइट वाला एक OTP-Token हेडर होता है, जैसा OTP-Token Internet-Draft, revision 01 में परिभाषित है। मेल ऐप अभी इस हेडर को पढ़ना शुरू ही कर रहे हैं, इसलिए इसे संदेश में दिए गए कोड के अतिरिक्त माध्यम के रूप में देखें।

सत्यापन बनाए जाने के समय वेबसाइट तय हो जाती है। दोबारा भेजने, किसी दूसरे चैनल पर फ़ॉलबैक करने या उसी प्राप्तकर्ता के लिए फिर से create कॉल करने पर भी वही वेबसाइट रहती है।

हर अनुरोध के लिए कोड को वेबसाइट से जोड़ें

कोई अनुरोध options.autofill_origin के ज़रिए अपनी वेबसाइट खुद बता सकता है, जो उस सत्यापन के लिए Website की जगह ले लेती है। जब एक वर्कस्पेस कई साइटों के लिए काम करता है, तब इसका उपयोग करें।

जब कोड फ़ील्ड किसी क्रॉस-ऑरिजिन iframe में हो, जैसे किसी दुकान के चेकआउट में एम्बेड किया गया भुगतान फ़ॉर्म, तो options.autofill_origin को iframe की वेबसाइट पर और options.autofill_top_level_origin को ब्राउज़र टैब में खुले पेज पर सेट करें। तब SMS पंक्ति में दोनों साइटों के नाम होते हैं, जैसे @shop.example #123456 @pay.example, और इससे किसी भी भाषा में एक सेगमेंट बढ़ सकता है। Chrome उस फ़ॉर्म को तब ऑटोफ़िल करता है, जब पेज iframe को सीधे एम्बेड करता है और उसे allow="otp-credentials" देता है। इन सत्यापनों के लिए ईमेल में OTP-Token हेडर नहीं भेजा जाता, क्योंकि यह हेडर केवल एक वेबसाइट का नाम दे सकता है। अनुरोध 422 के साथ अस्वीकार हो जाता है, जब टॉप-लेवल वेबसाइट गलत रूप में हो, जब न अनुरोध में और न इस पेज पर कोई वेबसाइट सेट हो, या जब टॉप-लेवल वेबसाइट उसी वेबसाइट के बराबर हो।

पंजीकृत SMS सेंडर

अगर आप अपने पंजीकृत सेंडर से SMS भेजते हैं, जैसे US 10DLC कैंपेन, तो वेबसाइट सेट करने से पहले कैंपेन में एक ऐसा नमूना संदेश जोड़ें जो बाउंड पंक्ति पर खत्म होता हो। कैरियर ऐसे संदेश को फ़िल्टर कर सकते हैं जो कैंपेन के पंजीकृत नमूनों से अलग हो।

समस्या निवारण

• वेबसाइट अस्वीकार हो जाती है। मान आवश्यक रूप में नहीं है। संदेश में सुझाया गया रूप दर्ज करें, जैसे https://Example.com/ के लिए https://example.com।
• ब्राउज़र कोड नहीं सुझाता। जाँचें कि वेबसाइट किसी भी सबडोमेन सहित पेज के पते से बिल्कुल मेल खाती है, और कोड इनपुट में autocomplete="one-time-code" है। iframe के लिए जाँचें कि अनुरोध दोनों वेबसाइटें सेट करता है और एम्बेड करने वाला पेज allow="otp-credentials" देता है। ऑटोफ़िल ब्राउज़र पर भी निर्भर करता है: Chrome SMS पंक्ति को WebOTP के ज़रिए पढ़ता है और Safari अपने कोड ऑटोफ़िल के ज़रिए, जबकि Firefox WebOTP का समर्थन नहीं करता (ब्राउज़र समर्थन)।
• उपयोगकर्ता के दर्ज करने से पहले कोड की समय-सीमा खत्म हो गई। Duration बढ़ाने से पहले Verify लॉग में प्रयास का समय देखें। आम तौर पर इसका कारण धीमा डिलीवरी मार्ग होता है, और लंबी समय-सीमा कोड को कमज़ोर बनाती है।

अगले कदम

• सत्यापन भेजना: प्रति-अनुरोध विकल्पों सहित सत्यापन बनाएँ और जाँचें।
• गंतव्य: हर गंतव्य देश के लिए चैनल और उनका क्रम चुनें।
• सेंडर और ब्रांडिंग: Verify द्वारा भेजे जाने वाले संदेश देखें और हर चैनल के लिए सेंडर चुनें।