Edge for Private Cloud v. 4.17.09
Edge एसएसओ मॉड्यूल में दो तरह के खाते इस्तेमाल किए जा सकते हैं:
- administrator
- मशीन का इस्तेमाल करने वाला व्यक्ति
apigee-ssoadminapi.sh यूटिलिटी की मदद से, Edge एसएसओ मॉड्यूल से जुड़े एडमिन और मशीन उपयोगकर्ताओं को मैनेज किया जा सकता है.
apigee-ssoadminapi.sh यूटिलिटी का इस्तेमाल करके:
- एडमिन/मशीन उपयोगकर्ताओं की सूची देखना
- एडमिन/मशीन उपयोगकर्ताओं को जोड़ना या मिटाना
- एडमिन/मशीन उपयोगकर्ताओं का पासवर्ड बदलना
एडमिन उपयोगकर्ताओं के बारे में जानकारी
Edge एसएसओ मॉड्यूल की प्रॉपर्टी मैनेज करने के लिए, आपके पास इस मॉड्यूल का एडमिन खाता होना चाहिए. मॉड्यूल से कनेक्ट करने के लिए, आपको एपीआई BaaS या पोर्टल को कॉन्फ़िगर करना होगा. इसके लिए, आपके पास एडमिन खाते के क्रेडेंशियल होने चाहिए.
डिफ़ॉल्ट रूप से, Edge एसएसओ मॉड्यूल इंस्टॉल करने पर, यह इन क्रेडेंशियल के साथ एक एडमिन खाता बनाता है:
- username: इसे Edge SSO मॉड्यूल को कॉन्फ़िगर करने के लिए इस्तेमाल की जाने वाली कॉन्फ़िगरेशन फ़ाइल में, SSO_ADMIN_NAME प्रॉपर्टी से तय किया जाता है. डिफ़ॉल्ट रूप से, यह ssoadmin पर सेट होता है.
- password: इसे Edge एसएसओ मॉड्यूल को कॉन्फ़िगर करने के लिए इस्तेमाल की जाने वाली कॉन्फ़िगरेशन फ़ाइल में, SSO_ADMIN_SECRET प्रॉपर्टी से तय किया जाता है.
मशीन यूज़र के बारे में जानकारी
मशीन यूज़र, पासकोड डाले बिना OAuth2 टोकन हासिल कर सकता है. इसका मतलब है कि Edge मैनेजमेंट एपीआई का इस्तेमाल करके, OAuth2 टोकन पाने और उन्हें रीफ़्रेश करने की प्रोसेस को पूरी तरह से ऑटोमेट किया जा सकता है.
आम तौर पर, मशीन यूज़र का इस्तेमाल इनके लिए किया जाता है:
- Edge के साथ कम्यूनिकेट करने के लिए, डेवलपर सेवाओं के पोर्टल को कॉन्फ़िगर करना
- जब डेवलपमेंट एनवायरमेंट, डेवलपमेंट से जुड़े सामान्य टास्क के लिए ऑटोमेशन की सुविधा देता है. जैसे, टेस्ट ऑटोमेशन या लगातार इंटिग्रेशन/लगातार डिप्लॉयमेंट (सीआई/सीडी).
ज़्यादा जानकारी के लिए, अपने-आप होने वाले टास्क के लिए एसएएमएल का इस्तेमाल करना लेख पढ़ें.
apigee-ssoadminapi.sh इंस्टॉल करना
Edge मैनेजमेंट सर्वर नोड पर, apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल करें. यह वही नोड होना चाहिए जहां आपने Edge एसएसओ मॉड्यूल इंस्टॉल किया है. आम तौर पर, Edge एसएसओ मॉड्यूल इंस्टॉल करते समय, apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल की जाती है.
अगर आपने अब तक apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल नहीं की है, तो:
- मैनेजमेंट सर्वर नोड में लॉग इन करें. उस नोड में apigee-service पहले से इंस्टॉल होनी चाहिए. इसके बारे में Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख में बताया गया है.
- Edge एसएसओ मॉड्यूल
के लिए, एडमिन और मशीन उपयोगकर्ताओं को मैनेज करने के लिए इस्तेमाल की जाने वाली apigee-ssoadminapi.sh यूटिलिटी इंस्टॉल करें: > /opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install - शेल से लॉग आउट करें. इसके बाद, अपने पाथ में apigee-ssoadminapi.sh यूटिलिटी को जोड़ने के लिए, फिर से लॉग इन करें.
apigee-ssoadminapi.sh के लिए सहायता जानकारी देखी जा रही है
यूटिलिटी के लिए ये कमांड उपलब्ध हैं:
- एडमिन जोड़ें
- एडमिन को मिटाना
- एडमिन की सूची
- एडमिन का सेट किया हुआ पासवर्ड
- saml machineuser add
- SAML मशीन यूज़र को मिटाना
- 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 की वैल्यू को शामिल नहीं किया गया है. ऐसा इसलिए, क्योंकि Edge एसएसओ मॉड्यूल, --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