SAML চালু করার পরে Edge অ্যাডমিন ইউটিলিটি ও API ব্যবহার করা

Edge for Private Cloud v4.18.05

SAML চালু করার পরে কীভাবে Edge সিস্টেম অ্যাডমিন টুল ও কমান্ড চালাতে হয় তা এই বিভাগে বর্ণনা করা হয়েছে। Edge-এ অনেক টাস্কের জন্য সিস্টেম অ্যাডমিনিস্ট্রেটর ক্রেডেনশিয়াল প্রয়োজন, যেমন:

  • প্রতিষ্ঠান এবং পরিবেশ তৈরি করা
  • Edge কম্পোনেন্ট যোগ করা এবং সরানো
  • apigee-adminapi.sh কমান্ড রান করা হচ্ছে

তবে, Edge-এ SAML চালু করার পরে, আপনি সাধারণত বেসিক Auth বন্ধ করে দেন যাতে যাচাইকরণের একমাত্র উপায় SAML IDP-এর মাধ্যমে হয়। তাই, আপনার SAML IDP-তে সিস্টেম অ্যাডমিন অ্যাকাউন্ট যোগ করেছেন কিনা তা নিশ্চিত করতে হবে।

সিস্টেম অ্যাডমিনিস্ট্রেটর হিসেবে Edge ম্যানেজমেন্ট API কল করা

অনেক Edge API কলের জন্য আপনাকে সিস্টেম অ্যাডমিনিস্ট্রেটর ক্রেডেনশিয়াল পাস করতে হয়। Edge ম্যানেজমেন্ট API-এর সাথে SAML ব্যবহার করা-তে Edge ম্যানেজমেন্ট API কল করার সময় কীভাবে টোকেন পাওয়া ও রিফ্রেশ করা যায় সেই সংক্রান্ত নির্দেশাবলী রয়েছে।

SAML যাচাইকরণের সাথে apigee-adminapi.sh ইউটিলিটি ব্যবহার করা

একই Edge কনফিগারেশন টাস্ক পারফর্ম করতে apigee-adminapi.sh ইউটিলিটি ব্যবহার করুন যা আপনি Edge ম্যানেজমেন্ট API-তে কল করে পারফর্ম করেন। apigee-adminapi.sh ইউটিলিটির সুবিধা হল যে এটি:

  • সহজ কমান্ড-লাইন ইন্টারফেস ব্যবহার করুন
  • ট্যাব-ভিত্তিক কমান্ড কমপ্লিশন প্রয়োগ করে
  • সহায়তা ও ব্যবহারের তথ্য প্রদান করে
  • আপনি API ব্যবহার করে দেখতে চাইলে, সংশ্লিষ্ট API কল দেখাতে পারে

আরও জানতে, apigee-ssoadminapi.sh ব্যবহার করা দেখুন।

SAML যাচাইকরণ চালু করার পরে, apigee-adminapi.sh ইউটিলিটিতে সিস্টেম অ্যাডমিন ক্রেডেনশিয়াল পাঠানোর জন্য আপনার কাছে একাধিক উপায় আছে।

আপনি যেকোনও apigee-adminapi.sh কমান্ডের জন্য সব বিকল্প দেখতে পারবেন, যার মধ্যে SAML ক্রেডেনশিয়াল নির্দিষ্ট করার বিকল্পও অন্তর্ভুক্ত, কমান্ডের জন্য "-h" বিকল্প ব্যবহার করে। যেমন:

apigee-adminapi.sh orgs list -h

যেমন, আপনি সিস্টেম অ্যাডমিন ক্রেডেনশিয়াল পাস করতে পারেন:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant \
  --admin adminEmail --oauth-password adminPword

যেখানে:

  • sso-url বিকল্পটি Edge SSO মডিউলের URL নির্দিষ্ট করে। আপনি যদি 9099 এবং HTTP থেকে পোর্ট বা প্রোটোকল পরিবর্তন করে থাকেন, তাহলে সেগুলি পরিবর্তন করুন।
  • oauth-flow হয় passcode অথবা password_grant নির্দিষ্ট করে। এই উদাহরণে, আপনি password_grant উল্লেখ করেছেন।
  • adminEmail হল সিস্টেম অ্যাডমিনের ইমেল আইডি।
  • oauth-password সিস্টেম অ্যাডমিনের পাসওয়ার্ড নির্দিষ্ট করে।

বিকল্প হিসেবে, কমান্ড কল করার সময় আপনি পাসকোড ব্যবহার করতে পারেন:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-passcode passcode

