प्राधिकरण: ApiKey, Credentials या OAuth 2.0

GeoPard समाधान उपयोग कर रहा है AWS Cognito प्रमाणीकरण प्रक्रिया के लिए।

हम सभी प्राधिकरण विकल्पों की जाँच करने की सलाह देते हैं। विकल्प की पसंद विशिष्ट उपयोग के मामले पर निर्भर करती है। अधिक उपयोग निर्देश नीचे हर विकल्प में वर्णित हैं।

विकल्प 1: क्रेडेंशियल्स का उपयोग

“username” और “password” के साथ प्राधिकरण संभावित तरीकों में से एक है। इस स्थिति में, ईमेल पंजीकरण किया जाना चाहिए (सोशल नेटवर्क का उपयोग नहीं)।

यह तरीका API (बैकएंड) स्तर पर एकीकरण के लिए सुझाया जाता है और GeoPard API के सभी अनुरोध एक समर्पित विशेष सेवा (माइक्रोसेवा) के माध्यम से प्रॉक्सी किए जाते हैं।

लॉगिन अनुरोध

curl --location --request POST 'https://api.geopard.tech/login' \
--header 'Content-Type: application/json' \
--header 'Content-Type: text/plain' \
--data-raw '{"username":"<email_address>","password":"<password>"}'

लॉगिन प्रतिक्रिया

टोकन एक JWT है जिसकी अवधि 30 मिनट है। सर्वोत्तम अभ्यास यह है कि एक ही टोकन को स्टोर करके सभी अनुरोधों में पुन: उपयोग किया जाए, इसके एक्सपायरी समय की जाँच की जाए और यह समाप्त होने पर (या थोड़ा पहले) नया टोकन प्राप्त किया जाए।

{
    "token": "<token_to_use_in_geopard_api>"
}

विकल्प 2: OAuth 2.0

AWS Cognito प्राधिकरण के लिए OAuth 2.0 प्रोटोकॉल का समर्थन करता है। सामान्य अवलोकन लेख में वर्णित है Cognito OAuth2 मैन्युअलइस उप-लेख में Authorization Code Grant GeoPard के मामले में सबसे अधिक रोचक है।

यह तरीका GeoPard को उपयोगकर्ता इंटरफेस (फ्रंटएंड) स्तर पर एकीकृत करने की सलाह दी जाती है। एकीकरण दोनों दिशाओं में काम करता है ताकि GeoPard को/से डेटा भेजा/प्राप्त किया जा सके।

संक्षेप में:

1. आपके एप्लिकेशन को लॉगिन या पंजीकरण के लिए उपयोगकर्ता को GeoPard Cognito पर रीडायरेक्ट करना होगा।

उदाहरण:

curl --location --request GET '
https://auth.geopard.tech/oauth2/authorize?response_type=code&client_id=<connect_geopard_team>&redirect_uri=http://localhost:8080&state=54321
'

कृपया, अपना एप्लिकेशन व्यक्तिगत प्राप्त करने के लिए GeoPard टीम से संपर्क करें client_id.

1. रीडायरेक्ट किए गए URL को एक सत्यापन प्राप्त होगा code अगले चरण के लिए।

रीडायरेक्ट किया गया URL इस प्रकार दिखता है http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a&state=54321.

1. आपके एप्लिकेशन को विनिमय करना होगा code के लिए tokens (access_token, refresh_token, id_token).

उदाहरण:

curl --location --request POST '
https://auth.geopard.tech/oauth2/token
' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: XSRF-TOKEN=365e14e1-3c66-477e-b0ef-a9e436a834ee; csrf-state=""; csrf-state-legacy=""' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a' \
--data-urlencode 'client_id=42ajne9u466in6gaf569nth9o9' \
--data-urlencode 'redirect_uri=
http://localhost:8080
'

विकल्प 3: API कुंजी

WMS और WFS तक त्वरित पहुँच समय-समय पर आवश्यक होती है। इसलिए, हर खाते के लिए स्वचालित रूप से उत्पन्न GeoPard API कुंजी का उपयोग करना संभव है।

API कुंजी को निम्न में पाया जा सकता है apiKey "UserData" GraphQL एंटिटी के attribute में। पुनः प्राप्त करने के निर्देश apiKey प्रदान किए गए हैं यहाँ.

apiKey का उपयोग किया जाना चाहिए साथ में /geo एंडपॉइंट्स के साथ केवल।

उपयोग:

1. एक के रूप में geopardApiKey GET अनुरोध URL में पैरामीटर।

2. एक के रूप में X-API-Key किसी भी अनुरोध में हेडर।