নতুন Edge UI-এর জন্য TLS কনফিগার করা

ডিফল্ট হিসেবে, আপনি HTTP-এর মাধ্যমে নতুন Edge UI অ্যাক্সেস করেন। এর জন্য Edge UI নোড ও পোর্ট ৩০০১-এর IP অ্যাড্রেস বা DNS নাম ব্যবহার করা হয়। যেমন:

http://newue_IP:3001

এছাড়াও, আপনি Edge UI-তে TLS অ্যাক্সেস কনফিগার করতে পারেন যাতে আপনি এটি এই ফর্মে অ্যাক্সেস করতে পারেন:

https://newue_IP:3001

TLS সংক্রান্ত প্রয়োজনীয়তা

Edge UI-তে শুধু TLS v1.2 কাজ করে। আপনি Edge UI-তে TLS চালু করলে, ব্যবহারকারীদের অবশ্যই TLS v1.2-এর সাথে মানানসই ব্রাউজার ব্যবহার করে Edge UI-তে কানেক্ট করতে হবে।

TLS কনফিগারেশন প্রপার্টি

Edge UI-এর জন্য TLS কনফিগার করতে নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

যেখানে configFile হল কনফিগ ফাইল যা আপনি Edge UI ইনস্টল করতে ব্যবহার করেছেন।

এই কমান্ড এক্সিকিউট করার আগে, TLS কন্ট্রোল করে এমন প্রয়োজনীয় প্রপার্টি সেট করতে আপনাকে অবশ্যই কনফিগারেশন ফাইল এডিট করতে হবে। নিম্নলিখিত সারণীতে সেইসব প্রপার্টির বিবরণ দেওয়া হয়েছে যেগুলি আপনি Edge UI-এর জন্য TLS কনফিগার করতে ব্যবহার করেন:

প্রপার্টি বিবরণ প্রয়োজনীয়?
MANAGEMENT_UI_SCHEME

Edge UI অ্যাক্সেস করার জন্য ব্যবহৃত প্রোটোকল, "http" বা "https" সেট করে। ডিফল্ট ভ্যালু হল "http"। TLS চালু করতে এটি "https" হিসেবে সেট করুন:

MANAGEMENT_UI_SCHEME=https
 		হ্যাঁ
MANAGEMENT_UI_TLS_OFFLOAD

"n" হলে, Edge UI-তে TLS অনুরোধ Edge UI-তে শেষ করা হয়েছে বলে নির্দিষ্ট করে। আপনাকে অবশ্যই MANAGEMENT_UI_TLS_KEY_FILE এবং MANAGEMENT_UI_TLS_CERT_FILE. সেট করতে হবে

"y" হলে, এটি নির্দিষ্ট করে যে Edge UI-তে TLS অনুরোধগুলি একটি লোড ব্যালেন্সারে বন্ধ করা হয়েছে এবং লোড ব্যালেন্সার তারপর HTTP ব্যবহার করে Edge UI-তে অনুরোধটি ফরওয়ার্ড করে।

আপনি লোড ব্যালেন্সারে TLS বন্ধ করে দিলেও, আসল অনুরোধ যে TLS-এর মাধ্যমে এসেছে তা Edge UI-কে জানতে হবে। যেমন, কিছু কুকিতে 'নিরাপদ' ফ্ল্যাগ সেট করা থাকে।

আপনাকে অবশ্যই MANAGEMENT_UI_SCHEME-কে "https" হিসেবে সেট করতে হবে, অন্যথায় MANAGEMENT_UI_TLS_OFFLOAD উপেক্ষা করা হবে:

MANAGEMENT_UI_SCHEME=https
MANAGEMENT_UI_TLS_OFFLOAD=y
 		হ্যাঁ
MANAGEMENT_UI_TLS_KEY_FILE

MANAGEMENT_UI_TLS_CERT_FILE

MANAGEMENT_UI_TLS_OFFLOAD=n হলে, TLS কী এবং সার্টিফিকেট ফাইলের অ্যাবসোলিউট পাথ নির্দিষ্ট করে। ফাইলগুলি অবশ্যই PEM ফাইল হিসাবে ফর্ম্যাট করা উচিত, কোনও পাসফ্রেজ ছাড়াই এবং অবশ্যই "apigee" ব্যবহারকারীর মালিকানাধীন হতে হবে।

এইসব ফাইলের জন্য সাজেস্ট করা লোকেশন হল: 

/opt/apigee/customer/application/edge-management-ui

সেই ডিরেক্টরি না থাকলে, তৈরি করুন।

