আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

এক্সটার্নাল IDP ব্যবহার করার জন্য পোর্টাল কনফিগার করা

Apigee Developer Services পোর্টাল (বা সংক্ষেপে, পোর্টাল) Apigee Edge-এর ক্লায়েন্ট হিসেবে কাজ করে। এর অর্থ হল, পোর্টালটি স্বতন্ত্র সিস্টেম হিসেবে কাজ করে না। পরিবর্তে, পোর্টাল দ্বারা ব্যবহৃত বেশিরভাগ তথ্য আসলে Edge-এ সেভ করা হয়। প্রয়োজন হলে, Edge থেকে তথ্য পেতে বা Edge-এ তথ্য পাঠানোর জন্য পোর্টাল অনুরোধ করে।

পোর্টাল সবসময় একটি Edge সংস্থার সাথে যুক্ত থাকে। আপনি পোর্টাল কনফিগার করার সময়, সংস্থার কোনও অ্যাকাউন্টের জন্য প্রাথমিক যাচাইকরণের ক্রেডেনশিয়াল (ইউজারনেম ও পাসওয়ার্ড) নির্দিষ্ট করতে পারবেন যা পোর্টাল Edge-এর সাথে যোগাযোগ করার জন্য ব্যবহার করে।

Edge যাচাইকরণের জন্য SAML বা LDAP-এর মতো এক্সটার্নাল IDP চালু করার বিকল্প বেছে নিলে, Edge-এ অনুরোধ করার সময় সেই যাচাইকরণ ব্যবহার করার জন্য আপনি পোর্টাল কনফিগার করতে পারবেন। এক্সটার্নাল IDP ব্যবহার করার জন্য পোর্টাল কনফিগার করলে Edge সংগঠনে অটোমেটিক একটি নতুন মেশিন ব্যবহারকারী অ্যাকাউন্ট তৈরি হয় যা পোর্টাল Edge-এ অনুরোধ করার জন্য ব্যবহার করে। মেশিন ব্যবহারকারী সম্পর্কে আরও জানতে, দেখুন এক্সটার্নাল IDP-র জন্য টাস্ক অটোমেট করা।

পোর্টালের জন্য এক্সটার্নাল IDP কাজ করার জন্য Edge ম্যানেজমেন্ট সার্ভার নোডে Apigee SSO মডিউল আগে থেকেই ইনস্টল ও কনফিগার করা থাকতে হবে। পোর্টালের জন্য এক্সটার্নাল IDP চালু করার সাধারণ প্রসেস নিচে দেওয়া হল:

Apigee SSO মডিউল ইনস্টল করুন, যেমনটি হাই অ্যাভেলিবিলিটির জন্য Apigee SSO ইনস্টল করুন-এ বর্ণনা করা হয়েছে।
মনে রাখবেন: পোর্টাল ইনস্টল করার জন্য Edge-এ বেসিক যাচাইকরণ এখনও চালু থাকতে হবে। আপনি এক্সটার্নাল IDP-এর সাথে পোর্টাল কনফিগার ও পরীক্ষা না করা পর্যন্ত Edge-এ বেসিক যাচাইকরণ বন্ধ করবেন না।
পোর্টাল ইনস্টল করুন এবং আপনার ইনস্টলেশন সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করুন। পোর্টাল ইনস্টল করুন।
এই বিভাগে বর্ণিত পদ্ধতি অনুযায়ী, পোর্টালে SAML বা LDAP কনফিগার করুন।
(ঐচ্ছিক) Edge-এ সাধারণ যাচাইকরণ বন্ধ করুন, যেমন Edge-এ সাধারণ যাচাইকরণ বন্ধ করুন লিঙ্কে বর্ণনা করা হয়েছে।

পোর্টালের জন্য মেশিন ব্যবহারকারী তৈরি করা

কোনও এক্সটার্নাল IDP চালু করা হলে, Edge মেশিন ব্যবহারকারী ব্যবহার করে অটোমেটিক OAuth2 টোকেন তৈরি করা সমর্থন করে। মেশিন ব্যবহারকারীকে পাসকোড উল্লেখ না করেই OAuth2 টোকেন পেতে হবে। এর অর্থ হল, আপনি OAuth2 টোকেন পাওয়ার ও রিফ্রেশ করার প্রসেস সম্পূর্ণভাবে অটোমেট করতে পারবেন।

পোর্টালের জন্য IDP কনফিগারেশন প্রসেস, পোর্টালের সাথে যুক্ত সংস্থায় অটোমেটিক মেশিন ব্যবহারকারী তৈরি করে। তারপর, পোর্টালটি Edge-এর সাথে কানেক্ট করার জন্য এই মেশিন ব্যবহারকারী অ্যাকাউন্টটি ব্যবহার করে। মেশিন ব্যবহারকারী সম্পর্কে আরও জানতে, এক্সটার্নাল IDP-র জন্য টাস্ক অটোমেট করা দেখুন।

