টোকেন তৈরি করার প্রসেস অটোমেট করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

Edge API-এর সাথে SAML ব্যবহার করার সময়, SAML অ্যাসারশন থেকে OAuth2 অ্যাক্সেস ও রিফ্রেশ টোকেন পাওয়ার জন্য আপনি যে প্রসেস ব্যবহার করেন, তাকে পাসকোড ফ্লো বলা হয়। পাসকোড ফ্লোতে, আপনি একটি ব্রাউজার ব্যবহার করে একবার ব্যবহারযোগ্য পাসকোড পান যা আপনি OAuth2 টোকেন পেতে ব্যবহার করেন।

তবে, আপনার এনভায়রনমেন্ট সাধারণ ডেভেলপমেন্ট টাস্কের জন্য অটোমেশন সাপোর্ট করতে পারে, যেমন টেস্ট অটোমেশন বা কন্টিনিউয়াস ইন্টিগ্রেশন/কন্টিনিউয়াস ডিপ্লয়মেন্ট (CI/CD)। SAML চালু করা থাকলে, এইসব টাস্ক অটোমেট করার জন্য, ব্রাউজার থেকে পাসকোড কপি/পেস্ট না করেই OAuth2 টোকেন পাওয়ার ও রিফ্রেশ করার একটি উপায় আপনার প্রয়োজন।

মেশিন ব্যবহারকারী সম্পর্কে

আপনার SAML চালু থাকা প্রতিষ্ঠানে Apigee Edge মেশিন ব্যবহারকারীদের জন্য কাজ করে। মেশিন ব্যবহারকারীদের শুধুমাত্র অটোমেশনের জন্য ব্যবহার করা হয় এবং কোনও মানুষ সরাসরি তাদের অ্যাক্সেস করেন না।

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

টোকেন তৈরি করার প্রসেস অটোমেট করার ধাপ

টোকেন তৈরি করার প্রসেস অটোমেট করতে:

ধাপ বিবরণ
1 আপনার SAML আইডেন্টিটি জোনে মেশিন ব্যবহারকারী তৈরি করুন
2 আপনার Edge প্রতিষ্ঠানে মেশিন ব্যবহারকারীকে প্রয়োজনীয় ভূমিকা অ্যাসাইন করুন
3 মেশিন ব্যবহারকারীর OAuth2 টোকেন পান

ভিডিও: মেশিন ব্যবহারকারীর ক্রেডেনশিয়াল ব্যবহার করে কীভাবে Apigee Edge API-তে অ্যাক্সেস অটোমেট করা যায় সেই সম্পর্কে জানতে একটি ছোট ভিডিও দেখুন।

SAML আইডেন্টিটি জোনের জন্য মেশিন ব্যবহারকারী ম্যানেজ করা

মেশিন ব্যবহারকারীর অ্যাকাউন্ট তৈরি ও ম্যানেজ করার জন্য Apigee মেশিন ব্যবহারকারী ম্যানেজমেন্ট কমান্ড-লাইন ইন্টারফেস (CLI) প্রদান করে। মেশিন ব্যবহারকারী ম্যানেজমেন্ট CLI ব্যবহার করার ধাপগুলি নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

CLI ব্যবহার করা

মেশিন ব্যবহারকারী ম্যানেজমেন্ট CLI ব্যবহার করতে, প্রথমে নিম্নলিখিত ফাইলটি ডাউনলোড করে আনটার করুন: usermgmt.tar.gz(১)

CLI কল করার ফর্ম্যাট নিচে দেওয়া হল:

usermgmt_platform [command] [flags]

নিচের সারণীতে, কাজ করে এমন প্ল্যাটফর্ম এবং মেশিন ব্যবহারকারী ম্যানেজমেন্ট CLI কল করার জন্য সংশ্লিষ্ট কমান্ডের সংক্ষিপ্তসার দেওয়া হল। (এক্সিকিউটেবল ফাইলগুলি usermgmt ডিরেক্টরিতে আছে।)

