Edge for Private Cloud v. 4.17.09
ডেভেলপার পরিষেবা পোর্টাল Apigee Edge-এর ক্লায়েন্ট হিসেবে কাজ করে। এর অর্থ হল, পোর্টালটি স্বতন্ত্র সিস্টেম হিসেবে কাজ করে না। পরিবর্তে, পোর্টাল দ্বারা ব্যবহৃত বেশিরভাগ তথ্য আসলে Edge-এ স্টোর করা হয়। প্রয়োজন হলে, পোর্টাল Edge থেকে তথ্য সংগ্রহ করার জন্য অনুরোধ করে অথবা Edge-এ তথ্য পাঠায়।
পোর্টালটি সবসময় একটিমাত্র Edge সংস্থার সাথে যুক্ত থাকে। আপনি পোর্টাল কনফিগার করার সময়, প্রতিষ্ঠানের কোনও অ্যাকাউন্টের জন্য প্রাথমিক যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল (ইউজারনেম ও পাসওয়ার্ড) নির্দিষ্ট করতে পারেন, যা পোর্টাল Edge-এর সাথে যোগাযোগ করার জন্য ব্যবহার করে।
আপনি Edge যাচাইকরণের জন্য SAML চালু করার বিকল্প বেছে নিলে, Edge-এ অনুরোধ করার সময় SAML যাচাইকরণ ব্যবহার করার জন্য পোর্টাল কনফিগার করতে পারবেন। SAML ব্যবহার করার জন্য পোর্টাল কনফিগার করলে Edge সংস্থায় অটোমেটিক একটি নতুন মেশিন ব্যবহারকারী অ্যাকাউন্ট তৈরি হয় যা পোর্টাল তারপর Edge-এ অনুরোধ করার জন্য ব্যবহার করে। মেশিন ব্যবহারকারী সম্পর্কে আরও জানতে, অটোমেটিক টাস্কের সাথে SAML ব্যবহার করা দেখুন।
পোর্টালের জন্য SAML সাপোর্ট পেতে হলে, আপনাকে আগে থেকেই Edge SSO মডিউল ইনস্টল ও কনফিগার করতে হবে Edge ম্যানেজমেন্ট সার্ভার নোডে। পোর্টালের জন্য SAML চালু করার সাধারণ প্রসেস হল:
- Edge-এর জন্য SAML ইনস্টল ও কনফিগার করা-তে যেভাবে বলা হয়েছে সেইভাবে Edge-এ SAML কনফিগার করুন। মনে রাখবেন: পোর্টাল ইনস্টল করার জন্য Edge-এ এখনও বেসিক অথেন্টিকেশন চালু থাকতে হবে। SAML ব্যবহার করার জন্য পোর্টাল কনফিগার না করা পর্যন্ত Edge-এ বেসিক অথেন্টিকেশন বন্ধ করবেন না।
- পোর্টাল ইনস্টল করুন এবং আপনার ইনস্টলেশন সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করুন। প্রাইভেট ক্লাউড ডেভেলপার পরিষেবা পোর্টালের জন্য Edge ইনস্টল করা দেখুন।
- পোর্টালে SAML কনফিগার করুন।
- আপনি এখন Edge-এ বেসিক অথেন্টিকেশন বন্ধ করতে পারবেন।
পোর্টালের জন্য মেশিন ব্যবহারকারী তৈরি করা হচ্ছে
SAML চালু করা থাকলে, Edge মেশিন ব্যবহারকারী-এর মাধ্যমে অটোমেটিক OAuth2 টোকেন জেনারেশন প্রসেসকে সাপোর্ট করে। কোনও মেশিন ব্যবহারকারী পাসকোড উল্লেখ না করেই OAuth2 টোকেন পেতে পারেন। এর অর্থ হল, আপনি OAuth2 টোকেন পাওয়া ও রিফ্রেশ করার প্রসেস সম্পূর্ণভাবে অটোমেট করতে পারবেন।
পোর্টালের জন্য SAML কনফিগারেশন প্রসেস, পোর্টালের সাথে যুক্ত সংস্থায় অটোমেটিক একটি মেশিন ব্যবহারকারী তৈরি করে। পোর্টালটি তখন এই মেশিন ব্যবহারকারীর অ্যাকাউন্ট ব্যবহার করে Edge-এর সাথে কানেক্ট করে। মেশিন ব্যবহারকারী সম্পর্কে আরও জানতে, অটোমেটিক টাস্কের সাথে SAML ব্যবহার করা দেখুন।
পোর্টাল ডেভেলপার অ্যাকাউন্টের জন্য যাচাইকরণ সম্পর্কে
SAML ব্যবহার করার জন্য পোর্টাল কনফিগার করলে, আপনি পোর্টালকে Edge-এর সাথে যাচাইকরণের জন্য SAML ব্যবহার করার অনুমতি দেন যাতে পোর্টাল Edge-এ অনুরোধ করতে পারে। তবে, পোর্টালে ডেভেলপার নামে এক ধরনের ব্যবহারকারীও কাজ করতে পারেন।
আপনার API ব্যবহার করে অ্যাপ তৈরি করা ব্যবহারকারীদের কমিউনিটি ডেভেলপাররা তৈরি করেন। অ্যাপ ডেভেলপাররা আপনার API সম্পর্কে জানতে, আপনার API ব্যবহার করে এমন অ্যাপ রেজিস্টার করতে, ডেভেলপার কমিউনিটির সাথে ইন্টার্যাক্ট করতে এবং ড্যাশবোর্ডে তাদের অ্যাপ ব্যবহারের পরিসংখ্যানগত তথ্য দেখতে পোর্টাল ব্যবহার করেন।
কোনও ডেভেলপার পোর্টালে লগ-ইন করলে, ডেভেলপারকে যাচাই করা এবং ভূমিকা-ভিত্তিক অনুমতি এনফোর্স করার দায়িত্ব পোর্টালের। পোর্টাল এবং Edge-এর মধ্যে SAML চালু করার পরেও পোর্টাল ডেভেলপারদের সাথে বেসিক যাচাইকরণ ব্যবহার করা চালিয়ে যায়। আরও জানতে, পোর্টাল ও Edge-এর মধ্যে যোগাযোগ করা দেখুন।
ডেভেলপারদের যাচাই করার জন্য SAML ব্যবহার করতে পোর্টাল কনফিগার করাও সম্ভব। থার্ড-পার্টি Drupal মডিউল ব্যবহার করে SAML চালু করার উদাহরণ দেখতে, https://community.apigee.com/articles/29201/sso-integration-via-saml-with-developer-portal.html দেখুন।
Edge-এর সাথে যোগাযোগ করতে পোর্টালে SAML কনফিগার করুন
পোর্টালের জন্য SAML কনফিগার করতে, পোর্টাল কনফিগার করার জন্য আপনাকে অবশ্যই একটি কনফিগারেশন ফাইল তৈরি করতে হবে:
# IP address of Edge Management Server and apigee-sso node. IP1=22.222.22.222 # URL of Edge management API. MGMT_URL=http://$IP1:8080/v1 # Org associated with the portal. EDGE_ORG=myorg # Information about 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 # Default is "n" to disable SAML support. DEVPORTAL_SSO_ENABLED=y # The name of the OAuth 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 chars. 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 SAML. 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 new one is created. # The default value is "n". # Set to "y" when you configure SAML and change the value of # any of the PORTALCLI_* properties. PORTALCLI_SSO_CLIENT_OVERWRITE=y
পোর্টালে SAML সহায়তা চালু করতে:
- Edge UI-তে, DEVPORTAL_ADMIN_EMAIL দ্বারা নির্দিষ্ট করা মেশিন ব্যবহারকারীকে
প্রতিষ্ঠান অ্যাডমিনিস্ট্রেটর হিসেবে পোর্টালের সাথে যুক্ত প্রতিষ্ঠানে যোগ করুন।
মনে রাখবেন: মেশিন ব্যবহারকারী এখনও নেই তবে পরবর্তী ধাপে অটোমেটিক তৈরি হয়ে যাবে। - পোর্টালে SAML কনফিগার করতে নিম্নলিখিত কমান্ড রান করুন:
> /opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal configure-sso -f samlConfigFile
যেখানে samlConfigFile হল SAML কনফিগারেশন ফাইল। - পোর্টাল অ্যাডমিন হিসেবে পোর্টালে লগ-ইন করুন।
- Drupal-এর প্রধান মেনু থেকে, কনফিগারেশন > Dev Portal বিকল্প বেছে নিন। SAML সেটিংস সহ
পোর্টাল কনফিগারেশন স্ক্রিন দেখা যাবে:
মনে রাখবেন যে এই সংস্থায় SAML চালু আছে চেকবক্সে টিকচিহ্ন দেওয়া আছে, Edge SSO মডিউলের এন্ডপয়েন্ট পূরণ করা আছে, পোর্টাল Oauth ক্লায়েন্টের জন্য API কী এবং কনজিউমার সিক্রেট ফিল্ড পূরণ করা আছে এবং কানেকশন পরীক্ষা করুন বোতামের নিচে কানেকশন সফল হয়েছে মেসেজটি দেখা যাচ্ছে।
- আপনি যেকোনও সময় কানেকশন আবার পরীক্ষা করার জন্য কানেকশন পরীক্ষা করুন বোতামে প্রেস করতে পারেন।
পরে এইসব ভ্যালু পরিবর্তন করতে, কনফিগারেশন ফাইল আপডেট করুন এবং কমান্ড আবার রান করুন।
পোর্টালে SAML বন্ধ করুন
আপনি যদি পোর্টাল এবং Edge-এর মধ্যে যোগাযোগের জন্য SAML বন্ধ করার সিদ্ধান্ত নেন, তাহলে পোর্টালটি Edge-এ আর অনুরোধ করতে পারবে না। ডেভেলপাররা পোর্টালে লগ-ইন করতে পারবেন কিন্তু প্রোডাক্ট দেখতে বা অ্যাপ তৈরি করতে পারবেন না।
সতর্কতা: আপনি SAML বন্ধ করলে, আপনাকে পোর্টালটি আবার কনফিগার করতে হবে SAML ব্যবহার করতে অথবা, Edge যদি এখনও বেসিক প্রমাণীকরণ সমর্থন করার জন্য কনফিগার করা থাকে, তাহলে পোর্টালটি কনফিগার করুন বেসিক প্রমাণীকরণ ব্যবহার করে Edge-এর সাথে যোগাযোগ করতে। বেসিক অথেন্টিকেশন ব্যবহার করার ব্যাপারে আরও জানতে, পোর্টাল ও Edge-এর মধ্যে যোগাযোগ দেখুন।
পোর্টালে SAML বন্ধ করতে:
- SAM কনফিগার করার জন্য আপনি যে কনফিগ ফাইল ব্যবহার করেছেন সেটি এডিট করে এটি সেট করুন:
DEVPORTAL_SSO_ENABLED=n - পোর্টাল কনফিগার করুন:
> /opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal configure-sso -f configFile