एसएएमएल की सुविधा चालू करने के बाद, Edge एडमिन की सुविधाओं और एपीआई का इस्तेमाल करना

Edge for Private Cloud का वर्शन 4.18.05

इस सेक्शन में, एसएएमएल को चालू करने के बाद, Edge सिस्टम एडमिन टूल और कमांड चलाने का तरीका बताया गया है. Edge पर कई टास्क के लिए, सिस्टम एडमिन के क्रेडेंशियल की ज़रूरत होती है. जैसे:

  • संगठन और एनवायरमेंट बनाना
  • Edge के कॉम्पोनेंट जोड़ना और हटाना
  • apigee-adminapi.sh कमांड चलाना

हालांकि, Edge पर एसएएमएल चालू करने के बाद, आम तौर पर बेसिक ऑथेंटिकेशन को बंद कर दिया जाता है. इससे, पुष्टि करने का एकमात्र तरीका एसएएमएल आईडीपी ही रह जाता है. इसलिए, आपको यह पक्का करना होगा कि आपने अपने SAML आईडीपी में सिस्टम एडमिन खाता जोड़ा हो.

सिस्टम एडमिन के तौर पर, Edge मैनेजमेंट एपीआई को कॉल करना

कई Edge API कॉल के लिए, आपको सिस्टम एडमिन के क्रेडेंशियल पास करने होंगे. Edge Management API के साथ एसएएमएल का इस्तेमाल करना लेख में, Edge Management API कॉल करते समय टोकन पाने और उन्हें रीफ़्रेश करने के तरीके के बारे में बताया गया है.

एसएएमएल ऑथेंटिकेशन के साथ apigee-adminapi.sh यूटिलिटी का इस्तेमाल करना

Edge मैनेजमेंट एपीआई को कॉल करके किए जाने वाले Edge कॉन्फ़िगरेशन के टास्क, apigee-adminapi.sh यूटिलिटी का इस्तेमाल करके भी किए जा सकते हैं. apigee-adminapi.sh यूटिलिटी का फ़ायदा यह है कि:

  • आसान कमांड-लाइन इंटरफ़ेस का इस्तेमाल करना
  • टैब-आधारित कमांड पूरा करने की सुविधा लागू करता है
  • सहायता और इस्तेमाल के बारे में जानकारी देता है
  • अगर आपको एपीआई को आज़माना है, तो उससे जुड़ा एपीआई कॉल दिखाया जा सकता है

ज़्यादा जानकारी के लिए, apigee-ssoadminapi.sh का इस्तेमाल करना लेख पढ़ें.

एसएएमएल ऑथेंटिकेशन की सुविधा चालू करने के बाद, सिस्टम एडमिन के क्रेडेंशियल को apigee-adminapi.sh यूटिलिटी में पास करने के कई तरीके हैं.

किसी भी apigee-adminapi.sh कमांड के लिए सभी विकल्प देखे जा सकते हैं. इनमें एसएएमएल क्रेडेंशियल तय करने के विकल्प भी शामिल हैं. इसके लिए, कमांड में "-h" विकल्प का इस्तेमाल करें. जैसे:

apigee-adminapi.sh orgs list -h

उदाहरण के लिए, सिस्टम एडमिन के क्रेडेंशियल पास किए जा सकते हैं:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant \
  --admin adminEmail --oauth-password adminPword

कहां:

  • sso-url विकल्प, Edge एसएसओ मॉड्यूल के यूआरएल के बारे में बताता है. अगर आपने पोर्ट या प्रोटोकॉल को 9099 और एचटीटीपी से बदल दिया है, तो उन्हें बदलें.
  • oauth-flow से, passcode या password_grant के बारे में पता चलता है. इस उदाहरण में, password_grant को तय किया गया है.
  • adminEmail, सिस्टम एडमिन का ईमेल पता है.
  • oauth-password, सिस्टम एडमिन का पासवर्ड तय करता है.

इसके अलावा, कमांड को कॉल करते समय पासवर्ड का इस्तेमाल किया जा सकता है:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-passcode passcode

