OAuth 2.0 क्लाइंट आईडी पाना

खास जानकारी

Android के लिए Google Fit का इस्तेमाल करने के लिए, आपके पास Android ऐप्लिकेशन के लिए OAuth 2.0 क्लाइंट आईडी होना चाहिए.

सभी Android ऐप्लिकेशन, डिजिटल सर्टिफ़िकेट से साइन किए जाते हैं. इसके लिए, आपके पास निजी पासकोड होता है. डिजिटल सर्टिफ़िकेट के बारे में ज़्यादा जानकारी के लिए, ऐप्लिकेशन साइन करने के लिए Android गाइड देखें.

Android OAuth क्लाइंट आईडी, खास सर्टिफ़िकेट/पैकेज पेयर से लिंक होते हैं. आपको हर सर्टिफ़िकेट के लिए सिर्फ़ एक आईडी की ज़रूरत होती है. इससे कोई फ़र्क़ नहीं पड़ता कि आपके ऐप्लिकेशन के लिए कितने उपयोगकर्ता हैं.

अपने ऐप्लिकेशन के लिए आईडी पाने के लिए, आपको कई चरणों को पूरा करना होगा. इन चरणों के बारे में नीचे बताया गया है.

1. अपने ऐप्लिकेशन के सर्टिफ़िकेट की जानकारी ढूंढें.
2. Google API Console में कोई प्रोजेक्ट बनाएं या उसमें बदलाव करें.
3. OAuth 2.0 क्लाइंट आईडी का अनुरोध करें.

अपने ऐप्लिकेशन के सर्टिफ़िकेट की जानकारी देखना

एपीआई पासकोड, आपके ऐप्लिकेशन के डिजिटल सर्टिफ़िकेट के छोटे फ़ॉर्म पर आधारित होता है. इसे SHA-1 फ़िंगरप्रिंट कहा जाता है. अपने सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट दिखाने के लिए, पहले यह पक्का करें कि सही सर्टिफ़िकेट का इस्तेमाल किया जा रहा है. आपके पास दो सर्टिफ़िकेट हो सकते हैं:

• डीबग सर्टिफ़िकेट: Android SDK के टूल, डीबग के लिए बिल्ड करने पर यह सर्टिफ़िकेट अपने-आप जनरेट करते हैं. इस सर्टिफ़िकेट का इस्तेमाल सिर्फ़ उन ऐप्लिकेशन के साथ करें जिनकी जांच की जा रही है. ऐसे ऐप्लिकेशन को पब्लिश करने की कोशिश न करें जिस पर हस्ताक्षर करने के लिए डीबग सर्टिफ़िकेट का इस्तेमाल किया गया हो. Android डेवलपर के दस्तावेज़ में, डीबग मोड में साइन इन करना सेक्शन में डीबग सर्टिफ़िकेट के बारे में ज़्यादा जानकारी दी गई है.
• रिलीज़ सर्टिफ़िकेट: Android SDK के टूल, रिलीज़ के लिए तैयार बिल्ड बनाने पर यह सर्टिफ़िकेट जनरेट करते हैं. keytool प्रोग्राम का इस्तेमाल करके भी यह सर्टिफ़िकेट जनरेट किया जा सकता है. इस सर्टिफ़िकेट का इस्तेमाल तब करें, जब आप अपने ऐप्लिकेशन को दुनिया भर में रिलीज़ करने के लिए तैयार हों.

-v पैरामीटर के साथ keytool प्रोग्राम का इस्तेमाल करके, सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट दिखाने के लिए, यह तरीका अपनाएं. Keytool के बारे में ज़्यादा जानकारी के लिए, Oracle का दस्तावेज़ देखें.

डीबग सर्टिफ़िकेट

डीबग सर्टिफ़िकेट फ़िंगरप्रिंट दिखाना

1. अपनी डीबग कीस्टोर फ़ाइल ढूंढें. फ़ाइल का नाम debug.keystore है. यह फ़ाइल, पहली बार प्रोजेक्ट बनाने पर बनती है. डिफ़ॉल्ट रूप से, यह उसी डायरेक्ट्री में सेव होता है जिसमें आपकी Android वर्चुअल डिवाइस (एवीडी) फ़ाइलें सेव होती हैं:

   • macOS और Linux: ~/.android/
   • Windows Vista और Windows 7: C:\Users\your_user_name\.android\

2. SHA-1 फ़िंगरप्रिंट की सूची बनाएं:

   • Linux या macOS के लिए, टर्मिनल विंडो खोलें और यह डालें:

     keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

   • Windows Vista और Windows 7 के लिए, यह चलाएं:

     keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

आपको इससे मिलता-जुलता आउटपुट दिखेगा:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

सर्टिफ़िकेट जारी करना

