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

Edge for Private Cloud v4.18.05

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 - আপনার পছন্দের পোর্টে apigee-sso, Edge 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. আপনার কনফিগারেশন ফাইলে নিম্নলিখিত সেটিংস যোগ করুন: 
    # 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 ডেভেলপার পরিষেবা পোর্টাল (বা সহজভাবে, পোর্টাল) ইনস্টল করে থাকলে, Ede SSO অ্যাক্সেস করতে HTTPS ব্যবহার করার জন্য এটি আপডেট করুন। আরও জানতে, Edge-এর সাথে যোগাযোগ করার জন্য SAML ব্যবহার করতে পোর্টাল কনফিগার করা দেখুন

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. আপনার কনফিগারেশন ফাইলে নিম্নলিখিত সেটিংস যোগ করুন: 
    # 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. আপনি Developer Services পোর্টাল ইনস্টল করে থাকলে, Ede 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 কনফিগার করুন।