कहां:

  • oauth-flow से passcode के बारे में पता चलता है.
  • oauth-passcode, http://edge_sso_IP_DNS:9099/passcode. से मिले पासवर्ड के बारे में बताता है

आखिर में, कमांड को कॉल करते समय टोकन का इस्तेमाल किया जा सकता है:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-token token

कहां:

  • oauth-flow, passcode या password_grant में से किसी एक को तय करता है. यह इस बात पर निर्भर करता है कि आपको टोकन मूल रूप से कैसे मिला. इस उदाहरण में, passcode की वैल्यू दी गई है, क्योंकि आपको टोकन get_token का इस्तेमाल करके मिला था. Edge मैनेजमेंट एपीआई के साथ एसएएमएल का इस्तेमाल करना देखें.
  • oauh_token में टोकन मौजूद है.

एसएएमएल ऑथेंटिकेशन के साथ Edge की यूटिलिटी का इस्तेमाल करना

Edge की कई सुविधाओं के लिए, सिस्टम एडमिन के क्रेडेंशियल की ज़रूरत होती है. जैसे:

  • apigee-provision का इस्तेमाल संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाने के लिए किया जाता है
  • setup.sh का इस्तेमाल, किसी मौजूदा सिस्टम में नोड जोड़ने के लिए किया जाता है
  • कोई अन्य यूटिलिटी, जहां आपको कॉन्फ़िगरेशन फ़ाइल में सिस्टम एडमिन के क्रेडेंशियल डालने हों

इन यूटिलिटी को इनपुट के तौर पर एक कॉन्फ़िगरेशन फ़ाइल की ज़रूरत होती है. इसमें सिस्टम एडमिन के क्रेडेंशियल की जानकारी होती है. इसके लिए, इन प्रॉपर्टी का इस्तेमाल किया जाता है:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW=adminPWord

अगर आपने पासवर्ड नहीं डाला है, तो आपसे पासवर्ड डालने के लिए कहा जाएगा.

एसएएमएल को चालू करने के बाद, सिस्टम एडमिन के क्रेडेंशियल की जानकारी देने के लिए, अलग-अलग प्रॉपर्टी का इस्तेमाल किया जाता है. उदाहरण के लिए, सिस्टम एडमिन के क्रेडेंशियल पास किए जा सकते हैं:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=password_grant
OAUTH_ADMIN_PASSWORD=adminPWord

कहां:

  • SSO_LOGIN_URL, Edge एसएसओ मॉड्यूल का यूआरएल बताता है. अगर आपने पोर्ट या प्रोटोकॉल को 9099 और एचटीटीपी से बदल दिया है, तो उन्हें बदलें.
  • OAUTH_FLOW से passcode या password_grant के बारे में पता चलता है. इस उदाहरण में, password_grant को चुना गया है, क्योंकि सिस्टम एडमिन का पासवर्ड पास किया जा रहा है.
  • OAUTH_ADMIN_PASSWORD, सिस्टम एडमिन का पासवर्ड तय करता है.

इसके अलावा, पासकोड फ़्लो के हिस्से के तौर पर क्रेडेंशियल की जानकारी देने के लिए, इन प्रॉपर्टी का इस्तेमाल किया जा सकता है:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_ADMIN_PASSCODE=passcode

कहां:

  • OAUTH_FLOW से passcode के बारे में पता चलता है.
  • OAUTH_ADMIN_PASSCODE, http://edge_sso_IP_DNS:9099/passcode. से मिले पासवर्ड के बारे में बताता है

आखिर में, टोकन का इस्तेमाल किया जा सकता है

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_BEARER_TOKEN=token

कहां:

  • OAUTH_FLOW, passcode या password_grant में से किसी एक को तय करता है. यह इस बात पर निर्भर करता है कि आपको टोकन मूल रूप से कैसे मिला. इस उदाहरण में, passcode की वैल्यू दी गई है, क्योंकि आपको टोकन, get_token का इस्तेमाल करके मिला था. Edge मैनेजमेंट एपीआई के साथ एसएएमएल का इस्तेमाल करना देखें.
  • OAUTH_BEARER_TOKEN में टोकन मौजूद है.