acurl और get_token के बारे में जानकारी

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

Apigee, OAuth2 ऐक्सेस जनरेट करने और उसे पास करने के लिए, नीचे दी गई सुविधाएं देता है और रीफ़्रेश टोकन. Edge API में अपनी पहचान की पुष्टि करने के लिए, इन टोकन का इस्तेमाल किया जा सकता है OAuth के साथ कॉल (इनमें शामिल हैं) SAML और एलडीएपी वर्कफ़्लो):

  • acurl(1): यह स्टैंडर्ड सुविधा के चारों ओर एक सुविधा रैपर देता है curl निर्देश. Edge पर एचटीटीपी अनुरोध बनाता है एपीआई, get_token से टोकन ऐक्सेस और रीफ़्रेश करता है. साथ ही, Edge एपीआई.
  • get_token(1): यह ऐक्सेस के लिए, आपके Apigee क्रेडेंशियल को शेयर करता है साथ ही, उन टोकन को रीफ़्रेश करें जिनका इस्तेमाल Edge API को कॉल करने के लिए किया जा सकता है.

ये दोनों सुविधाएं, आपके Apigee खाते के क्रेडेंशियल (उपयोगकर्ता नाम और पासवर्ड या पासवर्ड) का इस्तेमाल करती हैं OAuth2 टोकन.

Apigee यूटिलिटी के बनाए गए टोकन OAuth 2.0 ऑथराइज़ेशन फ़्रेमवर्क खास जानकारी.

टोकन पाने या Edge API के लिए ऑथेंटिकेशन सर्वर ऐक्सेस करने के लिए, Apigee यूटिलिटी का इस्तेमाल करना ज़रूरी नहीं है. OAuth2 ऐक्सेस टोकन जनरेट करने और उन्हें अपने अनुरोधों में Edge पर भेजने के लिए, अपनी स्कीम लागू की जा सकती है एपीआई.

acurl और get_token इंस्टॉल करें

Apigee, एक ऐसी ZIP फ़ाइल उपलब्ध कराता है जिसमें acurl(1), get_token(1), और इंस्टॉल स्क्रिप्ट.

acurl और get_token इंस्टॉल करने के लिए:

  1. अपनी मशीन पर इंस्टॉल डायरेक्ट्री बनाएं या डिफ़ॉल्ट usr/local/bin डायरेक्ट्री का इस्तेमाल करें.
  2. Apigee से इंस्टॉल की गई ZIP फ़ाइल डाउनलोड करें: 
    curl https://login.apigee.com/resources/scripts/sso-cli/ssocli-bundle.zip -O
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  3. डाउनलोड की गई फ़ाइल को अनज़िप करें.
  4. इंस्टॉल स्क्रिप्ट निष्पादित करें: 
    sudo ./install -b /usr/local/bin
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

    -b विकल्प, एक्ज़ीक्यूटेबल फ़ाइलों की जगह के बारे में बताता है. अगर आपको यह विकल्प तय करने पर, इंस्टॉल स्क्रिप्ट /usr/local/bin में सुविधाएं इंस्टॉल करती है.

  5. इंस्टॉलेशन की जांच करें: 
        acurl -h
    get_token -h
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

    अगर इंस्टॉल हो जाता है, तो ये निर्देश काम की सुविधाओं के लिए सहायता टेक्स्ट दिखाते हैं.

टोकन खत्म होने की तारीख

acurl और get_token इन अवधि वाले टोकन जनरेट करते हैं:

  • ऐक्सेस टोकन की समयसीमा 12 घंटे में खत्म हो जाती है.
  • रीफ़्रेश टोकन की समयसीमा 30 दिन में खत्म हो जाती है.

इस वजह से, acurl या get_token के साथ एपीआई कॉल करने के बाद, टोकन पेयर का इस्तेमाल 30 दिनों तक किया जा सकता है. समयसीमा खत्म होने के बाद, आपको इसे फिर से डालना होगा क्रेडेंशियल और नए टोकन पाएं.

एसएसओ एंडपॉइंट सेट करना

पहली बार कॉल करने से पहले, आपको Edge API के लिए ऑथराइज़ेशन सर्वर एंडपॉइंट सेट करना होगा को acurl और get_token के साथ इस्तेमाल करना है.