পোর্টাল ডেভেলপার অ্যাকাউন্টের যাচাইকরণ সম্পর্কে

আপনি কোনও এক্সটার্নাল IDP ব্যবহার করার জন্য পোর্টাল কনফিগার করলে, Edge-এর সাথে যাচাইকরণের জন্য পোর্টালকে SAML বা LDAP ব্যবহার করার অনুমতি দেন, এর ফলে পোর্টাল Edge-কে অনুরোধ করতে পারে। তবে, পোর্টালটি ডেভেলপার নামের এক ধরনের ব্যবহারকারীকেও সাপোর্ট করে।

ডেভেলপাররা হল সেইসব ব্যবহারকারীর কমিউনিটি যারা আপনার API ব্যবহার করে অ্যাপ তৈরি করে। অ্যাপ ডেভেলপাররা আপনার API সম্পর্কে জানতে, আপনার API ব্যবহার করে এমন অ্যাপ রেজিস্টার করতে, ডেভেলপার কমিউনিটির সাথে ইন্টার‍্যাক্ট করতে এবং ড্যাশবোর্ডে তাদের অ্যাপ ব্যবহারের পরিসংখ্যান সংক্রান্ত তথ্য দেখতে পোর্টাল ব্যবহার করেন।

কোনও ডেভেলপার পোর্টালে লগ-ইন করলে, ডেভেলপারকে যাচাই করা এবং ভূমিকা-ভিত্তিক অনুমতি প্রয়োগ করার দায়িত্ব পোর্টালের থাকে। আপনি পোর্টাল ও Edge-এর মধ্যে IDP যাচাইকরণ চালু করার পরেও ডেভেলপারদের সাথে পোর্টালটি বেসিক যাচাইকরণ ব্যবহার করা চালিয়ে যায়। আরও তথ্যের জন্য, পোর্টাল ও Edge-এর মধ্যে যোগাযোগ করা দেখুন।

এছাড়াও, ডেভেলপারদের যাচাই করার জন্য SAML বা LDAP ব্যবহার করতে পোর্টাল কনফিগার করা সম্ভব। থার্ড-পার্টি Drupal মডিউল ব্যবহার করে SAML চালু করার একটি উদাহরণ পেতে, ডেভেলপার পোর্টালের সাথে SAML-এর মাধ্যমে SSO ইন্টিগ্রেশন লিঙ্ক দেখুন।

পোর্টালে IDP কনফিগারেশন ফাইল

পোর্টালের জন্য এক্সটার্নাল IDP কনফিগার করতে, আপনাকে অবশ্যই একটি কনফিগারেশন ফাইল তৈরি করতে হবে যা পোর্টালের সেটিংসকে সংজ্ঞায়িত করে।

নিচের উদাহরণে IDP কাজ করে এমন একটি পোর্টাল কনফিগারেশন ফাইল দেখানো হয়েছে:

# IP address of Edge Management Server and the node on which the Apigee SSO module is installed.
IP1=22.222.22.222

# URL of Edge management API.
MGMT_URL=http://$IP1:8080/v1

# Organization associated with the portal.
EDGE_ORG=myorg

# Information about the Apigee SSO module (apigee-sso).
# Externally accessible IP or DNS of apigee-sso.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on apigee-sso.
SSO_PUBLIC_URL_SCHEME=http

# SSO admin credentials as set when you installed apigee-sso.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

# Enables or disables external IDP support.
# Default is "n", which disables external IDP support.
# Change it to "y" to enable external IDs support.
DEVPORTAL_SSO_ENABLED=y

# The name of the OAuth2 client used to connect to apigee-sso.
# The default client name is portalcli.
PORTALCLI_SSO_CLIENT_NAME=portalcli
# OAuth client password using uppercase, lowercase, number, and special characters.
PORTALCLI_SSO_CLIENT_SECRET=Abcdefg@1

# Email address and user info for the machine user created in the Edge org specified
# above by EDGE_ORG.
# This account is used by the portal to make requests to Edge.
# Add this email as an org admin before configuring the portal to use an external IDP.
DEVPORTAL_ADMIN_EMAIL=DevPortal_SAML@google.com
DEVPORTAL_ADMIN_FIRSTNAME=DevPortal
DEVPORTAL_ADMIN_LASTNAME=SAMLAdmin
DEVPORTAL_ADMIN_PWD=Abcdefg@1

