डेस्कटॉप क्लाइंट को अपने खाते के साथ युग्मित करना

अवलोकन

Whisperer macOS क्लाइंट आपके सत्रों, सब्सक्रिप्शन और ज्ञान-आधार के साथ काम करे, इसके लिए आपको इसे एक बार अपने खाते के साथ युग्मित (pair) करना होता है। केवल ऐप इंस्टॉल कर लेने से एक्सेस नहीं मिलता — डिवाइस को अधिकृत किया जाना आवश्यक है (device auth)।

युग्मन एक सुरक्षित वन-टाइम-कोड प्रवाह पर आधारित है: ऐप साइन-इन शुरू करता है, आप ब्राउज़र में प्रमाणीकरण करते हैं, एक वन-टाइम कोड प्राप्त करते हैं, और ब्राउज़र आपको वापस ऐप पर ले आता है। यह कोड एक बार उपयोग के लिए होता है और 30 मिनट तक जीवित रहता है।

कब उपयोग करें

क्लाइंट इंस्टॉल करने और अनुमतियों के विज़ार्ड से गुज़रने के तुरंत बाद।
किसी नए या पुनः इंस्टॉल किए गए कंप्यूटर पर साइन इन करते समय।
जब ऐप आपका खाता देखना बंद कर दे (आपने सभी डिवाइसों से साइन आउट किया, पासवर्ड बदला, इत्यादि) और इसे फिर से युग्मित करने की ज़रूरत हो।

चरण-दर-चरण

ऐप में साइन-इन शुरू करें। अपने Mac पर Whisperer खोलें और साइन-इन/युग्मन शुरू करें। ऐप सर्वर से एक वन-टाइम कोड माँगता है (POST /v1/auth/desktop/code) और आपके ब्राउज़र में युग्मन वेब-पेज खोलता है — /app/connect।
ब्राउज़र में अपने खाते में साइन इन करें। /app/connect पेज पर अपने ई-मेल और पासवर्ड से साइन इन करें। यदि आपके पास अभी तक खाता नहीं है — रजिस्टर करें और अपना ई-मेल पुष्टि करें (देखें पंजीकरण और साइन-इन)। ई-मेल पुष्टि होने तक साइन-इन संभव नहीं है।
डिवाइस युग्मन की पुष्टि करें। साइन-इन के बाद वेब डैशबोर्ड वन-टाइम कोड को आपके खाते से जोड़ देता है।
ऐप पर लौटें। ब्राउज़र whisperer://auth?code=...&state=... स्कीम के ज़रिए आपको स्वतः वापस Whisperer पर रीडायरेक्ट कर देता है। यदि कोई सिस्टम संकेत "Whisperer में खोलें?" दिखे — उसकी पुष्टि करें।
कोड-से-टोकन विनिमय की प्रतीक्षा करें। ऐप वन-टाइम कोड को एक्सेस टोकन के बदले विनिमयित करता है और उन्हें सुरक्षित स्टोरेज (एन्क्रिप्टेड) में संग्रहीत करता है। इसके बाद क्लाइंट आपके खाते के साथ युग्मित हो जाता है।
सत्यापित करें। सुनिश्चित करें कि ऐप आपका खाता और प्लान दिखा रहा है। अब आप सत्र शुरू कर सकते हैं।

स्क्रीनशॉट

📸 [स्क्रीनशॉट: macOS क्लाइंट में साइन-इन शुरू करने की स्क्रीन]

📸 [स्क्रीनशॉट: साइन-इन फ़ॉर्म के साथ /app/connect वेब-पेज]

📸 [स्क्रीनशॉट: macOS सिस्टम संकेत "Whisperer में खोलें?" (whisperer:// स्कीम)]

सामान्य गलतियाँ

कोड समाप्त हो गया। वन-टाइम कोड 30 मिनट तक जीवित रहता है। यदि आपको अधिक समय लगा या बीच में बाधा आई, तो युग्मन पूरा नहीं होगा। समाधान: ऐप पर लौटें और साइन-इन फिर से शुरू करें — एक नया कोड जारी हो जाएगा।
ब्राउज़र ऐप पर वापस नहीं लौटा। यदि whisperer:// स्कीम रीडायरेक्ट स्वतः नहीं चला, तो सुनिश्चित करें कि Whisperer "Applications" फ़ोल्डर में इंस्टॉल है और साइन-इन दोहराएँ। जब ऐप खोलने का सिस्टम संकेत दिखे — उसकी पुष्टि करें।
साइन-इन विफल — ई-मेल पुष्टि नहीं हुआ। जब तक आपका ई-मेल 6-अंकीय कोड से पुष्टि नहीं हो जाता, तब तक आप साइन इन नहीं कर सकते। अपना ई-मेल पुष्टि करें और फिर से प्रयास करें।
कई /app/connect टैब। एक साथ कई युग्मन पेज खोलने से प्रवाह टूट जाता है। अतिरिक्त टैब बंद करें और ऐप से युग्मन फिर से चलाएँ।
खाता फ्रीज़ या प्रतिबंधित। यदि खाते की स्थिति frozen/banned है, तो युग्मन पूरा नहीं होगा — सहायता से संपर्क करें।

सर्वोत्तम अभ्यास

इंस्टॉलेशन के तुरंत बाद, बिना देरी के, युग्मन चलाएँ — इस तरह आप आराम से कोड की 30-मिनट की TTL के भीतर रहेंगे।
/app/connect पेज को केवल एक ही टैब में खुला रखें।
यदि आपने अपना पासवर्ड बदला या सभी डिवाइसों से साइन आउट किया, तो क्लाइंट को फिर से युग्मित करें — पुराने टोकन अमान्य कर दिए जाते हैं (token_version)।
वन-टाइम कोड को मैन्युअल रूप से न दें और whisperer://auth?... लिंक साझा न करें — यह आपके डिवाइस के लिए एक गुप्त (secret) है।