Apigee SSO ইনস্টল ও কনফিগার করা

OPDK 4.54.00 থেকে শুরু করে, SSO আর্কিটেকচারকে আধুনিক করা হয়েছে। পরিচয় ব্রোকার (Dex) এখন সরাসরি apigee-openldap কম্পোনেন্টের মধ্যে এম্বেড করা হয়েছে, যার ফলে আলাদা লিগ্যাসি apigee-sso মডিউল ইনস্টল করার প্রয়োজন নেই।

Apigee SSO চালু ও কনফিগার করতে, আপনাকে অবশ্যই নিম্নলিখিত কাজগুলি করতে হবে:

  1. New Edge UI-এর জন্য মেশিন ইউজার তৈরি করা: ম্যানেজমেন্ট API চালু করার জন্য New Edge UI-এর প্রয়োজনীয় মেশিন ইউজার তৈরি করুন।
  2. সাধারণ কনফিগারেশন ফাইলে প্রপার্টি কনফিগার করা: এমন একটি কনফিগারেশন ফাইল তৈরি করুন যাতে OpenLDAP (SSO) পরিষেবা এবং New Edge UI, দু'টিরই প্রয়োজনীয় প্রপার্টি থাকে।
  3. Postgres-এ SSO ডেটাবেস তৈরি করুন: Apigee PostgreSQL ইনস্ট্যান্সে SSO-এর জন্য ডেটাবেস তৈরি করুন।
  4. OpenLDAP-এ SSO কনফিগারেশন প্রয়োগ করুন: OpenLDAP নোডে ইন্টিগ্রেটেড Apigee SSO শুরু করতে কনফিগারেশন ফাইল প্রয়োগ করুন।
  5. নতুন Edge UI কনফিগার করুন: নতুন Apigee SSO ব্যবহার করতে, নতুন Edge UI প্রপার্টি আপডেট করুন।

পরবর্তী বিভাগে এই ধাপগুলির প্রতিটি বর্ণনা করা হয়েছে।

UI-এর জন্য মেশিন ব্যবহারকারী তৈরি করা

নির্দিষ্ট অপারেশনের জন্য ব্যাকএন্ডে ম্যানেজমেন্ট API ইনভোক করতে নতুন Edge UI-এর মেশিন ব্যবহারকারী প্রয়োজন। এই উদ্দেশ্যে apigee-openldap নোডে আগে থেকে ইনস্টল করা স্ক্রিপ্ট ব্যবহার করা হয়।

স্ক্রিপ্ট ও মেশিন ব্যবহারকারী সম্পর্কে আরও জানতে apigee-machine-user স্ক্রিপ্ট ব্যবহার করা নিবন্ধটি পড়ুন।

New Edge UI-এর জন্য মেশিন ব্যবহারকারী তৈরি করতে apigee-openldap নোডে নিম্নলিখিত কমান্ড ব্যবহার করুন এবং পরবর্তী ধাপে কনফিগারেশন ফাইলে প্রপার্টি নির্ধারণ করার সময় একই ক্রেডেনশিয়াল ব্যবহার করছেন কিনা তা নিশ্চিত করুন।

 /opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
 

সাধারণ কনফিগারেশন ফাইলে প্রপার্টি কনফিগার করুন

Apigee SSO ও New Edge UI চালু করার আগে, আপনাকে অবশ্যই একটি সাধারণ কনফিগারেশন ফাইল (যেমন, /opt/silent.conf) নির্ধারণ করতে হবে। আপনার এনভায়রনমেন্টের প্রয়োজন অনুযায়ী আপনি এই পাথ ও ফাইলের নাম পরিবর্তন করতে পারবেন।

আপনার /opt/silent.conf-এ নিম্নলিখিত বেস কনফিগারেশন প্রপার্টি যোগ করুন:

# ==========================================
# SSO Enablement
# ==========================================
ENABLE_SSO=y

# ==========================================
# SSO Hostname/IP and Port config for Dex
# ==========================================
SSO_PUBLIC_URL_SCHEME=http
SSO_PUBLIC_URL_HOSTNAME=localhost
SSO_PUBLIC_URL_PORT=9099

# ==========================================
# Static Client UI credentials
# ==========================================
MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui
MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123

