एचटीटीपीएस ऐक्सेस करने के लिए, apigee-sso कॉन्फ़िगर करें

Edge for Private Cloud v4.18.01

Edge SSO को इंस्टॉल और कॉन्फ़िगर करना लेख में, Edge SSO मॉड्यूल को इंस्टॉल और कॉन्फ़िगर करने का तरीका बताया गया है. इससे पोर्ट 9099 पर एचटीटीपी का इस्तेमाल किया जा सकता है. इसके बारे में, कॉन्फ़िगरेशन फ़ाइल में मौजूद इस प्रॉपर्टी में बताया गया है:

SSO_TOMCAT_PROFILE=DEFAULT

इसके अलावा, एचटीटीपीएस ऐक्सेस चालू करने के लिए, SSO_TOMCAT_PROFILE को इनमें से किसी एक वैल्यू पर सेट किया जा सकता है:

  • SSL_PROXY - यह प्रॉक्सी मोड में apigee-sso को कॉन्फ़िगर करता है. इसका मतलब है कि आपने apigee-sso के सामने लोड बैलेंसर इंस्टॉल किया है और लोड बैलेंसर पर टीएलएस को बंद कर दिया है. इसके बाद, लोड बैलेंसर से मिलने वाले अनुरोधों के लिए, apigee-sso पर इस्तेमाल किए जाने वाले पोर्ट की जानकारी दी जाती है.
  • SSL_TERMINATION - अपनी पसंद के पोर्ट पर, Edge एसएसओ मॉड्यूल apigee-sso के लिए टीएलएस ऐक्सेस चालू किया गया. इस मोड के लिए, आपको एक ऐसा कीस्टोर तय करना होगा जिसमें सीए से साइन किया गया सर्टिफ़िकेट शामिल हो. खुद हस्ताक्षर किया हुआ सर्टिफ़िकेट इस्तेमाल नहीं किया जा सकता.

apigee-sso को पहली बार इंस्टॉल और कॉन्फ़िगर करते समय, एचटीटीपीएस को चालू किया जा सकता है. इसके अलावा, इसे बाद में भी चालू किया जा सकता है.

किसी भी मोड का इस्तेमाल करके, apigee-sso के लिए एचटीटीपीएस ऐक्सेस चालू करने पर, एचटीटीपी ऐक्सेस बंद हो जाता है. इसका मतलब है कि एचटीटीपी और एचटीटीपीएस, दोनों का एक साथ इस्तेमाल करके apigee-sso को ऐक्सेस नहीं किया जा सकता.

SSL_PROXY मोड चालू करना

SSL_PROXY मोड में, आपका सिस्टम Edge एसएसओ मॉड्यूल के सामने लोड बैलेंसर का इस्तेमाल करता है. साथ ही, लोड बैलेंसर पर टीएलएस को बंद कर देता है. नीचे दी गई इमेज में, लोड बैलेंसर, पोर्ट 443 पर टीएलएस को बंद कर देता है. इसके बाद, पोर्ट 9099 पर Edge एसएसओ मॉड्यूल को अनुरोध भेजता है:

इस कॉन्फ़िगरेशन में, लोड बैलेंसर से Edge एसएसओ मॉड्यूल तक के कनेक्शन पर भरोसा किया जाता है. इसलिए, उस कनेक्शन के लिए टीएलएस का इस्तेमाल करने की ज़रूरत नहीं होती. हालांकि, एसएएमएल आईडीपी जैसी बाहरी इकाइयों को अब Edge एसएसओ मॉड्यूल को पोर्ट 443 पर ऐक्सेस करना होगा, न कि असुरक्षित पोर्ट 9099 पर.

Edge एसएसओ मॉड्यूल को SSL_PROXY मोड में कॉन्फ़िगर करने की वजह यह है कि Edge एसएसओ मॉड्यूल, रीडायरेक्ट यूआरएल अपने-आप जनरेट करता है. इनका इस्तेमाल, आईडीपी (पहचान की सेवा देने वाली कंपनी) पुष्टि करने की प्रोसेस के तहत बाहरी तौर पर करती है. इसलिए, इन रीडायरेक्ट यूआरएल में लोड बैलेंसर पर मौजूद बाहरी पोर्ट नंबर शामिल होना चाहिए. इस उदाहरण में, 443 शामिल होना चाहिए, न कि Edge एसएसओ मॉड्यूल पर मौजूद इंटरनल पोर्ट, 9099.

ध्यान दें: आपको SSL_PROXY मोड के लिए, टीएलएस सर्टिफ़िकेट और पासकोड बनाने की ज़रूरत नहीं है. ऐसा इसलिए, क्योंकि लोड बैलेंसर से Edge एसएसओ मॉड्यूल तक का कनेक्शन, एचटीटीपी का इस्तेमाल करता है.

