get_token ব্যবহার করা

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

get_token(১) ইউটিলিটি আপনাকে Edge API অ্যাক্সেস করার জন্য ব্যবহার করতে পারেন এমন একটি অ্যাক্সেস এবং রিফ্রেশ টোকেনের জন্য আপনার Apigee ক্রেডেনশিয়াল এক্সচেঞ্জ করতে দেয়। OAuth2 ওয়ার্কফ্লোয়ের SAML এবং LDAP প্রয়োগের ক্ষেত্রেও টোকেন ব্যবহার করা যেতে পারে।

get_token আপনাকে এগুলি করতে দেয়:

  • অ্যাক্সেস বা রিফ্রেশ টোকেন পান।
  • ভেরিয়েবল ও কমান্ডে ব্যবহারের জন্য stdout-এ টোকেন প্রিন্ট করুন।
  • আপনার ডিস্কে টোকেন স্টোর করা।

তারপরে, Edge API-তে আপনার অনুরোধে একটি সঠিক টোকেন যোগ করতে পারবেন এবং আপনার টোকেনের মেয়াদ শেষ হয়ে গেলে একটি নতুন টোকেন পাবেন।

পূর্বশর্ত: get_token ব্যবহার করার আগে, আপনাকে অবশ্যই এটি ইনস্টল করতে হবে।

get_token সিনট্যাক্স

get_token ইউটিলিটি নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

get_token -u USERNAME:PASSWORD [-m MFACODE]

অথবা

get_token -p passcode

যেখানে:

এলিমেন্ট প্রয়োজনীয়? বিবরণ
USERNAME ঐচ্ছিক। ইউজারনেম ও পাসওয়ার্ডের সংমিশ্রণ বা পাসকোড প্রয়োজন। আপনার Apigee ইউজারনেম, যেটি সাধারণত আপনার Apigee অ্যাকাউন্টের সাথে যুক্ত ইমেল আইডি। প্রথমবার get_token নম্বরে কল করার সময় আপনাকে অবশ্যই ইউজারনেম বা পাসকোড বলতে হবে। অ্যাক্সেস ও রিফ্রেশ টোকেনের মেয়াদ শেষ না হওয়া পর্যন্ত আপনাকে আবার ইমেল আইডি দিতে হবে না। আপনি যদি একাধিক ব্যবহারকারীর জন্য টোকেন ক্যাশ করেন, তাহলে প্রতিটি কলের মধ্যে আপনাকে অবশ্যই নিজের ইউজারনেম উল্লেখ করতে হবে।
PASSWORD ঐচ্ছিক। ইউজারনেম ও পাসওয়ার্ডের সংমিশ্রণ বা পাসকোড প্রয়োজন। আপনার Apigee অ্যাকাউন্টের পাসওয়ার্ড। আপনি পাসওয়ার্ড বাদ দিলে, প্রথমবার get_token ব্যবহার করার সময় এবং বৈধ রিফ্রেশ টোকেন ছাড়া পরবর্তী যেকোনও কলের সময় আপনাকে এটি লিখতে বলা হবে। আপনি কমান্ডে সরাসরি পাসওয়ার্ড ব্যবহার করতে না চাইলে, পাসওয়ার্ডের পরিবর্তে একবার ব্যবহারের কোড পাসকোড ব্যবহার করতে পারেন।
MFACODE ঐচ্ছিক ছয় সংখ্যার একটি সাময়িক বহু-স্তরীয় যাচাইকরণ (MFA) কোড। আপনি -u ব্যবহার করলে এবং MFA চালু করা থাকলে এই কোডটি প্রয়োজন। আপনি এটি না লিখলে আপনাকে প্রম্পট করা হবে (পাসকোড মোডে না থাকলে)। আপনার MFA চালু করা না থাকলে, অথবা আপনার কাছে স্ক্রিপ্টেড ফ্লো থাকলে, প্রম্পট এড়াতে আপনি -m "" নির্দিষ্ট করতে পারবেন।
PASSCODE ঐচ্ছিক। ইউজারনেম ও পাসওয়ার্ডের সংমিশ্রণ বা পাসকোড প্রয়োজন। ওয়ান-টাইম পাসকোড যা আপনি পাসওয়ার্ডের পরিবর্তে ব্যবহার করতে পারবেন। SAML IDP-এর মাধ্যমে যাচাই করার সময় পাসকোড প্রয়োজন হয় এবং LDAP IDP-এর মাধ্যমে যাচাই করার সময় এটি ব্যবহার করা হতে পারে।

যেমন:

get_token
get_token -u ahamilton@apigee.com:mypassw0rd -m 424242
get_token -p mypass

কল সফল হলে, stdout-এ একটি বৈধ অ্যাক্সেস টোকেন প্রিন্ট করা হয় এবং ~/.sso-cli-এ অ্যাক্সেস ও রিফ্রেশ টোকেন দুটিই সেভ করা হয়। এইসব টোকেনের মেয়াদ শেষ না হওয়া পর্যন্ত আপনি সেগুলি ব্যবহার করতে পারবেন, যেমনটি টোকেনের মেয়াদ শেষ হওয়া নিবন্ধে বর্ণনা করা হয়েছে।

