acurl ব্যবহার করা

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

acurl(১) ইউটিলিটি একটি স্ট্যান্ডার্ড curl কমান্ডের চারপাশে একটি কনভেনিয়েন্স র‍্যাপার প্রদান করে। acurl:

  • OAuth2 অ্যাক্সেস টোকেনের জন্য আপনার Apigee ক্রেডেনশিয়াল এক্সচেঞ্জ করে।
  • অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে তা শনাক্ত করে এবং নতুন অ্যাক্সেস টোকেন পেতে রিফ্রেশ টোকেন ব্যবহার করে।
  • API অনুরোধের Authorization হেডারে সেই টোকেন পাস করে।

আপনি OAuth2-এর মাধ্যমে Edge API এন্ডপয়েন্ট কল করতে অ্যাক্সেস টোকেন ব্যবহার করেন, এর মধ্যে LDAP এবং SAML ওয়ার্কফ্লো অন্তর্ভুক্ত।

Edge API অ্যাক্সেস করার জন্য আপনি OAuth2 ব্যবহার করলে, কিন্তু acurl ব্যবহার না করলে, আপনাকে অবশ্যই একটি অ্যাক্সেস টোকেন পেতে হবে এবং সেটি API অনুরোধের হেডারে নিজে থেকেই যোগ করতে হবে। অ্যাক্সেস টোকেন পাওয়ার একটি উপায় হল get_token ইউটিলিটি ব্যবহার করা।

acurl ইনস্টল করা

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

acurl সিনট্যাক্স

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

acurl API_URL -u USERNAME:PASSWORD [-m MFACODE]

অথবা

acurl API_URL -p PASSCODE

যেখানে:

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

যেমন:

acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com -p 424242
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com:mypassw0rd
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com:mypassw0rd -m 123456

উপরে দেখানো বিকল্পগুলি ছাড়াও, acurl সব curl বিকল্প গ্রহণ করে। যেমন, আপনি স্ট্যান্ডার্ড curl বিকল্প ব্যবহার করে হেডার পাস করতে, HTTP ক্রিয়া নির্দিষ্ট করতে, বডি যোগ করতে এবং ভার্বোসিটি চালু করতে পারবেন:

Option acurl meaning curl meaning
-u username username
-মি MFA code max time (পূর্ণ নাম ব্যবহার করতে হবে --max-time)
-p passcode proxy tunnel (পূর্ণ নাম ব্যবহার করতে হবে --proxytunnel)
-v verbose verbose
-h help help (পূর্ণ নাম ব্যবহার করতে হবে --help) 
acurl -v -X POST -H 'Content-Type: application/json' \
    https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval/apiproducts/myproduct/attributes/attr \
    -u ahamilton@apigee.com -d '{"value":42}'

সফল acurl কলের মাধ্যমে আপনি যে Edge API এন্ডপয়েন্ট কল করেছেন তার ভিত্তিতে ফলাফল রিটার্ন করা হয়। এছাড়াও, acurl অ্যাক্সেস ও রিফ্রেশ টোকেন দুটিই ~/.sso-cli-এ সেভ করে।

অ্যাক্সেস টোকেন ও রিফ্রেশ টোকেন, দুটিই শেষ না হয়ে যাওয়া পর্যন্ত আপনি ক্রেডেনশিয়াল (পাসওয়ার্ড ও ঐচ্ছিক MFA বা পাসকোড) না লিখে কল করা চালিয়ে যেতে পারবেন। টোকেনের মেয়াদ শেষ হওয়া বিভাগে এই বিষয়ে বিস্তারিত বলা আছে।

curl থেকে মাইগ্রেট করা

আপনি curl ব্যবহার করলে, acurl ইউটিলিটিতে মাইগ্রেট করা খুব সহজ এবং ম্যানুয়ালি ক্রেডেনশিয়াল এনকোড করার প্রয়োজন হয় না। ইউটিলিটি ডাউনলোড ও ইনস্টল করার পরে, আপনি এগুলি পরিবর্তন করতে পারবেন: 

curl -u username
 এগুলি সহ: 
acurl -u username

acurl ইউটিলিটি আপনার ক্রেডেনশিয়াল এনকোড করবে এবং নতুন টোকেন পেয়ার পাওয়ার জন্য প্রয়োজনীয় অতিরিক্ত ক্রেডেনশিয়ালের জন্য আপনাকে মাঝে মাঝে প্রম্পট করবে।

মেশিন ব্যবহারকারীদের জন্য acurl ইউটিলিটি curl প্রতিস্থাপন করতেও ব্যবহার করা যেতে পারে। আরও তথ্যের জন্য, মেশিন ব্যবহারকারীদের জন্য OAuth2 এবং SAML জোনে মেশিন ব্যবহারকারী দেখুন।

প্রথমবার acurl-এ কল করা

acurl-এর মাধ্যমে প্রথমবার API কল করার সময়, আপনাকে নিজের Apigee ক্রেডেনশিয়াল (আপনার Apigee অ্যাকাউন্টের ইউজারনেম ও পাসওয়ার্ড অথবা একটি পাসকোড) দিতে হবে যাতে acurl সেগুলিকে অ্যাক্সেস টোকেন ও রিফ্রেশ টোকেনের সাথে অদল-বদল করতে পারে।

Get organization এন্ডপয়েন্ট ব্যবহার করে কোনও সংস্থা সম্পর্কে বিবরণ পেতে acurl সহ প্রাথমিক কলের উদাহরণ নিচে দেওয়া হল:

acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval \
  -u ahamilton@apigee.com
Enter the password for user 'ahamilton@apigee.com':
[hidden input]
Enter the six-digit code (no spaces) if 'ahamilton@apigee.com' is MFA-enabled or press ENTER:
1a2b3c
{
  "createdAt" : 1491854501264,
  "createdBy" : "noreply_iops@apigee.com",
  "displayName" : "ahamilton",
  "environments" : [ "prod", "test" ],
  "lastModifiedAt" : 1491854501264,
  "lastModifiedBy" : "noreply_iops@apigee.com",
  "name" : "ahamilton",
  "properties" : {
    "property" : [ {
      "name" : "features.isSmbOrganization",
      "value" : "false"
    }, {
      "name" : "features.isCpsEnabled",
      "value" : "true"
    } ]
  },
  "type" : "trial"
}

acurl ইউটিলিটি একটি অ্যাক্সেস টোকেন পায় এবং এটি Edge API এন্ডপয়েন্টে কলের মধ্যে ইনসার্ট করে:

curl -H "Authorization: Bearer oauth2_access_token" ...

অ্যাক্সেস টোকেন ~/.sso-cli-এ লোকালি স্টোর করা হয় এবং পরবর্তী কলের জন্য ব্যবহার করা হয়।

অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, acurl অটোমেটিক রিফ্রেশ টোকেন ব্যবহার করে নতুন অ্যাক্সেস টোকেন পায়। রিফ্রেশ টোকেনের মেয়াদ শেষ হয়ে গেলে, acurl আপনাকে Apigee ক্রেডেনশিয়াল দেওয়ার জন্য প্রম্পট করবে।

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

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