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 फ़िंगरप्रिंट होता है. फ़िंगरप्रिंट, कोलन से अलग किए गए दो अंकों वाले हेक्साडेसिमल नंबर का क्रम होता है.

ध्यान दें: अपने कीस्टोर और पासकोड को सुरक्षित रखने के लिए, कमांड लाइन पर 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. Fitness API चालू करने के लिए, जारी रखें पर क्लिक करें.
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