get_token-এ প্রথম কল সফল হওয়ার পরে, টোকেনের মেয়াদ শেষ না হওয়া পর্যন্ত আপনাকে নিজের ক্রেডেনশিয়াল অন্তর্ভুক্ত করতে হবে না।

প্রথমবার get_token কল করা

প্রথম কলে কোনও বিকল্প উল্লেখ না করলে, get_token আপনাকে নিচে উল্লেখ করা বিষয়গুলি সম্পর্কে জিজ্ঞাসা করবে:

  • SAML পরিচয় প্রদানকারীর (IdP) মাধ্যমে যাচাই করা হলে পাসকোড।
  • আপনার ইউজারনেম, পাসওয়ার্ড ও সাময়িক MFA কোড, অন্যথায়।

নিচের উদাহরণে get_token-এ প্রথমবার কল করা হয়েছে এবং যাচাইকরণের জন্য ঐচ্ছিক MFA কোড সহ ইউজারনেম/পাসওয়ার্ডের কম্বিনেশন ব্যবহার করা হয়েছে:

get_token
Enter username:
ahamilton@apigee.com
Enter the password for user 'ahamilton@apigee.com':
[hidden input]
Enter the six-digit code if 'ahamilton@apigee.com' is MFA-enabled or press ENTER:
123456

ey42bGciOiJSUzI1NiJ9.eyJqdGkiOiJhM2YwNjA5ZC1lZTIxLTQ1YjAtOGQyMi04MTQ0MTYxNjNhNTMiLCJzdWIiOiIyZDFl
  <snip>
VlLmNvbSIsInppZCI6InVhYSIsImF1ZCI6WyJlZGdlY2xpIiwic2NpbSIsIm9wZW5pZCIsInBhc3N3b3JkIiwiYXBwcm54242

অনুরোধে আপনার অ্যাক্সেস টোকেন যোগ করা

get_token কল করার পরে, আপনি Edge API-তে করা কলের Authorization হেডার এ অ্যাক্সেস টোকেন পাস করে বিভিন্ন উপায়ে এটি ব্যবহার করতে পারবেন। আপনি এগুলি করতে পারবেন:

  • get_token উত্তরের কন্টেন্ট কপি করে সরাসরি আপনার হেডারে ইনসার্ট করুন: 
    curl https://api.enterprise.apigee.com/v1/organizations/danger4242-eval \
  -H "Authorization: Bearer B42CnTIYPxr...88NI5Q"
  • টোকেন পেতে কমান্ডগুলি একত্রিত করুন এবং এটি হেডারে যোগ করুন: 
    token=$(get_token); curl -H "Authorization: Bearer $token" \
  https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval

    মনে রাখবেন, get_token কমান্ড সাবস্টিটিউশন সিনট্যাক্স $(...) ব্যবহার করে, তাই এটি এক্সিকিউট করা হয়।

  • curl কলের মধ্যে get_token-এ কল করুন: 
    curl -H "Authorization: Bearer $(get_token)" \
  https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval

    মনে রাখবেন, get_token কমান্ড সাবস্টিটিউশন সিনট্যাক্স $(...) ব্যবহার করে, তাই এটি এক্সিকিউট করা হয়।

এইসব নমুনা অনুরোধ "ahamilton-eval" সংস্থা সম্পর্কে বিবরণ পায়। Edge API এন্ডপয়েন্টের সম্পূর্ণ তালিকা দেখতে, Apigee Edge API রেফারেন্স দেখুন।

SAML ও LDAP-এর সাথে get_token ব্যবহার করা

SAML, LDAP বা অন্য কোনও অন্তর্নিহিত IDP-এর সাথে get_token ইউটিলিটি ব্যবহার করা যেতে পারে। get_token একাধিক SSO লগ-ইন URL ও একাধিক অ্যাকাউন্ট ব্যবহার করা যায়। একাধিক অ্যাকাউন্ট আছে এমন কোনও ব্যবহারকারীকে প্রতিটি get_token কলের জন্য ইউজারনেম উল্লেখ করতে বলা হবে।

get_token ক্যাশে মোছা

get_token ক্যাশে মুছে দিতে আপনি নিম্নলিখিত ঐচ্ছিক ফ্ল্যাগ ব্যবহার করতে পারেন:

  • --clear-sso-cache

    SSO_LOGIN_URL-এর জন্য ক্যাশে ডিরেক্টরি মুছে দেয় $HOME/.sso-cli সার্ভারের জন্য যেকোনও ক্যাশে করা অ্যাক্সেস ও রিফ্রেশ টোকেন বাতিল করে দেয়।

  • --clear-all-sso-cache

    $HOME/.sso-cli-এর অধীনে থাকা সব ডিরেক্টরি মুছে দেয় এবং সব ক্যাশে করা টোকেন বাতিল করে দেয়।

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