acurl এবং get_token সম্পর্কে

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

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

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

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

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

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

acurl এবং get_token ইনস্টল করুন

Apigee acurl (1) , get_token (1) এবং একটি ইনস্টল স্ক্রিপ্ট ধারণকারী একটি 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 নিম্নলিখিত সময়কালের সাথে টোকেন তৈরি করে:

  • অ্যাক্সেস টোকেন 12 ঘন্টার মধ্যে মেয়াদ শেষ হয়.
  • রিফ্রেশ টোকেন 30 দিনের মধ্যে মেয়াদ শেষ হয়.

ফলস্বরূপ, একবার আপনি সফলভাবে acurl বা get_token দিয়ে একটি API কল করলে, আপনি 30 দিনের জন্য টোকেন জোড়া ব্যবহার করা চালিয়ে যেতে পারেন। মেয়াদ শেষ হওয়ার পরে, আপনাকে অবশ্যই আপনার শংসাপত্রগুলি পুনরায় প্রবেশ করতে হবে এবং নতুন টোকেন পেতে হবে।

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

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

টার্মিনাল থেকে, আপনার অনুমোদন সার্ভারের শেষ পয়েন্টে SSO_LOGIN_URL পরিবেশ পরিবর্তনশীল সেট করুন। উদাহরণ স্বরূপ:

  • জোন ছাড়া ক্লাউড গ্রাহকদের জন্য: 
    export SSO_LOGIN_URL=https://login.apigee.com
  • জোন সহ ক্লাউড গ্রাহকদের জন্য: 
    export SSO_LOGIN_URL=https://zone_name.login.apigee.com
  • ব্যক্তিগত ক্লাউড গ্রাহকদের জন্য, উপযুক্ত SSO এন্ডপয়েন্টের জন্য আপনার প্রশাসকের সাথে যোগাযোগ করুন।

একটি এককালীন পাসকোড ব্যবহার করুন (SAML এর জন্য প্রয়োজনীয়)

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

একটি এককালীন পাসকোড পেতে:

  1. একটি ব্রাউজারে নিম্নলিখিত URL লিখুন:
    • জোন ছাড়া ক্লাউড গ্রাহকদের জন্য: 
      https://login.apigee.com/passcode
    • জোন সহ ক্লাউড গ্রাহকদের জন্য: 
      https://zone_name.login.apigee.com/passcode
    • ব্যক্তিগত ক্লাউড গ্রাহকদের জন্য, উপযুক্ত SSO এন্ডপয়েন্টের জন্য আপনার প্রশাসকের সাথে যোগাযোগ করুন।
  2. আপনার Apigee অ্যাকাউন্টে লগ ইন করুন.
  3. 6-অক্ষরের পাসকোডটি অনুলিপি করুন।
  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

(1) কপিরাইট 2023 Google LLC
acurl এবং get_token টুলগুলি https://cloud.google.com/terms/service-terms- এ উপলব্ধ পরিষেবা নির্দিষ্ট শর্তাবলী সহ Google ক্লাউড প্ল্যাটফর্মের আপনার ব্যবহার নিয়ন্ত্রণকারী চুক্তির অধীনে "সফ্টওয়্যার" হিসাবে উপলব্ধ করা হয়েছে।