apigee-ssoadminapi.sh का इस्तेमाल करें

Apigee SSO मॉड्यूल में दो तरह के खाते इस्तेमाल किए जा सकते हैं:

• एडमिन
• मशीन यूज़र (सिर्फ़ उन संगठनों के लिए जिनमें बाहरी IDP की सुविधा चालू है)

apigee-ssoadminapi.sh यूटिलिटी की मदद से, Apigee एसएसओ मॉड्यूल से जुड़े एडमिन और मशीन उपयोगकर्ता खातों को मैनेज किया जा सकता है.

apigee-ssoadminapi.sh यूटिलिटी का इस्तेमाल करके:

• एडमिन/मशीन उपयोगकर्ताओं की सूची देखना
• एडमिन/मशीन उपयोगकर्ताओं को जोड़ना या मिटाना
• एडमिन/मशीन उपयोगकर्ताओं का पासवर्ड बदलना

एडमिन उपयोगकर्ताओं के बारे में जानकारी

Apigee एसएसओ मॉड्यूल की प्रॉपर्टी मैनेज करने के लिए, आपके पास इस मॉड्यूल का एडमिन खाता होना चाहिए.

डिफ़ॉल्ट रूप से, Apigee SSO मॉड्यूल इंस्टॉल करने पर, यह इन क्रेडेंशियल के साथ एक एडमिन खाता बनाता है:

• username: इसे Apigee एसएसओ मॉड्यूल को कॉन्फ़िगर करने के लिए इस्तेमाल की जाने वाली कॉन्फ़िगरेशन फ़ाइल में, SSO_ADMIN_NAME प्रॉपर्टी से तय किया जाता है. डिफ़ॉल्ट रूप से, यह ssoadmin. पर सेट होता है
• password: इसे Apigee एसएसओ मॉड्यूल को कॉन्फ़िगर करने के लिए इस्तेमाल की जाने वाली कॉन्फ़िगरेशन फ़ाइल में, SSO_ADMIN_SECRET प्रॉपर्टी से तय किया जाता है.

मशीन यूज़र के बारे में जानकारी

मशीन यूज़र, पासकोड डाले बिना OAuth2 टोकन हासिल कर सकता है. इसका मतलब है कि Edge मैनेजमेंट एपीआई का इस्तेमाल करके, OAuth2 टोकन पाने और उन्हें रीफ़्रेश करने की प्रोसेस को पूरी तरह से ऑटोमेट किया जा सकता है.

आम तौर पर, मशीन यूज़र का इस्तेमाल इनके लिए किया जाता है:

• Edge के साथ कम्यूनिकेट करने के लिए, Apigee Developer Services पोर्टल (या सिर्फ़ पोर्टल) को कॉन्फ़िगर करना
• जब डेवलपमेंट एनवायरमेंट, डेवलपमेंट से जुड़े सामान्य कामों के लिए ऑटोमेशन की सुविधा देता है. जैसे, टेस्ट ऑटोमेशन या सीआई/सीडी.

ज़्यादा जानकारी के लिए, तीसरे पक्ष के आईडीपी के लिए टास्क ऑटोमेट करना लेख पढ़ें.

apigee-ssoadminapi.sh इंस्टॉल करना

Edge मैनेजमेंट सर्वर नोड पर apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल करें, जहां आपने Apigee एसएसओ मॉड्यूल इंस्टॉल किया है. आम तौर पर, Apigee SSO मॉड्यूल इंस्टॉल करते समय, apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल की जाती है.

अगर आपने अब तक apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल नहीं की है, तो:

1. मैनेजमेंट सर्वर नोड में लॉग इन करें. उस नोड में पहले से ही apigee-service इंस्टॉल होना चाहिए, जैसा कि Edge apigee-setup सुविधा इंस्टॉल करना में बताया गया है.
2. Apigee एसएसओ मॉड्यूल के लिए, एडमिन और मशीन के उपयोगकर्ताओं को मैनेज करने के लिए इस्तेमाल की जाने वाली apigee-ssoadminapi.sh यूटिलिटी को इंस्टॉल करें. इसके लिए, यह कमांड चलाएं:

   /opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install

3. शेल से लॉग आउट करें. इसके बाद, अपने पाथ में apigee-ssoadminapi.sh यूटिलिटी को जोड़ने के लिए, फिर से लॉग इन करें.

apigee-ssoadminapi.sh के लिए सहायता जानकारी देखना

यूटिलिटी के लिए ये कमांड उपलब्ध हैं:

• admin add
• admin delete
• admin list
• admin setpassword
• saml machineuser add (एलडीएपी और एसएएमएल के साथ-साथ सभी आईडीपी के लिए, saml कमांड का इस्तेमाल करें)
• saml machineuser delete
• aaml machineuser list
• saml machineuser setpassword

इन निर्देशों के बारे में जानकारी, /opt/apigee/apigee-ssoadminapi/README.md फ़ाइल में देखी जा सकती है. इसके अलावा, इस्तेमाल के बारे में जानकारी देखने के लिए, हर निर्देश के लिए "-h" विकल्प को चुना जा सकता है.

उदाहरण के लिए, यह कमांड:

apigee-ssoadminapi.sh admin list -h

वापसी:

admin list
  --admin SSOADMIN_CLIENT_NAME      Name of the client having administrative privilege on sso
  --secret SSOADMIN_CLIENT_SECRET   Secret/Password for the client
  --host SSO_HOST                   Hostname of SSO server to connect
  --port SSO_PORT                   Port to use during request
  --ssl SSO_URI_SCHEME              Set to https, defaults to http
  --debug                           Set in debug mode, turns on verbose in curl
  -h                                Displays Help

apigee-ssoadminapi.sh यूटिलिटी को शुरू करें

apigee-ssoadminapi.sh यूटिलिटी को शुरू करने के लिए, सभी प्रॉपर्टी को कमांड लाइन आर्ग्युमेंट के तौर पर पास करें. इसके अलावा, इंटरैक्टिव मोड में प्रॉम्प्ट का जवाब देकर भी ऐसा किया जा सकता है.

उदाहरण के लिए, एडमिन उपयोगकर्ताओं की सूची देखने के लिए, कमांड लाइन पर सभी ज़रूरी जानकारी देने के लिए:

apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184

वापसी:

[
  {
    "client_id": "ssoadmin",
    "access_token_validity": 300
  }
]

अगर आपने कोई ज़रूरी जानकारी नहीं दी है, जैसे कि एडमिन पासवर्ड, तो आपको इसकी सूचना दी जाएगी.

इस उदाहरण में, --port और --ssl की वैल्यू को शामिल नहीं किया गया है. इसकी वजह यह है कि Apigee SSO मॉड्यूल, --port के लिए 9099 और --ssl के लिए http की डिफ़ॉल्ट वैल्यू का इस्तेमाल करता है. अगर आपके इंस्टॉलेशन में इन डिफ़ॉल्ट वैल्यू का इस्तेमाल नहीं किया जाता है, तो इन्हें तय करें:

apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123
  --host 35.197.94.184 --port 9443 --ssl https

इसके अलावा, इंटरैक्टिव फ़ॉर्म का इस्तेमाल करें. इसमें आपसे सारी जानकारी मांगी जाती है:

apigee-ssoadminapi.sh admin list

इसके बाद, आपसे सभी ज़रूरी जानकारी मांगी जाएगी:

SSO admin name (current): ssoadmin
SSO Admin secret (current):
SSO host: 35.197.94.184