HTTPS অ্যাক্সেসের জন্য apigee-sso কনফিগার করা

Edge for Private Cloud v4.18.01

Edge SSO ইনস্টল ও কনফিগার করুন বিভাগে কনফিগারেশন ফাইলের নিম্নলিখিত প্রপার্টিতে উল্লেখ করা পোর্ট 9099-এ HTTP ব্যবহার করার জন্য Edge SSO মডিউল কীভাবে ইনস্টল ও কনফিগার করতে হয় তা বর্ণনা করা হয়েছে:

SSO_TOMCAT_PROFILE=DEFAULT

অন্যথায়, HTTPS অ্যাক্সেস চালু করতে আপনি SSO_TOMCAT_PROFILE-কে নিম্নলিখিত ভ্যালুর মধ্যে একটিতে সেট করতে পারেন:

  • SSL_PROXY - প্রক্সি মোডে apigee-sso কনফিগার করে, যার অর্থ হল আপনি apigee-sso-এর সামনে একটি লোড ব্যালেন্সার ইনস্টল করেছেন এবং লোড ব্যালেন্সারে TLS বন্ধ করেছেন। তারপর আপনি লোড ব্যালেন্সার থেকে অনুরোধের জন্য apigee-sso-তে ব্যবহৃত পোর্ট নির্দিষ্ট করেন।
  • SSL_TERMINATION - আপনার পছন্দের পোর্টে Edge SSO মডিউল, apigee-sso-তে TLS অ্যাক্সেস চালু করা হয়েছে। এই মোডের জন্য আপনাকে অবশ্যই একটি কীস্টোর নির্দিষ্ট করতে হবে যাতে CA দ্বারা স্বাক্ষরিত একটি সার্টিফিকেট রয়েছে। আপনি সেল্ফ-সাইনড সার্টিফিকেট ব্যবহার করতে পারবেন না।

আপনি প্রাথমিকভাবে apigee-sso ইনস্টল ও কনফিগার করার সময় HTTPS চালু করতে পারেন অথবা পরে চালু করতে পারেন।

যেকোনও মোড ব্যবহার করে apigee-sso-তে HTTPS অ্যাক্সেস চালু করলে HTTP অ্যাক্সেস বন্ধ হয়ে যায়। অর্থাৎ, আপনি HTTP এবং HTTPS দুটি ব্যবহার করে একই সাথে apigee-sso অ্যাক্সেস করতে পারবেন না।

SSL_PROXY মোড চালু করুন

SSL_PROXY মোডে, আপনার সিস্টেম Edge SSO মডিউলের সামনে লোড ব্যালেন্সার ব্যবহার করে এবং লোড ব্যালেন্সারে TLS বন্ধ করে দেয়। নিচের ছবিতে, লোড ব্যালেন্সার পোর্ট 443-এ TLS বন্ধ করে এবং তারপরে পোর্ট 9099-এ Edge SSO মডিউলে অনুরোধ ফরওয়ার্ড করে:

এই কনফিগারেশনে, আপনি লোড ব্যালেন্সার থেকে Edge SSO মডিউলে কানেকশন বিশ্বাস করেন তাই সেই কানেকশনের জন্য TLS ব্যবহার করার প্রয়োজন নেই। তবে, SAML IDP-এর মতো এক্সটার্নাল এন্টিটিকে এখন অবশ্যই পোর্ট ৪৪৩-এ Edge SSO মডিউল অ্যাক্সেস করতে হবে, ৯০৯৯-এর অসুরক্ষিত পোর্টে নয়।

SSL_PROXY মোডে Edge SSO মডিউল কনফিগার করার কারণ হল, Edge SSO মডিউল অটোমেটিক রিডাইরেক্ট URL জেনারেট করে যা যাচাইকরণ প্রক্রিয়ার অংশ হিসেবে IDP এক্সটার্নালভাবে ব্যবহার করে। তাই, এই রিডাইরেক্ট URL-এ লোড ব্যালেন্সারের এক্সটার্নাল পোর্ট নম্বর থাকতে হবে, এই উদাহরণে ৪৪৩ এবং Edge SSO মডিউলের ইন্টার্নাল পোর্ট ৯০৯৯ নয়।