যেখানে:

  • oauth-flow passcode নির্দিষ্ট করে।
  • oauth-passcode, http://edge_sso_IP_DNS:9099/passcode. থেকে পাওয়া পাসকোড নির্দিষ্ট করে

শেষে, কমান্ড কল করার সময় আপনি টোকেন ব্যবহার করতে পারবেন:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-token token

যেখানে:

  • আপনি কীভাবে টোকেন পেয়েছেন তার উপর নির্ভর করে oauth-flow হয় passcode অথবা password_grant নির্দিষ্ট করে। এই উদাহরণে, আপনি passcode উল্লেখ করেছেন কারণ আপনি প্রথমে get_token ব্যবহার করে টোকেন পেয়েছেন। Edge ম্যানেজমেন্ট API-এর সাথে SAML ব্যবহার করা দেখুন।
  • oauh_token-এ টোকেন আছে।

SAML যাচাইকরণের সাথে Edge ইউটিলিটি ব্যবহার করা

অনেক Edge ইউটিলিটির জন্য সিস্টেম অ্যাডমিন ক্রেডেনশিয়াল প্রয়োজন, যেমন:

  • apigee-provision সংস্থা, এনভায়রনমেন্ট ও ভার্চুয়াল হোস্ট তৈরি করতে ব্যবহার করা হয়
  • setup.sh আগে থেকে থাকা সিস্টেমে নোড যোগ করতে ব্যবহার করা হয়
  • অন্য যেকোনও ইউটিলিটি যেখানে আপনাকে কনফিগারেশন ফাইলে সিস্টেম অ্যাডমিন ক্রেডেনশিয়াল উল্লেখ করতে হবে

এইসব ইউটিলিটি ইনপুট হিসেবে একটি কনফিগারেশন ফাইল নেয় যা এই প্রপার্টি ব্যবহার করে সিস্টেম অ্যাডমিনের ক্রেডেনশিয়াল নির্দিষ্ট করে:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW=adminPWord

আপনি পাসওয়ার্ড না দিলে, আপনাকে সেটি দেওয়ার জন্য প্রম্পট করা হবে।

SAML চালু করার পরে, আপনি সিস্টেম অ্যাডমিনের ক্রেডেনশিয়াল নির্দিষ্ট করার জন্য বিভিন্ন প্রপার্টি ব্যবহার করেন। যেমন, আপনি সিস্টেম অ্যাডমিন ক্রেডেনশিয়াল পাস করতে পারেন:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=password_grant
OAUTH_ADMIN_PASSWORD=adminPWord

যেখানে:

  • SSO_LOGIN_URL Edge SSO মডিউলের URL নির্দিষ্ট করে। আপনি যদি 9099 এবং HTTP থেকে পোর্ট বা প্রোটোকল পরিবর্তন করে থাকেন, তাহলে সেগুলি পরিবর্তন করুন।
  • OAUTH_FLOW হয় passcode অথবা password_grant নির্দিষ্ট করে। এই উদাহরণে, আপনি password_grant উল্লেখ করেছেন কারণ আপনি sys অ্যাডমিনের পাসওয়ার্ড পাস করছেন।
  • OAUTH_ADMIN_PASSWORD সিস্টেম অ্যাডমিনের পাসওয়ার্ড নির্দিষ্ট করে।

বিকল্প হিসেবে, আপনি পাসকোড ফ্লোয়ের অংশ হিসেবে ক্রেডেনশিয়াল নির্দিষ্ট করতে নিম্নলিখিত প্রপার্টি ব্যবহার করতে পারেন:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_ADMIN_PASSCODE=passcode

যেখানে:

  • OAUTH_FLOW passcode নির্দিষ্ট করে।
  • OAUTH_ADMIN_PASSCODE, http://edge_sso_IP_DNS:9099/passcode. থেকে পাওয়া পাসকোড নির্দিষ্ট করে

সবশেষে, আপনি টোকেন ব্যবহার করতে পারবেন

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_BEARER_TOKEN=token

যেখানে:

  • আপনি কীভাবে টোকেন পেয়েছেন তার উপর নির্ভর করে OAUTH_FLOW হয় passcode অথবা password_grant নির্দিষ্ট করে। এই উদাহরণে, আপনি passcode উল্লেখ করেছেন কারণ আপনি প্রথমে get_token ব্যবহার করে টোকেন পেয়েছেন। Edge ম্যানেজমেন্ট API-এর সাথে SAML ব্যবহার করা দেখুন।
  • OAUTH_BEARER_TOKEN-এ টোকেন আছে।