अलग-अलग नाप या आकार वाले डिवाइसों पर पुष्टि करना

क्रेडेंशियल मैनेजर की मदद से, पूरे Android इकोसिस्टम में पुष्टि करने की प्रोसेस को आसान बनाया जा सकता है. इससे उपयोगकर्ताओं को एक जैसा अनुभव मिलता है. साथ ही, डेवलपर को एक ऐसा एपीआई मिलता है जिसकी मदद से वे पासकी, पासवर्ड, और फ़ेडरेटेड साइन-इन के तरीके इस्तेमाल कर सकते हैं. जैसे, Google से साइन इन करें. हालांकि, डिवाइस के साइज़, डाइमेंशन या कॉन्फ़िगरेशन के हिसाब से, कोर प्रोग्रामिंग इंटरफ़ेस एक जैसा रहता है. हर डिवाइस के साइज़, डाइमेंशन या कॉन्फ़िगरेशन के लिए, यूज़र इंटरफ़ेस (यूआई) और उपयोगकर्ता अनुभव (यूएक्स) से जुड़ी ज़रूरी बातें अलग-अलग होती हैं. इसे सही तरीके से लागू करने के लिए, आपको अपने ऐप्लिकेशन के पुष्टि करने के फ़्लो को हर डिवाइस के इनपुट के खास तरीकों, स्क्रीन साइज़, और उपयोगकर्ता के हिसाब से ढालना होगा.

इस गाइड में, अलग-अलग Android डिवाइसों पर Credential Manager को लागू करने के तरीके के बारे में खास जानकारी दी गई है. इसमें, ध्यान देने वाली मुख्य बातों को हाइलाइट किया गया है. साथ ही, ज़्यादा जानकारी वाले दस्तावेज़ों के लिंक दिए गए हैं.

मोबाइल डिवाइस

Android डेवलपमेंट के लिए, मोबाइल डिवाइस सबसे आम टारगेट होते हैं. इनमें फ़ोन, टैबलेट, और फ़ोल्ड किए जा सकने वाले डिवाइस शामिल हैं. Credential Manager का स्टैंडर्ड वर्शन, इन डिवाइसों के लिए सबसे सही है. इनमें आम तौर पर, टचस्क्रीन और उपयोगकर्ता के डिवाइस पर कीबोर्ड होते हैं. इस डिवाइस के साइज़, डाइमेंशन या कॉन्फ़िगरेशन पर उपयोगकर्ता अनुभव, बेसलाइन के तौर पर काम करता है. इसके आधार पर, अन्य डिवाइसों के लिए उपयोगकर्ता अनुभव को अडैप्ट किया जाता है. पुष्टि करने की प्रोसेस, डिवाइस के फ़ॉर्म फ़ैक्टर के हिसाब से होनी चाहिए. साथ ही, इसमें डिवाइस की स्क्रीन और इनपुट के तरीकों की पूरी क्षमताओं का इस्तेमाल किया जाना चाहिए.

Wear OS

Wear OS डिवाइसों की स्क्रीन छोटी होती है और इनमें उपयोगकर्ता के डिवाइस पर इनपुट देने के लिए सीमित विकल्प होते हैं. Credential Manager में पासकी की सुविधा लागू होने से, लोगों को ऐप्लिकेशन में साइन इन करने के लिए एक सुरक्षित प्लैटफ़ॉर्म मिलता है. इसके लिए, उन्हें कनेक्ट किया गया कोई फ़ोन इस्तेमाल करने या पासवर्ड याद रखने की ज़रूरत नहीं होती.

Wear OS के लिए एपीआई, मोबाइल के लिए एपीआई जैसा ही है. इसलिए, मौजूदा मोबाइल इंटिग्रेशन को फिर से इस्तेमाल किया जा सकता है. Credential Manager की मदद से पासकी, Google से साइन इन करने की सुविधा, और पासवर्ड इस्तेमाल करने के अलावा, पुष्टि करने के अन्य तरीके भी इस्तेमाल किए जा सकते हैं. जैसे, डेटा लेयर टोकन शेयर करना, OAuth या आपके मौजूदा समाधान. इनका इस्तेमाल, Credential Manager पर उपयोगकर्ताओं को ट्रांसफ़र करते समय बैकअप के तौर पर किया जा सकता है. इसके अलावा, डेटा लेयर टोकन शेयर करने के मामले में, इनका इस्तेमाल लंबे समय तक किया जा सकता है.