মনে রাখবেন: SSL_PROXY মোডের জন্য আপনাকে TLS সার্টিফিকেট ও কী তৈরি করতে হবে না, কারণ লোড ব্যালেন্সার থেকে Edge SSO মডিউলের কানেকশন HTTP ব্যবহার করে।

SSL_PROXY মোডের জন্য Edge SSO মডিউল কনফিগার করতে:

  1. আপনার কনফিগারেশন ফাইলে নিম্নলিখিত সেটিংস যোগ করুন:
    # SSL_PROXY মোড চালু করুন।
    SSO_TOMCAT_PROFILE=SSL_PROXY

    # Specify the apigee-sso port, typically between 1025 and 65535.
    # সাধারণত ১০২৪ এবং তার নিচের পোর্টগুলির জন্য apigee-sso-এর রুট অ্যাক্সেস প্রয়োজন।
    # ডিফল্ট হল ৯০৯৯।
    SSO_TOMCAT_PORT=9099

    # TLS বন্ধ করার জন্য লোড ব্যালেন্সারে পোর্ট নম্বর নির্দিষ্ট করুন।
    # 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 SSO মডিউল কনফিগার করুন:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso setup -f configFile
  3. Edge SSO অ্যাক্সেস করতে, লোড ব্যালেন্সারের পোর্ট 443-এ HTTPS অনুরোধ করতে আপনার IDP কনফিগারেশন আপডেট করুন। আরও জানতে আপনার SAML IDP কনফিগার করুন।
  4. নিম্নলিখিত প্রপার্টি সেট করে HTTPS-এর জন্য আপনার Edge UI কনফিগারেশন আপডেট করুন:
    SSO_PUBLIC_URL_PORT=443
    SSO_PUBLIC_URL_SCHEME=https

    আরও জানতে Edge UI-তে SAML চালু করুন দেখুন।
  5. আপনি Developer Services পোর্টাল বা API BaaS ইনস্টল করে থাকলে, Edge SSO অ্যাক্সেস করতে HTTPS ব্যবহার করার জন্য সেগুলি আপডেট করুন। আরও জানতে, এখানে দেখুন:

SSL_TERMINATION মোড চালু করুন

SSL_TERMINATION মোডের জন্য, আপনাকে অবশ্যই:

  • TLS সার্টিফিকেট ও 'কী' জেনারেট করে সেগুলিকে একটি 'কী' স্টোর ফাইলে সেভ করুন। আপনি সেল্ফ-সাইনড সার্টিফিকেট ব্যবহার করতে পারবেন না। আপনাকে অবশ্যই CA থেকে একটি সার্টিফিকেট তৈরি করতে হবে।
  • apigee-sso-এর জন্য কনফিগারেশন সেটিংস আপডেট করুন।

আপনার সার্টিফিকেট ও 'কী' থেকে keystore ফাইল তৈরি করতে:

  1. JKS ফাইলের জন্য একটি ডিরেক্টরি তৈরি করুন:
    > sudo mkdir -p /opt/apigee/customer/application/apigee-sso/tomcat-ssl/
  2. নতুন ডিরেক্টরিতে পরিবর্তন করুন:
    > cd /opt/apigee/customer/application/apigee-sso/tomcat-ssl/
  3. সার্টিফিকেট ও 'কী' সহ একটি JKS ফাইল তৈরি করুন। এই মোডের জন্য আপনাকে অবশ্যই একটি কীস্টোর নির্দিষ্ট করতে হবে যেটিতে CA দ্বারা স্বাক্ষরিত একটি সার্টিফিকেট রয়েছে। আপনি সেল্ফ-সাইনড সার্টিফিকেট ব্যবহার করতে পারবেন না। JKS ফাইল তৈরি করার উদাহরণ দেখতে, Edge On Premises-এর জন্য TLS/SSL কনফিগার করা দেখুন।
  4. "apigee" ব্যবহারকারীর মালিকানাধীন JKS ফাইল তৈরি করুন:
    > sudo chown -R apigee:apigee /opt/apigee/customer/application/apigee-sso/tomcat-ssl

