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

Edge for Private Cloud v4.18.01

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

  • administrator
  • मशीन उपयोगकर्ता

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

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

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

एडमिन यूज़र के बारे में जानकारी

Edge एसएसओ मॉड्यूल पर, एडमिन खाते की ज़रूरत होती है, ताकि प्रॉपर्टी को मैनेज किया जा सके मॉड्यूल का इस्तेमाल करें. API BaaS या पोर्टल को कॉन्फ़िगर करने के लिए, आपको एडमिन खाते के क्रेडेंशियल की भी ज़रूरत होगी मॉड्यूल से कनेक्ट करना चाहिए.

डिफ़ॉल्ट रूप से, एज एसएसओ मॉड्यूल इंस्टॉल किए जाने पर, एडमिन खाता क्रेडेंशियल:

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

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

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

मशीन उपयोगकर्ता खातों का इस्तेमाल इन कामों के लिए किया जाता है:

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

ज़्यादा जानकारी के लिए, अपने-आप काम करने वाले एसएएमएल के साथ एसएएमएल का इस्तेमाल करना Tasks.

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

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

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

  1. मैनेजमेंट सर्वर नोड में लॉग इन करें. उस नोड में apigee-service पहले से इंस्टॉल होना चाहिए, जैसा कि Edge apigee-setup टूल को इंस्टॉल करना में बताया गया है.
  2. apigee-ssoadminapi.sh उपयोगिता इंस्टॉल करें. इसका इस्तेमाल, Edge एसएसओ मॉड्यूल के लिए एडमिन और मशीन के उपयोगकर्ताओं को मैनेज करने के लिए किया जाता है:
    >
    /opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install
  3. शेल से लॉग आउट करें और फिर से अपने खाते में apigee-ssoadminapi.sh सुविधा जोड़ने के लिए फिर से लॉग इन करें पाथ.

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

इस सुविधा के लिए ये कमांड उपलब्ध हैं:

  • admin add
  • admin delete
  • एडमिन की सूची
  • एडमिन सेटपासवर्ड
  • एसएएमएल मशीन उपयोगकर्ता ऐड
  • saml machineuser delete
  • aaml मशीन उपयोगकर्ता सूची
  • 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 की वैल्यू नहीं दी गई हैं, क्योंकि Edge 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