প্ল্যাটফর্ম ৩২-বিট ৬৪-বিট
Linux usermgmt_linux_386 usermgmt_linux_amd64
Mac usermgmt_darwin_386 usermgmt_darwin_amd64
Windows usermgmt_windows_386 usermgmt_windows_amd64

নিচের টেবিলে উল্লেখ করা কমান্ড নির্দিষ্ট করা যেতে পারে।

কমান্ড আরও তথ্য
create পরিচয় জোনে মেশিন ব্যবহারকারী তৈরি করা
delete পরিচয় জোনে মেশিন ব্যবহারকারীকে মুছে দেওয়া
help CLI ব্যবহার করে সহায়তা পান
list কোনও আইডেন্টিটি জোনে সব মেশিন ব্যবহারকারীদের তালিকা তৈরি করা
reset কোনও আইডেন্টিটি জোনে মেশিন ব্যবহারকারীর পাসওয়ার্ড রিসেট করা

বিকল্প হিসেবে, নির্দিষ্ট কমান্ডের ব্যাপারে সহায়তা দেখতে, আপনি নিম্নলিখিত ফ্ল্যাগগুলির মধ্যে একটি পাস করতে পারেন: -h বা --help

CLI-তে সাইন-ইন করুন

২৪ ঘণ্টার মধ্যে প্রথমবার CLI রান করার সময়, আপনাকে zoneadmin অ্যাকাউন্টের ক্রেডেনশিয়াল লিখতে বলা হবে।

Enter your Apigee credentials
Username: zoneadmin-username
Password: zoneadmin-password
If your user is opted with MFA, enter MFA code. Otherwise press enter to skip.
MFA: mfa-code_or_enter_to_skip

মেশিন ব্যবহারকারী ম্যানেজমেন্ট CLI আপনার লোকাল মেশিনে একটি অ্যাক্সেস টোকেন স্টোর করে, যাতে আপনাকে ২৪ ঘণ্টার মধ্যে একবারই সাইন-ইন করতে হয়।

CLI ব্যবহার করে সহায়তা পান

usermgmt_platform help কমান্ড ব্যবহার করে CLI ব্যবহার সংক্রান্ত তথ্য দেখুন। কোন কোন প্ল্যাটফর্মে কাজ করে তার তালিকা দেখতে CLI ব্যবহার করুন বিকল্প দেখুন।

usermgmt_platform help

সহায়তা সংক্রান্ত নিম্নলিখিত তথ্য দেখানো হয়:

A command-line interface (CLI) to manage machine user accounts to automate
Apigee identity zone management. Use the CLI to create, list, delete,
and reset the password for machine users.

Usage:
  usermgmt [flags]
  usermgmt [command]

Available Commands:
  create  Creates a machine users in an identity zone.
  delete  Deletes a machine users in an identity zone.
  help    Help about any command
  list    Lists the machine users in an identity zone.
  reset   Resets the password for a machine user in an identity zone.

Flags:
  -h, --help               help for usermgmt

Use "usermgmt [command] --help" for more information about a command.

কমান্ড লাইনে কমান্ড ও -h বা --help ফ্ল্যাগ, দু'টিই পাস করে কোনও নির্দিষ্ট কমান্ডের ব্যাপারে সহায়তা দেখুন।

যেমন, list কমান্ডের ব্যাপারে সাহায্য পেতে:

usermgmt_platform list -h

সহায়তা সংক্রান্ত নিম্নলিখিত তথ্য দেখানো হয়:

Lists the machine users in an identity zone.

Usage:
  usermgmt list [flags]

Flags:
  -h, --help   help for list

আইডেন্টিটি জোনে মেশিন ব্যবহারকারী তৈরি করা

usermgmt_platform create কমান্ড ব্যবহার করে আইডেন্টিটি জোনে মেশিন ব্যবহারকারী তৈরি করুন। কোন কোন প্ল্যাটফর্মে কাজ করে তার তালিকা দেখতে CLI ব্যবহার করুন বিকল্প দেখুন।

  1. এই কমান্ডটি লিখুন: 
    usermgmt_platform create

    পরিচয় সংক্রান্ত জোনের তালিকা দেখানো হয়:

    myzone1