Edge SSO মডিউল কনফিগার করতে:

  1. আপনার কনফিগারেশন ফাইলে নিম্নলিখিত সেটিংস যোগ করুন:
    # SSL_TERMINATION মোড চালু করুন।
    SSO_TOMCAT_PROFILE=SSL_TERMINATION

    # Specify the path to the keystore file.
    SSO_TOMCAT_KEYSTORE_FILEPATH=/opt/apigee/customer/application/apigee-sso/tomcat-ssl/keystore.jks
    SSO_TOMCAT_KEYSTORE_ALIAS=sso

    # আপনি কীস্টোর তৈরি করার সময় যে পাসওয়ার্ড উল্লেখ করেছিলেন।
    SSO_TOMCAT_KEYSTORE_PASSWORD=keystorePassword

    # ১০২৫ থেকে ৬৫৫৩৫-এর মধ্যে HTTPS পোর্ট নম্বর উল্লেখ করুন।
    # সাধারণত ১০২৪ এবং তার নিচের পোর্টগুলির জন্য apigee-sso-এর রুট অ্যাক্সেস প্রয়োজন।
    # ডিফল্ট হল ৯০৯৯।
    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 SSO মডিউল কনফিগার করুন:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso setup -f configFile
  3. Edge SSO অ্যাক্সেস করতে, লোড ব্যালেন্সারের পোর্ট ৯৪৪৩-এ HTTPS অনুরোধ করতে, আপনার IDP কনফিগারেশন আপডেট করুন। আরও জানতে আপনার SAML IDP কনফিগার করুন।
  4. নিম্নলিখিত প্রপার্টি সেট করে HTTPS-এর জন্য আপনার Edge UI কনফিগারেশন আপডেট করুন:
    SSO_PUBLIC_URL_PORT=9443
    SSO_PUBLIC_URL_SCHEME=https

    আরও জানতে Edge UI-তে SAML চালু করুন দেখুন।
  5. আপনি Developer Services পোর্টাল বা API BaaS ইনস্টল করে থাকলে, Edge SSO অ্যাক্সেস করতে HTTPS ব্যবহার করার জন্য সেগুলি আপডেট করুন। আরও জানতে, এখানে দেখুন:

SSL_TERMINATION মোড ব্যবহার করার সময় SSO_TOMCAT_PROXY_PORT সেট করা হচ্ছে

Edge SSO মডিউলের সামনে আপনার একটি লোড ব্যালেন্সার থাকতে পারে যা লোড ব্যালেন্সারে TLS বন্ধ করে দেয় কিন্তু লোড ব্যালেন্সার এবং Edge SSO-এর মধ্যে TLS চালু করে। উপরের ছবিতে SSL_PROXY মোডের জন্য, এর অর্থ হল লোড ব্যালেন্সার থেকে Edge SSO-এর কানেকশন TLS ব্যবহার করে।

এই পরিস্থিতিতে, আপনি Edge SSO-তে TLS কনফিগার করেন, ঠিক যেভাবে আপনি উপরে SSL_TERMINATION মোডের জন্য করেছেন। তবে, লোড ব্যালেন্সার যদি TLS-এর জন্য Edge SSO-এর ব্যবহার করা TLS পোর্ট নম্বরের থেকে আলাদা পোর্ট নম্বর ব্যবহার করে, তাহলে আপনাকে কনফিগারেশন ফাইলে SSO_TOMCAT_PROXY_PORT প্রপার্টিও উল্লেখ করতে হবে। যেমন:

  • লোড ব্যালেন্সার পোর্ট ৪৪৩-এ TLS বন্ধ করে দেয়
  • Edge SSO পোর্ট 9443-এ TLS বন্ধ করে দেয়

কনফিগারেশন ফাইলে নিম্নলিখিত সেটিং অন্তর্ভুক্ত করতে ভুলবেন না:

# TLS বন্ধ করার জন্য লোড ব্যালেন্সারে পোর্ট নম্বর উল্লেখ করুন।
# রিডাইরেক্ট URL তৈরি করার জন্য apigee-sso-এর এই পোর্ট নম্বর প্রয়োজন হয়।
SSO_TOMCAT_PROXY_PORT=443
SSO_PUBLIC_URL_PORT=443

পোর্ট ৪৪৩-এ HTTPS অনুরোধ করার জন্য IDP এবং Edge UI কনফিগার করুন।