ओपीडीके 4.54.00 से, एसएसओ आर्किटेक्चर को मॉडर्न बनाया गया है. आइडेंटिटी ब्रोकर (डेक्स) अब सीधे तौर पर apigee-openldap कॉम्पोनेंट में एम्बेड किया गया है. इससे, लेगसी apigee-sso मॉड्यूल को अलग से इंस्टॉल करने की ज़रूरत नहीं पड़ती.
Apigee SSO को चालू और कॉन्फ़िगर करने के लिए, आपको यह काम करना होगा:
- New Edge यूज़र इंटरफ़ेस (यूआई) के लिए मशीन उपयोगकर्ता बनाना: New Edge यूज़र इंटरफ़ेस (यूआई) को मैनेजमेंट एपीआई को कॉल करने के लिए, मशीन उपयोगकर्ता बनाना होगा.
- कॉमन कॉन्फ़िगरेशन फ़ाइल में प्रॉपर्टी कॉन्फ़िगर करना: एक कॉन्फ़िगरेशन फ़ाइल बनाएं. इसमें OpenLDAP (एसएसओ) सेवा और New Edge यूज़र इंटरफ़ेस (यूआई), दोनों के लिए ज़रूरी प्रॉपर्टी शामिल हों.
- Postgres में एसएसओ डेटाबेस बनाना: Apigee PostgreSQL इंस्टेंस में, एसएसओ के लिए एक डेटाबेस बनाएं.
- OpenLDAP में एसएसओ कॉन्फ़िगरेशन लागू करना: OpenLDAP नोड पर इंटिग्रेट किए गए Apigee SSO को शुरू करने के लिए, कॉन्फ़िगरेशन फ़ाइल लागू करें.
- New Edge यूज़र इंटरफ़ेस (यूआई) को कॉन्फ़िगर करना: नए Apigee SSO का इस्तेमाल करने के लिए, New Edge यूज़र इंटरफ़ेस (यूआई) की प्रॉपर्टी अपडेट करें.
इनमें से हर चरण के बारे में, आगे आने वाले सेक्शन में बताया गया है.
यूज़र इंटरफ़ेस (यूआई) के लिए मशीन उपयोगकर्ता बनाना
कुछ कार्रवाइयों के लिए, New Edge यूज़र इंटरफ़ेस (यूआई) को बैकएंड में मैनेजमेंट एपीआई को कॉल करने के लिए, मशीन उपयोगकर्ता की ज़रूरत होती है. इसके लिए,
apigee-openldap नोड में पहले से इंस्टॉल की गई स्क्रिप्ट का इस्तेमाल किया जाता है.
स्क्रिप्ट और मशीन उपयोगकर्ताओं के बारे में ज़्यादा जानने के लिए, apigee-machine-user स्क्रिप्ट का इस्तेमाल करना लेख पढ़ें.
New Edge यूज़र इंटरफ़ेस (यूआई) के लिए मशीन उपयोगकर्ता बनाने के लिए, apigee-openldap नोड
में यह कमांड इस्तेमाल करें. साथ ही, अगले चरण में कॉन्फ़िगरेशन फ़ाइल में प्रॉपर्टी
तय करते समय, ठीक वही क्रेडेंशियल इस्तेमाल करें.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
कॉमन कॉन्फ़िगरेशन फ़ाइल में प्रॉपर्टी कॉन्फ़िगर करना
Apigee SSO और New Edge यूज़र इंटरफ़ेस (यूआई) को चालू करने से पहले, आपको एक कॉमन कॉन्फ़िगरेशन फ़ाइल तय करनी होगी. जैसे, /opt/silent.conf. अपने एनवायरमेंट के हिसाब से, इस पाथ और फ़ाइल के नाम में बदलाव किया जा सकता है.
अपनी /opt/silent.conf में, ये बुनियादी कॉन्फ़िगरेशन प्रॉपर्टी जोड़ें:
# ========================================== # SSO Enablement # ========================================== ENABLE_SSO=y # ========================================== # SSO Hostname/IP and Port config for Dex # ========================================== SSO_PUBLIC_URL_SCHEME=http SSO_PUBLIC_URL_HOSTNAME=localhost SSO_PUBLIC_URL_PORT=9099 # ========================================== # Static Client UI credentials # ========================================== MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123 # ========================================== # Management UI & SSO redirect URLs # ========================================== MANAGEMENT_UI_SCHEME=http MANAGEMENT_UI_IP=localhost MANAGEMENT_UI_PORT=3001 # ========================================== # Management Server parameters (Required for SSO registration) # ========================================== MSIP=localhost ADMIN_EMAIL=admin@apigee.com APIGEE_ADMINPW=Secret123 # ========================================== # Machine user for UI # ========================================== UI_MACHINE_USER=ui-machine-user@apigee.com UI_MACHINE_PWD=Secret123 # ========================================== # Postgres connection parameters # ========================================== PG_HOST=postgres_host PG_USER=apigee PG_PWD=postgres_password # ========================================== # Other UI Parameters # ========================================== # Set to sso to enable SSO, default value is basic. AUTH_MODE=sso # Y to use internal LDAP for authentication, N to use external IDP SSO_LOCAL_LDAP=y MANAGEMENT_UI_APP_ENV=OPDK MANAGEMENT_UI_SSO_ENABLED=y MANAGEMENT_UI_SSO_CSRF_SECRET=secret MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24 MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24 MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5
एसएसओ प्रॉपर्टी डिस्ट्रिब्यूशन
Apigee SSO प्रॉपर्टी, इन कॉन्फ़िगरेशन फ़ाइलों में डिस्ट्रिब्यूट की जाती हैं:
/opt/silent.conf(या आपकी कस्टम कॉन्फ़िगरेशन फ़ाइल): इसमें एसएसओ और New Edge यूज़र इंटरफ़ेस (यूआई) के लिए, बुनियादी कॉन्फ़िगरेशन प्रॉपर्टी शामिल होती हैं./opt/apigee/customer/application/openldap.properties: इसमें एसएसओ के लिए अतिरिक्त कॉन्फ़िगरेशन प्रॉपर्टी शामिल होती हैं. जैसे, एसएएमएल और एचटीटीपीएस जैसी ज़रूरी नहीं वाली सुविधाओं के लिए.
apigee-openldap कॉम्पोनेंट में मौजूद setup-sso स्क्रिप्ट, ऊपर दी गई दोनों फ़ाइलों से वैरिएबल पार्स करती है. आपको अपने इस्तेमाल के उदाहरण के हिसाब से, कॉन्फ़िगरेशन फ़ाइलों में ज़रूरी प्रॉपर्टी कॉन्फ़िगर करनी होंगी.
आपके एनवायरमेंट के हिसाब से, ये चरण ज़रूरी नहीं हैं:
Postgres में एसएसओ डेटाबेस बनाना
उस नोड पर जहां apigee-postgresql चल रहा है (प्राइमरी-स्टैंडबाय सेटअप में मास्टर नोड), एसएसओ के लिए एक डेटाबेस बनाएं:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-sso-db
OpenLDAP में एसएसओ कॉन्फ़िगरेशन लागू करना
Apigee SSO, डायरेक्ट्री कॉम्पोनेंट में एम्बेड किया गया है. इसलिए, आपको स्टैंडअलोन पैकेज इंस्टॉल करने की ज़रूरत नहीं है. आपको सिर्फ़ OpenLDAP नोड पर कॉन्फ़िगरेशन फ़ाइल लागू करनी होगी.
Apigee SSO को चालू और शुरू करने के लिए:apigee-openldapको होस्ट करने वाले नोड में लॉग इन करें.setup-ssoकमांड चलाएं. साथ ही, अपनी कॉन्फ़िगरेशन फ़ाइल पास करें:/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f /opt/silent.conf
New Edge यूज़र इंटरफ़ेस (यूआई) को कॉन्फ़िगर करना
Apigee SSO के चालू होने के बाद, आपको New Edge यूज़र इंटरफ़ेस (यूआई) को उससे कम्यूनिकेट करने के लिए कॉन्फ़िगर करना होगा.
New Edge यूज़र इंटरफ़ेस (यूआई) पर बाहरी आईडीपी चालू करने के बाद, New Edge यूज़र इंटरफ़ेस (यूआई), मैनेजमेंट सर्वर से कनेक्ट करने के लिए OIDC/OAuth2 का इस्तेमाल करता है. आपको New Edge यूज़र इंटरफ़ेस (यूआई) और Edge मैनेजमेंट सर्वर के बीच टोकन की समयसीमा खत्म होने की चिंता करने की ज़रूरत नहीं है. समयसीमा खत्म हो चुके टोकन अपने-आप रीफ़्रेश हो जाते हैं.
- New Edge यूज़र इंटरफ़ेस (यूआई) को होस्ट करने वाले नोड में लॉग इन करें.
- पक्का करें कि आपकी
/opt/silent.confफ़ाइल, इस नोड पर उपलब्ध हो. setupस्क्रिप्ट का इस्तेमाल करके, कॉन्फ़िगरेशन लागू करें:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f /opt/silent.conf