myzone2
  2. প্রম্পটে জোনের নাম লিখুন: 
    Enter a zone name: myzone1
  3. মেশিন ব্যবহারকারীর জন্য একটি ইউজারনেম লিখুন: 
    Create a Machine User
Username: machineuser1@mycompany.com
  4. মেশিন ব্যবহারকারীর জন্য পাসওয়ার্ড লিখুন। প্রম্পট করা হলে পাসওয়ার্ড আবার লিখুন। 
    Password: password
Re-enter password: password

    ব্যবহারকারী তৈরি করা হয়েছে।

    Created machine user machineuser1@mycompany.com

কোনও আইডেন্টিটি জোনে সব মেশিন ব্যবহারকারীর তালিকা তৈরি করা

usermgmt_platform list কমান্ড ব্যবহার করে কোনও আইডেন্টিটি জোনে সব মেশিন ব্যবহারকারীর তালিকা তৈরি করুন। কোন কোন প্ল্যাটফর্মে কাজ করে তার তালিকা দেখতে CLI ব্যবহার করুন বিকল্প দেখুন।

  1. এই কমান্ডটি লিখুন: 
    usermgmt_platform list
     পরিচয় জোনগুলির তালিকা দেখানো হয়: 
    myzone1
myzone2
  2. প্রম্পটে জোনের নাম লিখুন: 
    Enter a zone name: myzone1

    পরিচয় জোনে মেশিন ব্যবহারকারীদের তালিকা দেখানো হয়:

    Machine users in the zone:
machineuser1@mycompany.com

পরিচয় জোনে মেশিন ব্যবহারকারীর পাসওয়ার্ড রিসেট করা

usermgmt_platform reset কমান্ড ব্যবহার করে কোনও আইডেন্টিটি জোনে মেশিন ব্যবহারকারীর পাসওয়ার্ড রিসেট করুন। কোন কোন প্ল্যাটফর্মে কাজ করে তার তালিকা দেখতে CLI ব্যবহার করুন বিকল্প দেখুন।

  1. এই কমান্ডটি লিখুন: 
    usermgmt_platform reset

    পরিচয় সংক্রান্ত জোনের তালিকা দেখানো হয়:

    myzone1
myzone2
  2. প্রম্পটে জোনের নাম লিখুন: 
    Enter a zone name: myzone1
  3. আপনি যে মেশিন ব্যবহারকারীর পাসওয়ার্ড রিসেট করতে চান তার ইউজারনেম লিখুন: 
    Reset User Password
Enter the username for the machine user
Username: machineuser1@mycompany.com
  4. মেশিন ব্যবহারকারীর জন্য নতুন পাসওয়ার্ড লিখুন। প্রম্পট করা হলে পাসওয়ার্ড আবার লিখুন। 
    Enter the new password: password
Re-enter password: password

    পাসওয়ার্ড রিসেট করা হয়েছে।

    Reset password for machine user machineuser1@mycompany.com

পরিচয় জোনে মেশিন ব্যবহারকারীকে মুছে দেওয়া

usermgmt_platform delete কমান্ড ব্যবহার করে কোনও আইডেন্টিটি জোনে মেশিন ব্যবহারকারীকে মুছে দিন। কোন কোন প্ল্যাটফর্মে কাজ করে তার তালিকা দেখতে CLI ব্যবহার করুন বিকল্প দেখুন।

  1. এই কমান্ডটি লিখুন: 
    usermgmt_platform delete
     পরিচয় জোনগুলির তালিকা দেখানো হয়: 
    myzone1
myzone2
  2. প্রম্পটে জোনের নাম লিখুন: 
    Enter a zone name: myzone1
  3. আপনি যে মেশিন ব্যবহারকারীকে মুছে দিতে চান তার ইউজারনেম লিখুন: 
    Delete User
Enter the username for the machine user
Username: machineuser1@mycompany.com

    মেশিন ব্যবহারকারীকে মুছে দেওয়া হয়েছে।

    Deleted user machineuser1@mycompany.com

আপনার Edge প্রতিষ্ঠানে মেশিন ব্যবহারকারীকে প্রয়োজনীয় ভূমিকা অ্যাসাইন করুন