MANAGEMENT_UI_TLS_OFFLOAD=y হলে, MANAGEMENT_UI_TLS_KEY_FILE এবং MANAGEMENT_UI_TLS_CERT_FILE. বাদ দিন। এগুলি উপেক্ষা করা হয় কারণ Edge UI-তে অনুরোধ HTTP-এর মাধ্যমে আসে।

 হ্যাঁ, যদি MANAGEMENT_UI_TLS_OFFLOAD=n
MANAGEMENT_UI_PUBLIC_URIS

MANAGEMENT_UI_TLS_OFFLOAD=n হলে, Edge UI-এর URL নির্দিষ্ট করে।

কনফিগারেশন ফাইলের অন্যান্য প্রপার্টির উপর ভিত্তি করে এই প্রপার্টি সেট করুন। যেমন:

MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

যেখানে:

  • MANAGEMENT_UI_SCHEME উপরে বর্ণনা করা প্রোটোকল, "http" বা "https" নির্দিষ্ট করে।
  • MANAGEMENT_UI_IP, Edge UI-এর IP অ্যাড্রেস বা DNS নাম নির্দিষ্ট করে।
  • MANAGEMENT_UI_PORT Edge UI-এর মাধ্যমে ব্যবহার করা পোর্ট নির্দিষ্ট করে।

এইসব প্রপার্টি সম্পর্কে আরও জানতে নতুন Edge UI ইনস্টল করুন দেখুন।

যদি MANAGEMENT_UI_TLS_OFFLOAD=y:

  • MANAGEMENT_UI_IP লোড ব্যালেন্সারের IP অ্যাড্রেস বা DNS নাম নির্দিষ্ট করে, Edge UI-এর নয়।
  • লোড ব্যালেন্সার এবং নতুন UE-কে অনুরোধের জন্য একই পোর্ট নম্বর ব্যবহার করতেই হবে, যেমন ৩০০১। লোড ব্যালেন্সার ও নতুন UE-তে পোর্ট নম্বর নির্দিষ্ট করতে MANAGEMENT_UI_PORT ব্যবহার করুন।

হ্যাঁ
SHOEHORN_SCHEME

নতুন Edge UI ইনস্টল করার আগে, আপনাকে প্রথমে বেস Edge UI ইনস্টল করতে হবে, যাকে shoehorn বলা হয়। ইনস্টলেশন কনফিগারেশন ফাইলটি বেস Edge UI অ্যাক্সেস করতে ব্যবহৃত প্রোটোকল, "http" নির্দিষ্ট করতে নিম্নলিখিত প্রপার্টি ব্যবহার করে:

SHOEHORN_SCHEME=http

বেস Edge UI-তে TLS কাজ করে না, তাই আপনি Edge UI-তে TLS চালু করলেও, এই প্রপার্টি "http" হিসেবে সেট করতে হবে।

 হ্যাঁ এবং "http"-এ সেট করুন

TLS কনফিগার করুন

Edge UI-তে TLS অ্যাক্সেস কনফিগার করতে:

  1. কোনও পাসফ্রেজ ছাড়াই PEM ফাইল হিসেবে TLS সার্টিফিকেট ও কী জেনারেট করুন। যেমন:

    mykey.pem
mycert.pem

    TLS সার্টিফিকেট ও কী তৈরি করার অনেক উপায় আছে। যেমন, আপনি নিম্নলিখিত কমান্ডটি এক্সিকিউট করে একটি স্বাক্ষরবিহীন সার্টিফিকেট এবং কী তৈরি করতে পারেন:

    openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'
  2. /opt/apigee/customer/application/edge-management-ui ডিরেক্টরিতে কী ও সার্টিফিকেট ফাইল কপি করুন। সেই ডিরেক্টরি না থাকলে, তৈরি করুন।

  3. সার্টিফিকেট ও কী "apigee" ব্যবহারকারীর মালিকানাধীন কিনা তা নিশ্চিত করুন:

    chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem

  4. নিম্নলিখিত TLS প্রপার্টি সেট করতে, Edge UI ইনস্টল করার জন্য আপনি যে কনফিগারেশন ফাইল ব্যবহার করেছেন সেটি এডিট করুন:

    # Set to https to enable TLS.
MANAGEMENT_UI_SCHEME=https 
# Do NOT terminate TLS on a load balancer.
MANAGEMENT_UI_TLS_OFFLOAD=n

# Specify the key and cert. 
MANAGEMENT_UI_TLS_KEY_FILE=/opt/apigee/customer/application/edge-management-ui/mykey.pem
MANAGEMENT_UI_TLS_CERT_FILE=/opt/apigee/customer/application/edge-management-ui/mycert.pem

