acurl ও get_token সম্পর্কে

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

OAuth2 অ্যাক্সেস ও রিফ্রেশ টোকেন জেনারেট ও পাস করার জন্য Apigee নিম্নলিখিত কনভেনিয়েন্স ইউটিলিটি প্রদান করে। আপনি Edge API-তে নিজেকে যাচাই করিয়ে নিতে এইসব টোকেন ব্যবহার করেন OAuth (এর মধ্যে SAML ও LDAP ওয়ার্কফ্লো) কল করে:

• acurl^(১): একটি স্ট্যান্ডার্ড curl কমান্ডের চারপাশে একটি কনভেনিয়েন্স র‍্যাপার প্রদান করে। Edge API-তে HTTP অনুরোধ তৈরি করে, get_token থেকে অ্যাক্সেস ও রিফ্রেশ টোকেন পায় এবং Edge API-তে অ্যাক্সেস টোকেন পাস করে।
• get_token^(১): Edge API কল করার জন্য ব্যবহার করতে পারবেন এমন অ্যাক্সেস ও রিফ্রেশ টোকেনের জন্য আপনার Apigee ক্রেডেনশিয়াল এক্সচেঞ্জ করে।

এই দুটি ইউটিলিটিই আপনার Apigee অ্যাকাউন্টের ক্রেডেনশিয়াল (ইউজারনেম ও পাসওয়ার্ড অথবা পাসকোড) OAuth2 টোকেনের বিনিময়ে ব্যবহার করে।

Apigee ইউটিলিটি দ্বারা তৈরি টোকেনগুলি OAuth 2.0 অনুমোদন ফ্রেমওয়ার্ক স্পেসিফিকেশন মেনে চলে।

Edge API-এর জন্য টোকেন পেতে বা যাচাইকরণ সার্ভার অ্যাক্সেস করতে Apigee ইউটিলিটি ব্যবহার করা ঐচ্ছিক। OAuth2 অ্যাক্সেস টোকেন তৈরি করতে এবং Edge API-তে আপনার অনুরোধে সেগুলি পাঠাতে, আপনি নিজের স্কিম প্রয়োগ করতে পারবেন।

acurl ও get_token ইনস্টল করা

Apigee-তে acurl^(১), get_token^(১) এবং ইনস্টল স্ক্রিপ্ট সহ একটি ZIP ফাইল দেওয়া হয়।

acurl ও get_token ইনস্টল করতে:

1. আপনার মেশিনে একটি ইনস্টল ডিরেক্টরি তৈরি করুন অথবা ডিফল্ট usr/local/bin ডিরেক্টরি ব্যবহার করুন।
2. Apigee থেকে ইনস্টলেশন জিপ ফাইল ডাউনলোড করুন:

   curl https://login.apigee.com/resources/scripts/sso-cli/ssocli-bundle.zip -O

3. ডাউনলোড করা ফাইল আনজিপ করুন।
4. ইনস্টল স্ক্রিপ্ট এক্সিকিউট করুন:

   sudo ./install -b /usr/local/bin

   -b বিকল্পটি এক্সিকিউটেবল ফাইলের লোকেশন নির্দিষ্ট করে। আপনি এই বিকল্প নির্দিষ্ট না করলে, ইনস্টল স্ক্রিপ্ট /usr/local/bin-এ ইউটিলিটি ইনস্টল করে।

5. ইনস্টলেশন পরীক্ষা করুন:

       acurl -h
       get_token -h

   ইনস্টল করা হয়ে গেলে, এইসব কমান্ড ইউটিলিটির জন্য সহায়তা টেক্সট রিটার্ন করে।

টোকেনের মেয়াদ শেষ হওয়া

acurl ও get_token নিম্নলিখিত সময়সীমা সহ টোকেন তৈরি করে:

• অ্যাক্সেস টোকেনের মেয়াদ ১২ ঘণ্টা পরে শেষ হয়ে যায়।
• রিফ্রেশ টোকেনের মেয়াদ ৩০ দিন পরে শেষ হয়ে যায়।

এর ফলে, acurl বা get_token-এর মাধ্যমে API কল করা হয়ে গেলে, আপনি ৩০ দিন ধরে টোকেন পেয়ার ব্যবহার করা চালিয়ে যেতে পারবেন। মেয়াদ শেষ হয়ে যাওয়ার পরে, আপনাকে নিজের শংসাপত্র আবার লিখতে হবে এবং নতুন টোকেন পেতে হবে।

SSO এন্ডপয়েন্ট সেট করা

