iOS को टारगेट करने वाले ARCore एक्सटेंशन के लिए, Cloud anchors डेवलपर गाइड

टोकन (JWT पर हस्ताक्षर) की अनुमति

1 और 365 दिनों के बीच TTL (टीटीएल) वाले क्लाउड ऐंकर को होस्ट और ठीक करने के लिए, टोकन वाले हस्ताक्षर (JWT) का इस्तेमाल करें. फ़िलहाल, हस्ताक्षर किया हुआ सिर्फ़ इस तरह का टोकन JSON वेब टोकन (JWT) है. यह टोकन किसी Google सेवा खाते से हस्ताक्षर किया जाना चाहिए.

1. बदलाव करें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > ARCore एक्सटेंशन पर जाएं और iOS सहायता चालू है को चुनें.

   

2. iOS की पुष्टि करने की रणनीति वाले ड्रॉप-डाउन मेन्यू से, पुष्टि करने वाले टोकन का विकल्प चुनें.

   

सर्वर एंडपॉइंट के लिए ज़रूरी शर्तें

iOS के लिए टोकन जनरेट करने के लिए, आपके पास अपने सर्वर पर ऐसा एंडपॉइंट होना चाहिए जो नीचे दी गई ज़रूरी शर्तों को पूरा करता हो:

1. अनुमति देने का आपका तरीका, एंडपॉइंट की सुरक्षा करता है.
2. हर बार एंडपॉइंट को एक नया टोकन जनरेट करना होगा, ताकि हर उपयोगकर्ता को एक खास टोकन मिले. साथ ही, टोकन की समयसीमा भी कभी खत्म नहीं होती.

सेवा खाता और साइनिंग कुंजी बनाना

Google सेवा खाता और साइनिंग कुंजी बनाने के लिए यह तरीका अपनाएं.

1. Google Cloud Platform Console के नेविगेशन मेन्यू में, एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.
2. अपनी पसंद के प्रोजेक्ट चुनें और क्रेडेंशियल बनाएं > सेवा खाता पर क्लिक करें.
3. सेवा खाते की जानकारी में, नए खाते का नाम लिखें और बनाएं पर क्लिक करें.
4. सेवा खाते की अनुमतियां पेज पर, भूमिका चुनें ड्रॉप-डाउन मेन्यू पर जाएं. सेवा खाते > सेवा खाता टोकन क्रिएटर चुनें और जारी रखें पर क्लिक करें.
5. उपयोगकर्ताओं को इस सेवा खाते का ऐक्सेस दें पेज पर, हो गया पर क्लिक करें. इससे, आपको वापस एपीआई और सेवाएं > क्रेडेंशियल पर ले जाया जाएगा.
6. क्रेडेंशियल पेज पर, नीचे की ओर स्क्रोल करके, सेवा खाते सेक्शन पर जाएं और अभी-अभी बनाए गए खाते के नाम पर क्लिक करें.
7. सेवा खाते का ब्यौरा पेज पर, नीचे कुंजी सेक्शन तक स्क्रोल करें और कुंजी जोड़ें > नई कुंजी बनाएं चुनें.
8. कुंजी टाइप के तौर पर JSON चुनें और बनाएं पर क्लिक करें. यह JSON फ़ाइल डाउनलोड करता है, जिसमें आपकी मशीन के लिए निजी कुंजी मौजूद होती है. JSON कुंजी फ़ाइल डाउनलोड करने के बाद, उसे किसी सुरक्षित जगह पर सेव करें.

JSON फ़ाइल में एक निजी कुंजी है, जिसे सार्वजनिक नहीं किया जाना चाहिए. इसे GitHub जैसे सोर्स कोड के डेटा स्टोर करने की जगह पर इस्तेमाल न करें.

अपने सर्वर पर टोकन बनाना

अपने सर्वर पर नए टोकन (JWT) बनाने के लिए, JWT की लाइब्रेरी और वह JSON फ़ाइल इस्तेमाल करें जिसे आपने नए सेवा खाते से सुरक्षित तरीके से डाउनलोड किया था.

अपनी डेवलपमेंट मशीन पर टोकन बनाना

अपनी डेवलपमेंट मशीन पर JWT जनरेट करने के लिए, नीचे दिए गए oauth2l निर्देश का इस्तेमाल करें:

// "oauth2l" uses a lowercase L, not a 1, as the last character.
// Specifying an empty cache location using the --cache flag is necessary
// to ensure that a different token is produced each time.
oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"

आपको जो स्ट्रिंग मिल रही है उसमें काट-छांट करना न भूलें. अतिरिक्त स्पेस या न्यूलाइन वर्णों का इस्तेमाल करने पर एपीआई, टोकन को अस्वीकार कर सकता है.