# ==========================================
# Management UI & SSO redirect URLs
# ==========================================
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_IP=localhost
MANAGEMENT_UI_PORT=3001

# ==========================================
# Management Server parameters (Required for SSO registration)
# ==========================================
MSIP=localhost
ADMIN_EMAIL=admin@apigee.com
APIGEE_ADMINPW=Secret123

# ==========================================
# Machine user for UI
# ==========================================
UI_MACHINE_USER=ui-machine-user@apigee.com
UI_MACHINE_PWD=Secret123

# ==========================================
# Postgres connection parameters
# ==========================================
PG_HOST=postgres_host
PG_USER=apigee
PG_PWD=postgres_password

# ==========================================
# Other UI Parameters
# ==========================================
# Set to sso to enable SSO, default value is basic.
AUTH_MODE=sso

# Y to use internal LDAP for authentication, N to use external IDP
SSO_LOCAL_LDAP=y

MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CSRF_SECRET=secret
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

SSO প্রপার্টির ডিস্ট্রিবিউশন

Apigee SSO প্রপার্টি নিম্নলিখিত কনফিগারেশন ফাইল জুড়ে ডিস্ট্রিবিউট করা হয়:

  • /opt/silent.conf (বা আপনার কাস্টম কনফিগারেশন ফাইল): SSO এবং New Edge UI-এর জন্য বেস কনফিগারেশন প্রপার্টি থাকে।
  • /opt/apigee/customer/application/openldap.properties: SAML এবং HTTPS-এর মতো ঐচ্ছিক ফিচারের জন্য অতিরিক্ত SSO কনফিগারেশন প্রপার্টি থাকে।

apigee-openldap কম্পোনেন্টের setup-sso স্ক্রিপ্ট উপরের দুটি ফাইল থেকেই ভেরিয়েবল পার্স করে। আপনার ব্যবহারের কেস অনুযায়ী, আপনাকে কনফিগারেশন ফাইলে প্রাসঙ্গিক প্রপার্টি কনফিগার করতে হবে।

আপনার পরিবেশের উপর নির্ভর করে নিম্নলিখিত ধাপগুলি ঐচ্ছিক:

Postgres-এ SSO ডেটাবেস তৈরি করুন

যে নোডে apigee-postgresql চলছে (প্রাইমারি-স্ট্যান্ডবাই সেট-আপে মাস্টার নোড), SSO-এর জন্য একটি ডেটাবেস তৈরি করুন:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-sso-db

OpenLDAP-তে SSO কনফিগারেশন প্রয়োগ করা

Apigee SSO ডিরেক্টরি কম্পোনেন্টে এম্বেড করা থাকে বলে আপনাকে স্ট্যান্ডঅ্যালোন প্যাকেজ ইনস্টল করতে হয় না। আপনি OpenLDAP নোডে কনফিগারেশন ফাইল প্রয়োগ করেন।

Apigee SSO চালু ও শুরু করতে:
  1. apigee-openldap হোস্টিং নোডে লগ-ইন করুন।
  2. আপনার কনফিগারেশন ফাইল পাস করে setup-sso কমান্ড এক্সিকিউট করুন:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f /opt/silent.conf

নতুন Edge UI কনফিগার করুন

Apigee SSO চালু হয়ে গেলে, আপনাকে অবশ্যই এটির সাথে যোগাযোগ করার জন্য New Edge UI কনফিগার করতে হবে।

আপনি New Edge UI-তে এক্সটার্নাল IDP চালু করার পরে, New Edge UI ম্যানেজমেন্ট সার্ভারের সাথে কানেক্ট করার জন্য OIDC/OAuth2 ব্যবহার করে। New Edge UI এবং Edge Management Server-এর মধ্যে টোকেনের মেয়াদ শেষ হয়ে যাওয়া নিয়ে আপনাকে চিন্তা করতে হবে না। মেয়াদ শেষ হয়ে যাওয়া টোকেন অটোমেটিক রিফ্রেশ করা হয়।

  1. নতুন Edge UI হোস্ট করা নোডে লগ-ইন করুন।
  2. এই নোডে আপনার /opt/silent.conf ফাইল উপলভ্য আছে কিনা তা নিশ্চিত করুন।
  3. setup স্ক্রিপ্ট ব্যবহার করে কনফিগারেশন প্রয়োগ করুন:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f /opt/silent.conf