প্রথম কল করার আগে, আপনাকে অবশ্যই acurl এবং get_token-এর সাথে ব্যবহার করতে চান এমন Edge API-এর জন্য অনুমোদন সার্ভার এন্ডপয়েন্ট সেট করতে হবে।

টার্মিনাল থেকে, আপনার অনুমোদনের জন্য SSO_LOGIN_URL এনভায়রনমেন্ট ভেরিয়েবল সেট করুন সার্ভার এন্ডপয়েন্ট। যেমন:

• জোন নেই এমন Cloud গ্রাহকদের জন্য:

  export SSO_LOGIN_URL=https://login.apigee.com

• জোন সহ Cloud গ্রাহকদের জন্য:

  export SSO_LOGIN_URL=https://zone_name.login.apigee.com

• প্রাইভেট ক্লাউড গ্রাহকদের ক্ষেত্রে, উপযুক্ত SSO এন্ডপয়েন্টের জন্য আপনার অ্যাডমিনিস্ট্রেটরের সাথে যোগাযোগ করুন।

একবার ব্যবহারের পাসকোড ব্যবহার করুন (SAML-এর জন্য প্রয়োজন)

acurl বা get_token ব্যবহার করে API কল করার সময়, টোকেন পেয়ার পেতে হলে আপনাকে অবশ্যই ইউটিলিটির কাছে নিজেকে যাচাই করিয়ে নিতে হবে। আপনার Apigee অ্যাকাউন্টের ইউজারনেম, পাসওয়ার্ড ও MFA কোড দিয়ে এটি করতে পারবেন। তবে, আপনি যদি SAML IDP ব্যবহার করেন বা আপনার পাসওয়ার্ড ব্যবহার করতে না চান, তাহলে এর পরিবর্তে ব্যবহার করার জন্য আপনি একটি ওয়ান-টাইম কোড পাসকোড পেতে পারেন।

ওয়ান-টাইম পাসকোড পেতে:

1. ব্রাউজারে নিম্নলিখিত URL লিখুন:
   • জোন নেই এমন Cloud গ্রাহকদের জন্য:

     https://login.apigee.com/passcode

   • জোন সহ Cloud গ্রাহকদের জন্য:

     https://zone_name.login.apigee.com/passcode

   • প্রাইভেট ক্লাউড গ্রাহকদের ক্ষেত্রে, উপযুক্ত SSO এন্ডপয়েন্টের জন্য আপনার অ্যাডমিনিস্ট্রেটরের সাথে যোগাযোগ করুন।
2. আপনার Apigee অ্যাকাউন্টে লগ-ইন করুন।
3. ৬-অক্ষরের পাসকোড কপি করুন।
4. -p বিকল্পের সাথে acurl বা get_token ব্যবহার করুন এবং নিচের উদাহরণে দেখানো পাসকোডটি দিন:

   get_token -p 1a2b3c

আপনার টোকেন দেখা

আপনি acurl বা get_token সফলভাবে এক্সিকিউট করলে, ইউটিলিটি ~/.sso-cli-এ একটি ডেটা ফাইল তৈরি করে যাতে টোকেন ও অন্যান্য মেটাডেটা থাকে।

টোকেন দেখতে, আপনি নিম্নলিখিত কমান্ডের মতো কোনও কমান্ড ব্যবহার করতে পারেন:

get_token -v

এই কমান্ডটি ডিকোড করা টোকেন দাবি দেখায়, যেমন:

Decoded token claims:
 {
  "jti": "8018507e-9f34-4a90-bf97-ff226a06b19b",
  "sub": "858217a9-01a1-4111-8525-75ca555f5d5c",
  "scope": [
    "scim.emails.read",
    "scim.me",
    "openid",
    "password.write",
    "approvals.me",
    "scim.ids.read",
    "oauth.approvals"
          ],
  "client_id": "edgecli",
  "cid": "edgecli",
  "azp": "edgecli",
  "grant_type": "password",
  "user_id": "858217a9-01a1-4111-8525-75ca555f5d5c",
  "origin": "usergrid",
  "user_name": "myusername@google.com",
  "email": "myusername@google.com",
  "auth_time": 1597444772,
  "al": 0,
  "rev_sig": "6271c527",
  "iat": 1597444772,
  "exp": 1597487972,
  "iss": "https://login.apigee.com",
  "zid": "uaa",
  "aud": [
    "edgecli",
    "scim.emails",
    "scim",
    "openid",
    "password",
    "approvals",
    "scim.ids",
    "oauth"
        ]
    }
Current timestamp: 1597444983
Existing access token is still valid

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