acurl ব্যবহার করে

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

acurl (1) ইউটিলিটিটি স্ট্যান্ডার্ড curl কমান্ডের একটি সুবিধাজনক র‍্যাপার প্রদান করে। acurl :

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

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

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

একুর্ল ইনস্টল করুন

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

acurl সিনট্যাক্স

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

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

অথবা

acurl API_URL -p PASSCODE

কোথায়:

বিকল্প প্রয়োজন? বর্ণনা
API_URL প্রয়োজনীয় Apigee Edge API এন্ডপয়েন্ট। এন্ডপয়েন্টগুলির সম্পূর্ণ তালিকার জন্য, Apigee Edge API Reference দেখুন।
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 ভার্ব নির্দিষ্ট করতে, বডি যোগ করতে এবং ভার্বোসিটি সক্রিয় করতে পারেন:

বিকল্প acurl meaning curl meaning
-u username username
-m MFA code max time (অবশ্যই পূর্ণাঙ্গ রূপ --max-time ব্যবহার করতে হবে)
-পি 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 তে সংরক্ষণ করে।

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

কার্ল থেকে স্থানান্তরিত হন

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

curl -u username
 সাথে:
acurl -u username

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

মেশিন ব্যবহারকারীদের জন্য curl পরিবর্তে acurl ইউটিলিটিটিও ব্যবহার করা যেতে পারে। আরও তথ্যের জন্য, `OAuth2 for machine users` এবং `Machine users in SAML zones` দেখুন।

প্রথমবারের জন্য 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 Reference দেখুন।

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