टोकन पर हस्ताक्षर करें

JWT पर हस्ताक्षर करने के लिए, RS256 एल्गोरिदम और इन दावों का इस्तेमाल करें:

• iss — सेवा खाते का ईमेल पता.
• sub — सेवा खाते का ईमेल पता.
• iat — टोकन जनरेट होने के बाद, सेकंड में यूनिक्स का समय.
• exp — iat + 3600 (1 घंटा). टोकन की समयसीमा, सेकंड में खत्म हो जाती है.
• aud — दर्शक. https://arcore.googleapis.com/ सेट होना चाहिए.

JWT पेलोड के लिए गैर-मानक दावों की ज़रूरत नहीं होती है. हालांकि, आपको अपने uid दावे से मिलते-जुलते उपयोगकर्ता की पहचान करने के लिए यह फ़ायदेमंद लग सकता है.

अगर आप अपने JWT को जनरेट करने के लिए किसी अलग तरीके का इस्तेमाल करते हैं, जैसे कि Google की ओर से मैनेज किए जाने वाले एनवायरमेंट में Google API का इस्तेमाल करना, तो इस सेक्शन में मौजूद दावों के साथ अपने JWT पर हस्ताक्षर करना न भूलें. सबसे पहले, पक्का करें कि ऑडियंस सही है.

ARCore सेशन में कोई टोकन पास करें

टोकन मिलने के बाद, उसे ARAnchorManager.SetAuthToken() का इस्तेमाल करके अपने ARCore सेशन में पास करें:

// Designate the token to use when authorizing with the ARCore API
// on the iOS platform. The API should be called each time the application's token is refreshed.
ARAnchorManager.SetAuthToken(string authToken);

सेशन में टोकन पास करने पर इन बातों का ध्यान रखें:

• किसी ऐंकर को होस्ट करने या उसका समाधान करने से पहले, आपको अनुमति वाले किसी मान्य टोकन को पास करना होगा.
• ARCore, अनुमति वाले उन टोकन को अनदेखा कर देता है जिनमें स्पेस या विशेष वर्ण शामिल होते हैं.
• अगर सेशन किसी मान्य एपीआई पासकोड से बनाया गया है, तो ARCore, अनुमति वाले टोकन को अनदेखा कर देता है. अगर आपने पहले एपीआई पासकोड का इस्तेमाल किया था और अब आपको इसकी ज़रूरत नहीं है, तो हमारा सुझाव है कि आप Google Cloud Platform Console में इसे मिटाएं. साथ ही, उपयोगकर्ताओं को नए वर्शन पर माइग्रेट करने के बाद, इसे अपने ऐप्लिकेशन से हटाएं.
• आम तौर पर, टोकन की समयसीमा एक घंटे के बाद खत्म हो जाती है. अगर आपके टोकन का इस्तेमाल करते समय उसकी समयसीमा खत्म हो जाती है, तो नया टोकन पाएं और नए टोकन के साथ ARAnchorManager.SetAuthToken(string authToken) को कॉल करें.

एपीआई कुंजी की अनुमति

24 घंटे (1 दिन) तक के TTL (टीटीएल) को होस्ट करने और उनका समाधान करने के लिए एपीआई कुंजी की अनुमति का इस्तेमाल करें.

ARCore SDK टूल 1.24.0 या इसके बाद के वर्शन के साथ बनाए गए नए Unity प्रोजेक्ट के लिए, अनुमति देने की डिफ़ॉल्ट रणनीति DoNotUse है. इससे, गैर-ज़रूरी लाइब्रेरी का इस्तेमाल करके ऐप्लिकेशन बनने से रोका जा सकता है. अगर आपका ऐप्लिकेशन क्लाउड ऐंकर का इस्तेमाल करता है और उसे ARCore SDK 1.24.0 या उसके बाद के वर्शन का इस्तेमाल करके बनाया गया है, तो आपको प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > ARCore एक्सटेंशन में जाकर, अनुमति पाने की सुविधा मैन्युअल तरीके से चालू करनी होगी.

1. बदलाव करें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > ARCore एक्सटेंशन पर जाएं और iOS सहायता चालू है को चुनें.

   

2. iOS की पुष्टि करने की रणनीति वाले ड्रॉप-डाउन मेन्यू से, एपीआई पासकोड का विकल्प चुनें.

   

3. Google Cloud Console से, इस प्रोजेक्ट के लिए एपीआई पासकोड पाएं.

4. बदलाव करें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > ARCore एक्सटेंशन पर जाएं और अपनी एपीआई कुंजी Cloud ऐंकर API कुंजियां फ़ील्ड में जोड़ें.