टर्मिनल से, SSO_LOGIN_URL एनवायरमेंट वैरिएबल को अपने अनुमति पर सेट करें सर्वर एंडपॉइंट. उदाहरण के लिए:

  • ज़ोन का इस्तेमाल नहीं करने वाले Cloud ग्राहकों के लिए: 
    export SSO_LOGIN_URL=https://login.apigee.com
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • ज़ोन वाले Cloud ग्राहकों के लिए: 
    export SSO_LOGIN_URL=https://zone_name.login.apigee.com
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • Private Cloud के ग्राहकों के लिए, सही एसएसओ एंडपॉइंट पाने के लिए, अपने एडमिन से संपर्क करें.

एक बार इस्तेमाल होने वाले पासवर्ड का इस्तेमाल करें (एसएमएल के लिए ज़रूरी)

acurl या get_token का इस्तेमाल करके एपीआई कॉल करने पर, आपको अपनी पहचान की पुष्टि करनी होगी खुद को टोकन पेयर पाने के लिए यूटिलिटी का इस्तेमाल करें. इसके लिए, Apigee पास करना होगा खाते का उपयोगकर्ता नाम, पासवर्ड, और MFA कोड. हालांकि, अगर एसएएमएल आईडीपी का इस्तेमाल किया जा रहा है या आपको पासवर्ड का इस्तेमाल करने के लिए, आपको एक बार इस्तेमाल होने वाला कोड पासवर्ड मिल सकता है.

एक बार इस्तेमाल होने वाला पासवर्ड पाने के लिए:

  1. ब्राउज़र में यह यूआरएल डालें:
    • ज़ोन का इस्तेमाल नहीं करने वाले Cloud ग्राहकों के लिए: 
      https://login.apigee.com/passcode
      अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    • ज़ोन वाले Cloud ग्राहकों के लिए: 
      https://zone_name.login.apigee.com/passcode
      अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    • Private Cloud के ग्राहकों के लिए, सही एसएसओ एंडपॉइंट पाने के लिए, अपने एडमिन से संपर्क करें.
  2. अपने Apigee खाते में लॉग इन करें.
  3. छह वर्णों का पासवर्ड कॉपी करें.
  4. -p विकल्प के साथ acurl या get_token का इस्तेमाल करें और पासकोड डालें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है: 
    get_token -p 1a2b3c

अपने टोकन देखें

acurl या get_token लागू करने पर, उपयोगिताएं ~/.sso-cli में एक डेटा फ़ाइल बनाएं, जिसमें टोकन और अन्य मेटाडेटा शामिल हों.

टोकन देखने के लिए, इस तरह के निर्देश का इस्तेमाल किया जा सकता है:

get_token -v

यह निर्देश डिकोड किए गए टोकन के दावे दिखाता है, उदाहरण के लिए:

Decoded token claims:
 {
  "jti": "8018507e-9f34-4a90-bf97-ff226a06b19b",
  "sub": "858217a9-01a1-4111-8525-75ca555f5d5c",
  "scope": [
    "scim.emails.read",
    "scim.me",
    "openid",
    "password.write",
    "approvals.me",
    "scim.ids.read",
    "oauth.approvals"
          ],
  "client_id": "edgecli",
  "cid": "edgecli",
  "azp": "edgecli",
  "grant_type": "password",
  "user_id": "858217a9-01a1-4111-8525-75ca555f5d5c",
  "origin": "usergrid",
  "user_name": "myusername@google.com",
  "email": "myusername@google.com",
  "auth_time": 1597444772,
  "al": 0,
  "rev_sig": "6271c527",
  "iat": 1597444772,
  "exp": 1597487972,
  "iss": "https://login.apigee.com",
  "zid": "uaa",
  "aud": [
    "edgecli",
    "scim.emails",
    "scim",
    "openid",
    "password",
    "approvals",
    "scim.ids",
    "oauth"
        ]
    }
Current timestamp: 1597444983
Existing access token is still valid

(1) कॉपीराइट 2023 Google LLC
acurl और get_token टूल, "सॉफ़्टवेयर" के तौर पर उपलब्ध कराए गए हैं के अंतर्गत Google Cloud Platform के आपके इस्तेमाल को कंट्रोल करने वाला कानूनी समझौता. इसमें सेवा भी शामिल है खास शर्तें https://cloud.google.com/terms/service-terms पर उपलब्ध हैं.