UI ব্যবহার করে, আপনার SAML চালু Edge সংস্থায় মেশিন ব্যবহারকারীকে যোগ করুন এবং প্রয়োজনীয় ভূমিকা (যেমন, সংস্থার অ্যাডমিনিস্ট্রেটর) অ্যাসাইন করুন, ব্যবহারকারী যোগ করা নিবন্ধে যেভাবে বর্ণনা করা হয়েছে।

মেশিন ব্যবহারকারীর OAuth2 টোকেন পাওয়া

আপনি টোকেন জেনারেশন প্রসেস অটোমেট করতে এবং মেশিন ব্যবহারকারীদের জন্য OAuth2 ও SAML জোনে মেশিন ব্যবহারকারী নিবন্ধে বর্ণিত acurl(১) ও get_token(১) ইউটিলিটি ব্যবহার করে মেশিন ব্যবহারকারীদের জন্য টোকেন ক্যাশিং ম্যানেজ করতে পারবেন।

curl-এর মাধ্যমে মেশিন ব্যবহারকারীর OAuth2 টোকেন ম্যানুয়ালি পেতে:

  1. মেশিন ব্যবহারকারীর ইউজারনেম ও পাসওয়ার্ড এনকোড করতে আপনার পছন্দসই URL এনকোডিং টুল ব্যবহার করুন।

    সতর্কতা: মেশিন ব্যবহারকারীর ক্রেডেনশিয়াল যাতে সুরক্ষিত থাকে তা নিশ্চিত করতে অভ্যন্তরীণ URL এনকোডিং টুল ব্যবহার করুন।

  2. নিচে দেখানো উদাহরণে SAML টোকেন এন্ডপয়েন্ট কল করে প্রাথমিক অ্যাক্সেস ও রিফ্রেশ টোকেন তৈরি করুন: 
    curl -H "Content-Type: application/x-www-form-urlencoded;charset=utf-8" \
  -H "accept: application/json;charset=utf-8" \
  -H "Authorization: Basic ZWRnZWNsaTplZGdlY2xpc2VjcmV0" -X POST \
  https://zoneName.login.apigee.com/oauth/token -s \
  -d 'grant_type=password&username=machineusername&password=machineuserpassword'

    অনুমোদনের জন্য, রিজার্ভ করা OAuth2 ক্লায়েন্ট ক্রেডেনশিয়াল, ZWRnZWNsaTplZGdlY2xpc2VjcmV0, Authorization হেডারে পাস করুন। কলটি stdout-এ অ্যাক্সেস ও রিফ্রেশ টোকেন প্রিন্ট করে।

  3. Bearer হেডার হিসেবে Edge ম্যানেজমেন্ট API কলে অ্যাক্সেস টোকেন পাস করুন: 
    curl -H "Authorization: Bearer ACCESS_TOKEN" \
  https://api.enterprise.apigee.com/v1/organizations/orgName
  4. অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, আপনি SAML টোকেন এন্ডপয়েন্টে রিফ্রেশ টোকেন পাঠিয়ে সেটি রিফ্রেশ করতে পারবেন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
    curl -H "Content-Type:application/x-www-form-urlencoded;charset=utf-8" \
  -H "Accept: application/json;charset=utf-8" \
  -H "Authorization: Basic ZWRnZWNsaTplZGdlY2xpc2VjcmV0" -X POST \
  https://zoneName.login.apigee.com/oauth/token \
  -d 'grant_type=refresh_token&refresh_token=REFRESH_TOKEN'

(১) Copyright 2023 Google LLC
usermgmt, acurl ও get_token টুলগুলিকে "সফ্টওয়্যার" হিসেবে উপলভ্য করা হয়েছে। এগুলি Google Cloud Platform ব্যবহারের ক্ষেত্রে প্রযোজ্য চুক্তি দ্বারা পরিচালিত হয়। এর মধ্যে https://cloud.google.com/terms/service-terms লিঙ্কে উপলভ্য পরিষেবা নির্দিষ্ট শর্তাবলী অন্তর্ভুক্ত।