Wear OS के लिए Credential Manager का इस्तेमाल करने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:

• कम से कम एपीआई लेवल: minSdkVersion 33 या इसके बाद का वर्शन
  • इसमें पासवर्ड, पासकी, और 'Google से साइन इन करें' सुविधा के लिए सहायता शामिल है
• GMS वर्शन: मोबाइल ऐप्लिकेशन के लिए ज़रूरी वर्शन

Wear OS डिवाइसों पर यूज़र इंटरफ़ेस इस तरह दिखता है:

इसे लागू करने और कोड सैंपल के बारे में पूरी जानकारी पाने के लिए, यहां दिए गए रिसॉर्स देखें:

• पहने जाने वाले डिवाइसों पर पुष्टि करना: Credential Manager
• Wear OS के लिए यूज़र इंटरफ़ेस (यूआई) डिज़ाइन करने से जुड़े सुझाव
• Wear Credential Manager का सैंपल

सीमाएं

Wear OS पर Credential Manager का इस्तेमाल करने से जुड़ी ये सीमाएं हैं:

• इस पर पासकी नहीं बनाई जा सकतीं.
• क्रेडेंशियल वापस पाने की सुविधा के बारे में जानकारी के साथ काम नहीं करता.

Android XR

Android XR (इसमें वर्चुअल और ऑगमेंटेड रिएलिटी शामिल है) की मदद से, ऐप्लिकेशन 3D स्पेस में रेंडर होते हैं. उपयोगकर्ता का इनपुट, अन्य डिवाइसों के साइज़, डाइमेंशन या कॉन्फ़िगरेशन से काफ़ी अलग होता है. यह हाथ के जेस्चर जैसे नैचुरल इनपुट पर निर्भर करता है.

Credential Manager को एक्सआर के लिए अडैप्ट करने का मतलब है कि 3D स्पेस के लिए, पुष्टि करने वाले यूज़र इंटरफ़ेस (यूआई) को फिर से डिज़ाइन करना. इसमें पासकी, पासवर्ड या फ़ेडरेटेड साइन-इन के तरीके शामिल हैं. उदाहरण के लिए, पुष्टि करने के लिए प्रॉम्प्ट, फ़्लोटिंग पैनल में दिखते हैं. साथ ही, उपयोगकर्ता हाथ के जेस्चर का इस्तेमाल करके विकल्प चुनते हैं. आपको अपने टारगेट एक्सआर डिवाइसों के लिए, हार्डवेयर या सॉफ़्टवेयर से जुड़ी ज़रूरी शर्तों का भी ध्यान रखना होगा.

डिजाइन से जुड़ी एक अहम चुनौती, वीआर या एआर एनवायरमेंट में सहज और सुरक्षित पुष्टि करने की सुविधा उपलब्ध कराना है. आपको यह भी ध्यान रखना होगा कि डिवाइस के एक से ज़्यादा उपयोगकर्ताओं वाले एक्सआर डिवाइसों पर, पहचान को कैसे मैनेज किया जाए. ऐसा इसलिए, क्योंकि अलग-अलग लोग एक ही डिवाइस का इस्तेमाल कर सकते हैं.

Android XR के लिए Credential Manager का इस्तेमाल करने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:

• कम से कम एपीआई लेवल: minSdkVersion 34 या इसके बाद का वर्शन
• GMS वर्शन: वही जो मोबाइल ऐप्लिकेशन के लिए ज़रूरी है
• एम्युलेटर:
  • एम्युलेटर सिस्टम इमेज का कम से कम वर्शन:
    • macOS: Google Play XR ARM 64 v8a सिस्टम इमेज का सातवां वर्शन
    • Windows: Google Play XR Intel x86_64 Atom System Image Revision 7
  • एम्युलेटर के 35.6.11 स्टेबल वर्शन से ज़्यादा वाले वर्शन

एक्सआर पर साइन इन करने का अनुभव कुछ ऐसा दिख सकता है:

एक्सआर के साथ काम न करने वाले फ़्लो

Android XR में Credential Manager, पुष्टि करने की ऐसी प्रोसेस के साथ काम नहीं करता है जिसमें क्यूआर कोड स्कैन करने के लिए किसी दूसरे डिवाइस की ज़रूरत होती है. एक्सआर हेडसेट पर साइन-इन करने की प्रोसेस के दौरान और एम्युलेटर की मदद से टेस्ट करने पर, यह समस्या देखी जा सकती है.