SSL_PROXY मोड के लिए, Edge एसएसओ मॉड्यूल को कॉन्फ़िगर करने के लिए:

  1. अपनी कॉन्फ़िगरेशन फ़ाइल में ये सेटिंग जोड़ें:
    # SSL_PROXY मोड चालू करें.
    SSO_TOMCAT_PROFILE=SSL_PROXY

    # apigee-sso पोर्ट की जानकारी दें. आम तौर पर, यह 1025 से 65535 के बीच होता है.
    # आम तौर पर, 1024 और इससे कम पोर्ट के लिए, apigee-sso को रूट ऐक्सेस की ज़रूरत होती है.
    # डिफ़ॉल्ट रूप से, यह 9099 पर सेट होता है.
    SSO_TOMCAT_PORT=9099

    # टीएलएस को बंद करने के लिए, लोड बैलेंसर पर पोर्ट नंबर डालें.
    # This port number is necessary for apigee-sso to auto-generate redirect URLs.
    SSO_TOMCAT_PROXY_PORT=443
    SSO_PUBLIC_URL_PORT=443

    # Set public access scheme of apigee-sso to https.
    SSO_PUBLIC_URL_SCHEME=https
  2. Edge एसएसओ मॉड्यूल को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso setup -f configFile
  3. अपने आईडीपी कॉन्फ़िगरेशन को अपडेट करें, ताकि Edge एसएसओ को ऐक्सेस करने के लिए, लोड बैलेंसर के पोर्ट 443 पर एचटीटीपीएस अनुरोध किया जा सके. ज़्यादा जानकारी के लिए, अपना एसएएमएल आईडीपी कॉन्फ़िगर करना लेख पढ़ें.
  4. इन प्रॉपर्टी को सेट करके, एचटीटीपीएस के लिए Edge यूज़र इंटरफ़ेस (यूआई) कॉन्फ़िगरेशन को अपडेट करें:
    SSO_PUBLIC_URL_PORT=443
    SSO_PUBLIC_URL_SCHEME=https

    ज़्यादा जानकारी के लिए, Edge यूज़र इंटरफ़ेस (यूआई) पर एसएएमएल चालू करना लेख पढ़ें.
  5. अगर आपने Developer Services पोर्टल या API BaaS इंस्टॉल किया है, तो Edge SSO को ऐक्सेस करने के लिए, उन्हें एचटीटीपीएस का इस्तेमाल करने के लिए अपडेट करें. ज़्यादा जानकारी के लिए, ये लेख पढ़ें:

SSL_TERMINATION मोड चालू करें

SSL_TERMINATION मोड के लिए, आपको ये काम करने होंगे:

  • टीएलएस सर्टिफ़िकेट और कुंजी जनरेट करें और उन्हें कीस्टोर फ़ाइल में सेव करें. खुद हस्ताक्षर किए हुए सर्टिफ़िकेट का इस्तेमाल नहीं किया जा सकता. आपको सीए से सर्टिफ़िकेट जनरेट करना होगा.
  • apigee-sso के लिए कॉन्फ़िगरेशन सेटिंग अपडेट करें.

अपने सर्टिफ़िकेट और पासकोड से कीस्टोर फ़ाइल बनाने के लिए:

  1. जेकेएस फ़ाइल के लिए एक डायरेक्ट्री बनाएं:
    > sudo mkdir -p /opt/apigee/customer/application/apigee-sso/tomcat-ssl/
  2. नई डायरेक्ट्री पर जाएं:
    > cd /opt/apigee/customer/application/apigee-sso/tomcat-ssl/
  3. सर्टिफ़िकेट और पासकोड वाली JKS फ़ाइल बनाएं. आपको इस मोड के लिए एक कीस्टोर तय करना होगा. इसमें सीए से साइन किया गया सर्टिफ़िकेट होना चाहिए. खुद हस्ताक्षर किया हुआ सर्टिफ़िकेट इस्तेमाल नहीं किया जा सकता. जेकेएस फ़ाइल बनाने का उदाहरण देखने के लिए, Edge On Premises के लिए टीएलएस/एसएसएल कॉन्फ़िगर करना लेख पढ़ें.
  4. जेकेएस फ़ाइल का मालिकाना हक "apigee" उपयोगकर्ता को दें:
    > sudo chown -R apigee:apigee /opt/apigee/customer/application/apigee-sso/tomcat-ssl

