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

Edge for Private Cloud v4.18.01

इस सेक्शन में, एसएएमएल को चालू करने के बाद, 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, पासकोड या 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, पासकोड के बारे में बताता है.
  • 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, पासकोड या password_grant में से किसी एक को तय करता है. यह इस बात पर निर्भर करता है कि आपको टोकन मूल रूप से कैसे मिला. इस उदाहरण में, passcode को तय किया गया है, क्योंकि आपको टोकन मूल रूप से get_token का इस्तेमाल करके मिला था. Edge मैनेजमेंट एपीआई के साथ एसएएमएल का इस्तेमाल करना देखें.
  • OAUTH_BEARER_TOKEN में टोकन होता है.