एक्सआर के बारे में ज़्यादा जानने के लिए, Android XR देखें.

Android TV

Android TV डिवाइसों को आम तौर पर, एक से ज़्यादा लोग इस्तेमाल करते हैं. इन्हें दूर से देखा जाता है और डी-पैड रिमोट का इस्तेमाल करके नेविगेट किया जाता है. इस प्लैटफ़ॉर्म पर, उपयोगकर्ताओं के लिए उपयोगकर्ता नाम और पासवर्ड डालना मुश्किल हो सकता है. Credential Manager की मदद से, Android TV पर पुष्टि करना आसान हो जाता है. यह 'Google से साइन इन करें' सुविधा, सेव किए गए पासवर्ड, और अलग-अलग डिवाइसों पर इस्तेमाल की जा सकने वाली पासकी के साथ काम करता है. शेयर किए गए टीवी पर अक्सर एक से ज़्यादा Google प्रोफ़ाइलें मौजूद होती हैं. इसलिए, क्रेडेंशियल मैनेजर इस सेटिंग के हिसाब से काम करता है. यह डिवाइस पर उपलब्ध सभी क्रेडेंशियल को फ़ेच करके दिखाता है. यह सिर्फ़ चालू खाते के क्रेडेंशियल नहीं दिखाता.

इस कम्यूनल नेचर से यह भी तय होता है कि पासकी को कैसे मैनेज किया जाए. टेलीविज़न में निजी लॉक स्क्रीन नॉलेज फ़ैक्टर (एलएसकेएफ़) नहीं होता. इसलिए, पासकी को सीधे तौर पर टीवी पर सेव या नहीं बनाया जाता है. इसके बजाय, पासकी से पुष्टि करने के लिए, क्रॉस-डिवाइस हाइब्रिड फ़्लो का इस्तेमाल किया जाता है. इसमें टीवी पर एक क्यूआर कोड दिखता है. उपयोगकर्ता अपने फ़ोन या टैबलेट से इसे स्कैन करके, बायोमेट्रिक ऑथेंटिकेशन की प्रोसेस पूरी करता है.

अगर आपने isAutoSelectAllowed = true सेट किया है, तो Google TV पर बिना क्लिक किए पेमेंट किया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब एक ही क्रेडेंशियल उपलब्ध हो. नेटिव टीवी की बॉटम शीट अब भी दिखेगी. इसमें उपयोगकर्ता के खाते की पुष्टि की जानकारी दिखेगी. अगर उपयोगकर्ता क्रेडेंशियल को रद्द नहीं करता है, तो क्रेडेंशियल अपने-आप वापस आ जाता है. इसके लिए, रिमोट क्लिक की ज़रूरत नहीं होती. अगर एक से ज़्यादा क्रेडेंशियल मैच होते हैं, तो यह अपने-आप क्रेडेंशियल नहीं चुनेगा. इसके बजाय, उपयोगकर्ता को क्रेडेंशियल चुनने के लिए कहा जाएगा.

अगर आपके मोबाइल और टीवी ऐप्लिकेशन के लिए, Android पैकेज का नाम और साइनिंग पासकोड एक ही है, तो Google Password Manager उन्हें एक ही ऐप्लिकेशन के तौर पर पहचानता है. इस वजह से, मोबाइल डिवाइस पर सेव किया गया पासवर्ड सीधे टीवी पर इस्तेमाल किया जा सकता है. इसके लिए, डिजिटल ऐसेट लिंक (asset_statements) कॉन्फ़िगरेशन की ज़रूरत नहीं होती. डिजिटल ऐसेट लिंक की ज़रूरत सिर्फ़ तब होती है, जब क्रेडेंशियल को अलग-अलग प्लैटफ़ॉर्म पर शेयर किया जाता है. जैसे, किसी ऐप्लिकेशन और वेबसाइट के बीच या अलग-अलग पैकेज के नाम वाले ऐप्लिकेशन के बीच.

Android TV के लिए Credential Manager का इस्तेमाल करने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:

• कम से कम एपीआई लेवल: Android 14 (एपीआई लेवल 34, minSdkVersion 34) या इसके बाद का वर्शन
• GMS वर्शन: 2026W30 या इसके बाद का वर्शन
• पासकी के लिए हार्डवेयर: क्यूआर कोड को स्कैन करने और FIDO हाइब्रिड फ़्लो को पूरा करने के लिए, कैमरे और ब्लूटूथ की सुविधा वाला कोई दूसरा फ़ोन या टैबलेट ज़रूरी है

