acurl ব্যবহার করে

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

acurl ⁽¹⁾ ইউটিলিটি একটি স্ট্যান্ডার্ড curl কমান্ডের চারপাশে একটি সুবিধার মোড়ক প্রদান করে। acurl :

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

আপনি LDAP এবং SAML ওয়ার্কফ্লো সহ OAuth2 এর সাথে এজ API এন্ডপয়েন্ট কল করতে অ্যাক্সেস টোকেন ব্যবহার করেন।

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

acurl ইনস্টল করুন

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

acurl বাক্য গঠন

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

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

বা

acurl API_URL -p PASSCODE

কোথায়:

যেমন:

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 বিকল্প গ্রহণ করে। উদাহরণস্বরূপ, আপনি শিরোনামগুলি পাস করতে পারেন, HTTP ক্রিয়া নির্দিষ্ট করতে পারেন, একটি বডি যোগ করতে পারেন এবং স্ট্যান্ডার্ড curl বিকল্পগুলি ব্যবহার করে ভার্বোসিটি সক্ষম করতে পারেন:

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 কল ফলাফল প্রদান করে। উপরন্তু, acurl ~/.sso-cli এ অ্যাক্সেস এবং রিফ্রেশ টোকেন উভয়ই সঞ্চয় করে।

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

কার্ল থেকে মাইগ্রেট করুন

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

curl -u username

acurl -u username

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

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

প্রথমবার অ্যাকুরলকে কল করুন

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

নিচের উদাহরণটি গেট অর্গানাইজেশন এন্ডপয়েন্ট ব্যবহার করে একটি প্রতিষ্ঠান সম্পর্কে বিশদ জানতে 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 ইউটিলিটি একটি অ্যাক্সেস টোকেন পায় এবং এটি এজ এপিআই এন্ডপয়েন্টে কলে সন্নিবেশিত করে:

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

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

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

এই অনুরোধটি "আহমিল্টন-ইভাল" সংস্থা সম্পর্কে বিশদ বিবরণ পায়৷ এজ এপিআই এন্ডপয়েন্টের সম্পূর্ণ তালিকার জন্য, এপিজি এজ এপিআই রেফারেন্স দেখুন।

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