रिलीज़ सर्टिफ़िकेट फ़िंगरप्रिंट दिखाना

1. रिलीज़ सर्टिफ़िकेट की कीस्टोर फ़ाइल ढूंढें. रिलीज़ कीस्टोर के लिए, कोई डिफ़ॉल्ट जगह या नाम नहीं होता. अगर आपने रिलीज़ के लिए ऐप्लिकेशन बनाते समय कोई सर्टिफ़िकेट नहीं चुना, तो बिल्ड आपके .apk को बिना हस्ताक्षर के छोड़ देगा. साथ ही, आपको इसे पब्लिश करने से पहले हस्ताक्षर करना होगा. रिलीज़ सर्टिफ़िकेट के लिए, आपको सर्टिफ़िकेट का दूसरा नाम और कीस्टोर और सर्टिफ़िकेट के पासवर्ड की भी ज़रूरत होगी. कीस्टोर में मौजूद सभी कुंजियों के लिए, उपनामों की सूची बनाई जा सकती है. इसके लिए, यह डालें:

   keytool -list -keystore your_keystore_name

   your_keystore_name को कीस्टोर के पूरी तरह से क्वालिफ़ाइड पाथ और नाम से बदलें. इसमें .keystore एक्सटेंशन भी शामिल करें. आपको कीस्टोर का पासवर्ड डालने के लिए कहा जाएगा. इसके बाद, keytool कीस्टोर में मौजूद सभी उपनाम दिखाता है.

2. टर्मिनल या कमांड प्रॉम्प्ट में यह डालें:

   keytool -list -v -keystore your_keystore_name -alias your_alias_name

   your_keystore_name को कीस्टोर के पूरी तरह से क्वालिफ़ाइड पाथ और नाम से बदलें. इसमें .keystore एक्सटेंशन भी शामिल करें. your_alias_name को उस उपनाम से बदलें जो आपने सर्टिफ़िकेट बनाते समय उसे असाइन किया था.

आपको इससे मिलता-जुलता आउटपुट दिखेगा:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 से शुरू होने वाली लाइन में, सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट होता है. फ़िंगरप्रिंट, कोलन से अलग किए गए दो अंकों वाले 20 हेक्साडेसिमल नंबर का क्रम होता है.

चेतावनी: अपने कीस्टोर और कुंजी को सुरक्षित रखने के लिए, कमांड लाइन पर storepass या keypass आर्ग्युमेंट तब तक न डालें, जब तक आपको अपने कंप्यूटर की सुरक्षा पर पूरा भरोसा न हो. उदाहरण के लिए, किसी सार्वजनिक कंप्यूटर पर कोई व्यक्ति आपकी टर्मिनल विंडो का इतिहास या चल रही प्रोसेस की सूची देख सकता है. साथ ही, पासवर्ड हासिल करके आपके साइनिंग सर्टिफ़िकेट में बदलाव करने का ऐक्सेस पा सकता है. इससे वह व्यक्ति आपके ऐप्लिकेशन में बदलाव कर सकता है या उसे अपने ऐप्लिकेशन से बदल सकता है.

Google API Console में OAuth 2.0 क्लाइंट आईडी का अनुरोध करना

Google API Console में अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या उसमें बदलाव करने, Fitness API को चालू करने, और OAuth 2.0 क्लाइंट आईडी का अनुरोध करने के लिए, यह तरीका अपनाएं.

अगर आपको इस प्रोसेस के बारे में निर्देश चाहिए और Fitness API को अपने-आप चालू करना है, तो

क्लाइंट आईडी पाना

इसके अलावा, Google API Console में Fitness API को चालू करने और OAuth 2.0 क्लाइंट आईडी पाने के लिए, यह तरीका अपनाएं.

1. Google API Console पर जाएं.
2. कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. अपने ऐप्लिकेशन के Android और REST वर्शन के लिए, एक ही प्रोजेक्ट का इस्तेमाल करें.
3. फ़िटनेस एपीआई को चालू करने के लिए, जारी रखें पर क्लिक करें.
4. क्रेडेंशियल पर जाएं पर क्लिक करें.
5. नए क्रेडेंशियल पर क्लिक करें. इसके बाद, OAuth क्लाइंट आईडी चुनें.
6. ऐप्लिकेशन टाइप में जाकर, Android चुनें.

7. इसके बाद दिखने वाले डायलॉग बॉक्स में, अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट और पैकेज का नाम डालें. उदाहरण के लिए:

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

   com.example.android.fit-example

8. बनाएं पर क्लिक करें. आपका नया Android OAuth 2.0 क्लाइंट आईडी और सीक्रेट, आपके प्रोजेक्ट के आईडी की सूची में दिखता है. OAuth 2.0 क्लाइंट आईडी, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह दिखती है:

   780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com