# If set, the existing portal OAuth client is deleted and a new one is created.
# The default value is "n".
# Set to "y" when you configure the external IDP and change the value of
# any of the PORTALCLI_* properties.
PORTALCLI_SSO_CLIENT_OVERWRITE=y

পোর্টাল থেকে এক্সটার্নাল IDP সহায়তা চালু করতে:

Edge UI-তে, DEVPORTAL_ADMIN_EMAIL-এর মাধ্যমে নির্দিষ্ট করা মেশিন ব্যবহারকারীকে সংস্থা অ্যাডমিনিস্ট্রেটর হিসেবে পোর্টালের সাথে যুক্ত সংস্থার সাথে যোগ করুন।
NOTE: মেশিন ব্যবহারকারী এখনও নেই, তবে পরবর্তী ধাপে অটোমেটিক তৈরি হয়ে যাবে।
পোর্টালে এক্সটার্নাল IDP কনফিগার করতে, নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal configure-sso -f configFile
```
যেখানে configFile হল উপরে বর্ণিত কনফিগারেশন ফাইল।
পোর্টাল অ্যাডমিন হিসেবে পোর্টালে লগ-ইন করুন।
প্রধান Drupal মেনু থেকে, কনফিগারেশন > ডেভেলপার পোর্টাল বিকল্প বেছে নিন। এক্সটার্নাল IDP সেটিংস সহ পোর্টাল কনফিগারেশন স্ক্রিন দেখা যাবে:

মনে রাখবেন: এই ডায়ালগের শীর্ষক ও অন্যান্য দিক SAML নির্দিষ্ট করে, কিন্তু সেটিংস অন্য যেকোনও কাজ করে এমন IDP-তে (যেমন LDAP) প্রযোজ্য হয়।

নিম্নলিখিত বিষয়গুলি মনে রাখবেন:
- এই সংস্থা SAML-চালু বক্সের পাশে টিকচিহ্ন দেওয়া আছে
- Apigee SSO মডিউলের এন্ডপয়েন্ট পূরণ করা আছে
- পোর্টাল OAuth ক্লায়েন্টের জন্য API কী এবং গ্রাহকের গোপনীয়তা ফিল্ড ভরা আছে
- কানেকশন পরীক্ষা করুন বোতামের নিচে কানেকশন সফল হয়েছে মেসেজটি দেখা যাবে।
যেকোনও সময় কানেকশন আবার পরীক্ষা করতে, কানেকশন পরীক্ষা করুন বোতামে ক্লিক করুন।

পরে এইসব ভ্যালু পরিবর্তন করতে, কনফিগারেশন ফাইল আপডেট করুন এবং এই পদ্ধতি আবার প্রয়োগ করুন।

পোর্টাল থেকে এক্সটার্নাল IDP বন্ধ করা

আপনি যদি পোর্টাল ও Edge-এর মধ্যে যোগাযোগের জন্য এক্সটার্নাল IDP বন্ধ করে দেন, তাহলে পোর্টাল আর Edge-কে অনুরোধ করতে পারবে না। ডেভেলপাররা পোর্টালে লগ-ইন করতে পারবেন, তবে প্রোডাক্ট দেখতে বা অ্যাপ তৈরি করতে পারবেন না।

সতর্কতা: আপনি এক্সটার্নাল IDP বন্ধ করে দিলে, আপনাকে অবশ্যই SAML বা LDAP ব্যবহার করার জন্য পোর্টালটি আবার কনফিগার করতে হবে অথবা Edge যদি এখনও সাধারণ যাচাইকরণ কাজ করে এমনভাবে কনফিগার করা থাকে, তাহলে সাধারণ যাচাইকরণ ব্যবহার করে Edge-এর সাথে যোগাযোগ করার জন্য পোর্টালটি কনফিগার করুন।

বেসিক যাচাইকরণ ব্যবহার করা সম্পর্কে আরও জানতে, দেখুন পোর্টাল ও Edge-এর মধ্যে যোগাযোগ করা।

পোর্টাল থেকে এক্সটার্নাল IDP যাচাইকরণ বন্ধ করতে:

এক্সটার্নাল IDP চালু করার জন্য আপনি আগে যে কনফিগারেশন ফাইল ব্যবহার করেছেন সেটি খুলুন।
DEVPORTAL_SSO_ENABLED প্রপার্টির ভ্যালু n হিসেবে সেট করুন, কারণ নিচের উদাহরণে তা দেখানো হয়েছে:
```
DEVPORTAL_SSO_ENABLED=n
```
নিম্নলিখিত কমান্ড প্রয়োগ করে পোর্টাল কনফিগার করুন:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal configure-sso -f configFile
```