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

Edge for Private Cloud v4.19.01

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

SSO_TOMCAT_PROFILE=DEFAULT

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

  • SSL_PROXY - প্রক্সি মোডে apigee-sso, Edge SSO মডিউল কনফিগার করে, যার অর্থ হল আপনি apigee-sso-এর সামনে লোড ব্যালেন্সার ইনস্টল করেছেন এবং লোড ব্যালেন্সারে TLS বন্ধ করেছেন। তারপর আপনি লোড ব্যালেন্সার থেকে অনুরোধের জন্য apigee-sso-এ ব্যবহৃত পোর্ট নির্দিষ্ট করেন।
  • SSL_TERMINATION - আপনার পছন্দের পোর্টে 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 মোডের জন্য Edge SSO মডিউল কনফিগার করতে:

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

# Specify the apigee-sso port, typically between 1025 and 65535.
# Typically ports 1024 and below require root access by apigee-sso.
# The default is 9099.
SSO_TOMCAT_PORT=9099

# Specify the port number on the load balancer for terminating 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 আপডেট করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

    আরও জানতে Edge UI-তে SAML চালু করুন দেখুন।

  5. আপনি Apigee ডেভেলপার পরিষেবা পোর্টাল (বা সহজভাবে, পোর্টাল) ইনস্টল করে থাকলে, Edge SSO অ্যাক্সেস করতে HTTPS ব্যবহার করার জন্য এটি আপডেট করুন। আরও জানতে, Edge-এর সাথে যোগাযোগ করার জন্য SAML ব্যবহার করতে পোর্টাল কনফিগার করা দেখুন

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

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

  • TLS সার্টিফিকেট ও কী তৈরি করে keystore ফাইলে সেভ করুন। আপনি সেল্ফ-সাইনড সার্টিফিকেট ব্যবহার করতে পারবেন না। আপনাকে অবশ্যই 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. আপনার কনফিগারেশন ফাইলে নিম্নলিখিত সেটিংস যোগ করুন: 
    # Enable SSL_TERMINATION mode.
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

# The password specified when you created the keystore.
SSO_TOMCAT_KEYSTORE_PASSWORD=keystorePassword

# Specify the HTTPS port number between 1025 and 65535.
# Typically ports 1024 and below require root access by apigee-sso.
# The default is 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 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. আপনি যদি ডেভেলপার পরিষেবা পোর্টাল ইনস্টল করে থাকেন, তাহলে Edge SSO অ্যাক্সেস করতে HTTPS ব্যবহার করার জন্য এটি আপডেট করুন। আরও জানতে, Edge-এর সাথে যোগাযোগ করার জন্য SAML ব্যবহার করতে ডেভেলপার পরিষেবা পোর্টাল কনফিগার করা দেখুন।

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 বন্ধ করে দেয়

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

# Specify the port number on the load balancer for terminating TLS.
# This port number is necessary for apigee-sso to generate redirect URLs.
SSO_TOMCAT_PROXY_PORT=443
SSO_PUBLIC_URL_PORT=443

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