Edge एसएसओ मॉड्यूल को कॉन्फ़िगर करने के लिए:

  1. अपनी कॉन्फ़िगरेशन फ़ाइल में ये सेटिंग जोड़ें:
    # SSL_TERMINATION मोड चालू करें.
    SSO_TOMCAT_PROFILE=SSL_TERMINATION

    # कीस्टोर फ़ाइल का पाथ डालें.
    SSO_TOMCAT_KEYSTORE_FILEPATH=/opt/apigee/customer/application/apigee-sso/tomcat-ssl/keystore.jks
    SSO_TOMCAT_KEYSTORE_ALIAS=sso

    # कीस्टोर बनाते समय दिया गया पासवर्ड.
    SSO_TOMCAT_KEYSTORE_PASSWORD=keystorePassword

    # एचटीटीपीएस पोर्ट नंबर 1025 से 65535 के बीच डालें.
    # आम तौर पर, 1024 और इससे कम पोर्ट के लिए, apigee-sso को रूट ऐक्सेस की ज़रूरत होती है.
    # डिफ़ॉल्ट रूप से, यह 9099 पर सेट होता है.
    SSO_TOMCAT_PORT=9443
    SSO_PUBLIC_URL_PORT=9443

    # Set public access scheme of apigee-sso to https.
    SSO_PUBLIC_URL_SCHEME=https
  2. Edge एसएसओ मॉड्यूल को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso setup -f configFile
  3. अपने आईडीपी कॉन्फ़िगरेशन को अपडेट करें, ताकि Edge एसएसओ को ऐक्सेस करने के लिए, लोड बैलेंसर के पोर्ट 9443 पर एचटीटीपीएस अनुरोध किया जा सके. ज़्यादा जानकारी के लिए, अपना एसएएमएल आईडीपी कॉन्फ़िगर करना लेख पढ़ें.
  4. एचटीटीपीएस के लिए, Edge यूज़र इंटरफ़ेस (यूआई) के कॉन्फ़िगरेशन को अपडेट करें. इसके लिए, ये प्रॉपर्टी सेट करें:
    SSO_PUBLIC_URL_PORT=9443
    SSO_PUBLIC_URL_SCHEME=https

    ज़्यादा जानकारी के लिए, Edge यूज़र इंटरफ़ेस (यूआई) पर एसएएमएल चालू करना लेख पढ़ें.
  5. अगर आपने Developer Services पोर्टल या API BaaS इंस्टॉल किया है, तो Edge SSO को ऐक्सेस करने के लिए, उन्हें एचटीटीपीएस का इस्तेमाल करने के लिए अपडेट करें. ज़्यादा जानकारी के लिए, ये लेख पढ़ें:

SSL_TERMINATION मोड का इस्तेमाल करते समय, SSO_TOMCAT_PROXY_PORT सेट करना

ऐसा हो सकता है कि आपके पास Edge एसएसओ मॉड्यूल के सामने एक लोड बैलेंसर हो, जो लोड बैलेंसर पर टीएलएस को बंद कर देता है. हालांकि, यह लोड बैलेंसर और Edge एसएसओ के बीच टीएलएस को भी चालू करता है. ऊपर दी गई इमेज में, SSL_PROXY मोड के लिए, इसका मतलब है कि लोड बैलेंसर से Edge एसएसओ तक का कनेक्शन, टीएलएस का इस्तेमाल करता है.

इस मामले में, Edge एसएसओ पर टीएलएस को उसी तरह कॉन्फ़िगर किया जाता है जिस तरह आपने ऊपर SSL_TERMINATION मोड के लिए किया था. हालांकि, अगर लोड बैलेंसर, टीएलएस के लिए Edge एसएसओ से अलग टीएलएस पोर्ट नंबर का इस्तेमाल करता है, तो आपको कॉन्फ़िगरेशन फ़ाइल में SSO_TOMCAT_PROXY_PORT प्रॉपर्टी भी बतानी होगी. उदाहरण के लिए:

  • लोड बैलेंसर, पोर्ट 443 पर टीएलएस को बंद कर देता है
  • Edge SSO, पोर्ट 9443 पर टीएलएस को बंद कर देता है

कॉन्फ़िगरेशन फ़ाइल में यह सेटिंग ज़रूर शामिल करें:

# टीएलएस को बंद करने के लिए, लोड बैलेंसर पर पोर्ट नंबर डालें.
# यह पोर्ट नंबर, apigee-sso के लिए रीडायरेक्ट यूआरएल जनरेट करने के लिए ज़रूरी है.
SSO_TOMCAT_PROXY_PORT=443
SSO_PUBLIC_URL_PORT=443

पोर्ट 443 पर एचटीटीपीएस अनुरोध करने के लिए, आईडीपी और Edge यूज़र इंटरफ़ेस (यूआई) को कॉन्फ़िगर करें.