# Leave these properties set to the same values as when you installed the Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
SHOEHORN_SCHEME=http

  5. TLS কনফিগার করতে এই কমান্ডটি এক্সিকিউট করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

    যেখানে configFile হল কনফিগ ফাইলের নাম।

    স্ক্রিপ্টটি Edge UI রিস্টার্ট করে।

  6. shoehorn সেট-আপ ও রিস্টার্ট করতে এই কমান্ডগুলি রান করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    রিস্টার্ট করার পরে, Edge UI, HTTPS-এর মাধ্যমে অ্যাক্সেস করার সুবিধা দেয়। TLS চালু করার পরে আপনি যদি Edge UI-তে লগ-ইন করতে না পারেন, তাহলে ব্রাউজার ক্যাশে মুছে দিন এবং আবার লগ-ইন করার চেষ্টা করুন।

লোড ব্যালেন্সারে TLS শেষ হলে Edge UI কনফিগার করুন

আপনার কাছে যদি এমন কোনও লোড ব্যালেন্সার থাকে যা Edge UI-তে অনুরোধ ফরওয়ার্ড করে, তাহলে আপনি লোড ব্যালেন্সারে TLS কানেকশন বন্ধ করার বিকল্প বেছে নিতে পারেন এবং তারপরে লোড ব্যালেন্সার HTTP-এর মাধ্যমে Edge UI-তে অনুরোধ ফরওয়ার্ড করতে পারে:

লোড ব্যালেন্সারে TLS বন্ধ করুন

এই কনফিগারেশন কাজ করে তবে আপনাকে সেই অনুযায়ী লোড ব্যালেন্সার ও Edge UI কনফিগার করতে হবে।

লোড ব্যালেন্সারে TLS শেষ হলে Edge UI কনফিগার করতে:

  1. নিম্নলিখিত TLS প্রপার্টি সেট করতে, Edge UI ইনস্টল করার জন্য আপনি যে কনফিগারেশন ফাইল ব্যবহার করেছেন সেটি এডিট করুন:

    # Set to https to enable TLS
MANAGEMENT_UI_SCHEME=https
# Terminate TLS on a load balancer
MANAGEMENT_UI_TLS_OFFLOAD=y
# Set to the IP address or DNS name of the load balancer.
MANAGEMENT_UI_IP=LB_IP_DNS
# Set to the port number for the load balancer and Edge UI.
# The load balancer and the Edge UI must use the same port number.
MANAGEMENT_UI_IP=3001

# Leave these properties set to the same values as when you installed the Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
SHOEHORN_SCHEME=http

    আপনি MANAGEMENT_UI_TLS_OFFLOAD=y সেট করলে, MANAGEMENT_UI_TLS_KEY_FILE এবং MANAGEMENT_UI_TLS_CERT_FILE. বাদ দিন। এগুলি উপেক্ষা করা হয় কারণ Edge UI-তে অনুরোধ HTTP-এর মাধ্যমে আসে।

  2. TLS কনফিগার করতে এই কমান্ডটি এক্সিকিউট করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

    যেখানে configFile হল কনফিগ ফাইলের নাম।

    স্ক্রিপ্টটি Edge UI রিস্টার্ট করে।

  3. shoehorn সেট-আপ ও রিস্টার্ট করতে এই কমান্ডগুলি রান করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    রিস্টার্ট করার পরে, Edge UI, HTTPS-এর মাধ্যমে অ্যাক্সেস করার সুবিধা দেয়। TLS চালু করার পরে আপনি যদি Edge UI-তে লগ-ইন করতে না পারেন, তাহলে ব্রাউজার ক্যাশে মুছে দিন এবং আবার লগ-ইন করার চেষ্টা করুন।

Edge UI-তে TLS বন্ধ করুন

Edge UI-তে TLS বন্ধ করতে:

  1. নিম্নলিখিত TLS প্রপার্টি সেট করতে, Edge UI ইনস্টল করার জন্য আপনি যে কনফিগারেশন ফাইল ব্যবহার করেছিলেন সেটি এডিট করুন:

    # Set to http to disable TLS.
MANAGEMENT_UI_SCHEME=http

# Only if you had terminated TLS on a load balancer,
# reset to the IP address or DNS name of the Edge UI.
MANAGEMENT_UI_IP=newue_IP_DNS

  2. TLS বন্ধ করতে এই কমান্ডটি এক্সিকিউট করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

    যেখানে configFile হল কনফিগ ফাইলের নাম।

    স্ক্রিপ্টটি Edge UI রিস্টার্ট করে।

  3. shoehorn সেট-আপ ও রিস্টার্ট করতে এই কমান্ডগুলি রান করুন:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    আপনি এখন HTTP-এর মাধ্যমে Edge UI অ্যাক্সেস করতে পারবেন। TLS বন্ধ করার পরে আপনি যদি Edge UI-তে লগ-ইন করতে না পারেন, তাহলে ব্রাউজার ক্যাশে মুছে দিন এবং আবার লগ-ইন করার চেষ্টা করুন।