सीमाएं

Android TV एक ऐसा डिवाइस है जिसे कई लोग इस्तेमाल करते हैं. इसलिए, इस प्लैटफ़ॉर्म पर Credential Manager का इस्तेमाल करने पर, उपयोगकर्ता की निजता और सुरक्षा को बनाए रखने के लिए, ये पाबंदियां लागू होती हैं:

• टीवी पर पासकी नहीं बनाई जा सकती और न ही सेव की जा सकती हैं: पासकी को सीधे टीवी पर न तो बनाया जा सकता है और न ही सेव किया जा सकता है. लोकल क्रेडेंशियल इस्तेमाल नहीं किए जा सकते. इसलिए, अपने अनुरोधों में preferImmediatelyAvailableCredentials को true पर सेट न करें. ऐसा करने से, क्रॉस-डिवाइस पासकी फ़िल्टर हो जाती हैं और क्रेडेंशियल नहीं मिल पाते.
• क्रेडेंशियल सेव करने की सुविधा देने वाले तीसरे पक्ष के ऐप्लिकेशन उपलब्ध नहीं हैं: Android TV पर, फ़ॉर्म से जुड़ी जानकारी अपने-आप भरने की सुविधा काम नहीं करती. इसलिए, इस प्लैटफ़ॉर्म पर तीसरे पक्ष के Password Manager उपलब्ध नहीं हैं. उपयोगकर्ताओं को Google Password Manager का इस्तेमाल करना होगा.
• क्रेडेंशियल वापस पाने की सुविधा उपलब्ध नहीं है: Android TV पर, क्रेडेंशियल वापस पाने की सुविधा का इस्तेमाल करके, नए डिवाइसों पर अपने-आप साइन इन होने की सुविधा उपलब्ध नहीं है.

टीवी के लिए ऐप्लिकेशन डेवलप करने के बारे में ज़्यादा जानने के लिए, Android TV की खास जानकारी देखें.

Android Automotive OS

Android Automotive OS (AAOS) डिवाइस, वाहनों में इंटिग्रेट किए गए कम्यूनल सिस्टम होते हैं. AAOS के लिए Credential Manager को अडैप्ट करने के लिए, सुरक्षित तरीके से पुष्टि करने की सुविधा (आम तौर पर, जब वाहन पार्क किया गया हो) और शेयर किए गए डिवाइस पर कई उपयोगकर्ता प्रोफ़ाइलों को मैनेज करने की सुविधा ज़रूरी है.

अगर आपने बड़ी स्क्रीन या टैबलेट के लिए ऑप्टिमाइज़ किए गए ऐप्लिकेशन को कारों के लिए उपलब्ध कराया है और आपका ऐप्लिकेशन पहले से ही फ़ोन या टैबलेट पर Credential Manager और पासकी के साथ काम करता है, तो यह Android Automotive OS पर भी काम करेगा. इसके लिए, आपको पुष्टि करने की प्रोसेस में बदलाव करने की ज़रूरत नहीं पड़ेगी.

Android Automotive OS पर पुष्टि करने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है:

• पासकी (क्रॉस-डिवाइस हाइब्रिड फ़्लो): उपयोगकर्ता, क्रॉस-डिवाइस फ़्लो के ज़रिए मौजूदा पासकी से पुष्टि कर सकते हैं. सिस्टम, कार की स्क्रीन पर एक क्यूआर कोड दिखाता है. उपयोगकर्ता इसे अपने फ़ोन या टैबलेट से स्कैन करता है. बायोमेट्रिक और स्क्रीन लॉक की पुष्टि, उपयोगकर्ता के फ़ोन पर होती है. इसलिए, उपयोगकर्ताओं को कार के डिसप्ले पर स्क्रीन लॉक कॉन्फ़िगर करने की ज़रूरत नहीं होती.
• Google से साइन इन करें: इससे कार के डिसप्ले पर, सीधे तौर पर 'Google से साइन इन करें' स्क्रीन दिखती है.
• सेव किए गए पासवर्ड: उपयोगकर्ता, Google Password Manager से सेव किए गए पासवर्ड वापस पा सकते हैं. इससे वे वाहन की स्क्रीन पर क्रेडेंशियल मैन्युअल तरीके से डाले बिना साइन इन कर सकते हैं.

Android Automotive OS, हर प्रोफ़ाइल के लिए सेशन और क्रेडेंशियल मैनेज करता है. साथ ही, प्रोफ़ाइलों के बीच उपयोगकर्ता के हिसाब से सेशन डेटा को अलग करता है. उदाहरण के लिए, प्रोफ़ाइल A, प्रोफ़ाइल B या मेहमान के तौर पर इस्तेमाल की जाने वाली प्रोफ़ाइल.

Android Automotive OS के लिए Credential Manager का इस्तेमाल करने के लिए, ये ज़रूरी शर्तें पूरी होनी चाहिए:

• कम से कम एपीआई लेवल: Android 9 (एपीआई लेवल 28, minSdkVersion 28) या इसके बाद का वर्शन. दूसरे डिवाइस पर पासकी वापस पाने के लिए, Android 14 (एपीआई लेवल 34) या इसके बाद के वर्शन की ज़रूरत होती है.
• GMS का वर्शन: वही वर्शन जो मोबाइल ऐप्लिकेशन के लिए ज़रूरी है.

जांच से जुड़ी सीमाएं

पासकी की जांच करने के लिए, Android Automotive OS बिल्ड वाले फ़िज़िकल डिवाइस की ज़रूरत होती है. सेटअप करने के निर्देश पाने के लिए, Pixel Tablet पर Android Automotive OS का इस्तेमाल करके टेस्ट करना लेख पढ़ें. पासकी की जांच करने के लिए, एम्युलेटर का इस्तेमाल नहीं किया जा सकता. इसकी वजह यह है कि वे ब्लूटूथ लो एनर्जी (बीएलई) के साथ काम नहीं करते. यह FIDO हाइब्रिड फ़्लो के लिए ज़रूरी है.

सीमाएं और इस्तेमाल न किए जा सकने वाले फ़्लो

Android Automotive OS पर Credential Manager का इस्तेमाल करने से जुड़ी ये सीमाएं हैं:

• पासकी को लोकल स्टोरेज में सेव या वहां से वापस नहीं लाया जा सकता: पासकी को सीधे तौर पर लोकल स्टोरेज से वापस लाने की सुविधा काम नहीं करती, क्योंकि वाहन कम्यूनल डिवाइस होते हैं. पासकी को सीधे तौर पर गाड़ी से सिंक करने पर सुरक्षा से जुड़ा जोखिम होता है. इसलिए, पासकी का इस्तेमाल क्रॉस-डिवाइस हाइब्रिड फ़्लो के ज़रिए किया जाना चाहिए.
• तुरंत उपलब्ध क्रेडेंशियल इस्तेमाल नहीं किए जा सकते: अगर आपका ऐप्लिकेशन पासकी का अनुरोध करता है और preferImmediatelyAvailableCredentials को true पर सेट करता है, तो Automotive का यूज़र इंटरफ़ेस (यूआई) तुरंत बंद हो जाता है और NoCredentialException दिखाता है. इस स्थिति के लिए, सही फ़ॉलबैक यूएक्स उपलब्ध कराएं.
• क्रेडेंशियल सेव करने की सुविधा देने वाली तीसरे पक्ष की कोई कंपनी नहीं है: Android Automotive OS पर, तीसरे पक्ष के पासवर्ड मैनेजर काम नहीं करते. उपयोगकर्ताओं को पुष्टि करने के लिए, Google Password Manager या क्रॉस-डिवाइस हाइब्रिड फ़्लो का इस्तेमाल करना होगा.
• सेव किया गया कोई नया पासवर्ड नहीं बनाया जा सकता: एपीआई, कार के इंटरफ़ेस से सीधे तौर पर नया पासवर्ड बनाने और उसे सेव करने की सुविधा नहीं देता. FIDO हाइब्रिड फ़्लो का इस्तेमाल करके, नई पासकी बनाई जा सकती हैं.

Automotive OS के डेवलपमेंट के बारे में ज़्यादा जानने के लिए, Android Automotive OS की खास जानकारी देखें.

अन्य संसाधन

• Credential Manager के बारे में जानकारी
• क्रेडेंशियल वापस पाने की सुविधा के बारे में जानकारी
• Android TV के बारे में खास जानकारी
• Android Automotive OS के बारे में खास जानकारी