এজ মাইক্রোগেটওয়ে সেট আপ এবং কনফিগার করা হচ্ছে

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

এজ মাইক্রোগেটওয়ে v. 3.2.x

ওভারভিউ

এই সেটআপ গাইডের ধাপগুলি সম্পূর্ণ করার পরে, আপনার কাছে একটি সম্পূর্ণ কনফিগার করা, কার্যকরী এজ মাইক্রোগেটওয়ে ইনস্টলেশন থাকবে যা API অনুরোধগুলি প্রক্রিয়া করতে সক্ষম। আপনি এজ মাইক্রোগেটওয়ের মাধ্যমে একটি ব্যাকএন্ড টার্গেটে সুরক্ষিত API কল করে সেটআপ পরীক্ষা করবেন। আপনি মাইক্রোগেটওয়েতে একটি স্পাইক অ্যারেস্ট প্লাগইন যুক্ত করতে শিখবেন।

এই নির্দেশিকাটি এই অংশে বিভক্ত:

পূর্বশর্ত: এজ মাইক্রোগেটওয়ে ইনস্টল করুন

এজ মাইক্রোগেটওয়ে ইনস্টল করার নির্দেশাবলী অনুসরণ করুন। আপনি যখন ইনস্টলেশন সম্পূর্ণ করবেন, আপনি এই টিউটোরিয়ালের ধাপগুলি অনুসরণ করতে প্রস্তুত হবেন।

পার্ট 1: এজ মাইক্রোগেটওয়ে কনফিগার করুন

এই অংশে আপনি Apigee Edge-এর সাথে যোগাযোগের জন্য Edge Microgateway কনফিগার করতে একটি কমান্ড-লাইন ইন্টারফেস (CLI) কমান্ড ব্যবহার করবেন।

Apigee এজ ক্লাউড কনফিগারেশন ধাপ

এপিজি এজ ক্লাউডের সাথে এজ মাইক্রোগেটওয়ে ব্যবহার করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. এজ মাইক্রোগেটওয়ে শুরু করুন (আপনাকে শুধুমাত্র একবার এই পদক্ষেপটি করতে হবে):
    edgemicro init
  2. default.yaml ফাইল নামে একটি কনফিগার ফাইল আপনার হোম ডিরেক্টরিতে .edgemicro নামক একটি সাবডিরেক্টরিতে স্থাপন করা হয়েছিল। এই ফাইলটি বিদ্যমান রয়েছে তা নিশ্চিত করতে এখনই পরীক্ষা করুন: 
    ls ~/.edgemicro
default.yaml

    দ্রষ্টব্য: এজ মাইক্রোগেটওয়ে ডক্সে, আমরা টিল্ড ( ~ ) সহ হোম ডিরেক্টরি উল্লেখ করি, যা একটি UNIX শর্টকাট। আপনি যদি উইন্ডোজে থাকেন, আপনি যদি এমন একটি শেল চালান যা টিল্ডকে সমর্থন করে না, তাহলে আপনাকে হোম ডিরেক্টরিকে উল্লেখ করে এমন কমান্ডগুলিতে টিল্ডের জন্য উপযুক্ত পরিবেশ পরিবর্তনশীল প্রতিস্থাপন করতে হবে। উদাহরণস্বরূপ: %USERPROFILE%/.edgemicro ।

  3. সমস্ত CLI কমান্ডের একটি সাহায্য ফাংশন আছে। এজমিক্রো কনফিগার কমান্ডের জন্য প্রিন্ট সহায়তা:
    edgemicro configure -h
  4. এজ মাইক্রোগেটওয়ে কনফিগার করতে নিম্নলিখিত কমান্ডটি চালান:
    edgemicro configure -o [org] -e [env] -u [username]

    কোথায়:

    • org: আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env: আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • username: আপনার Apigee অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানা।

      দ্রষ্টব্য: কনফিগার কমান্ড অতিরিক্ত পরামিতি অনুমোদন করে। একটি সম্পূর্ণ তালিকার জন্য, এপিজি এজ ক্লাউডের জন্য এজ মাইক্রোগেটওয়ে কনফিগার করা দেখুন।

উদাহরণ

edgemicro configure -o docs -e test -u jdoe@example.com

আউটপুট

./edgemicro configure -o docs -e test -u jdoe@apigee.com
password:
current nodejs version is v12.5.0
current edgemicro version is 3.1.0
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
checking org for existing KVM
error checking for cert. Installing new cert.
creating KVM
adding private_key
adding public_key
configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1

saving configuration information to: $HOME/.edgemicro/docs-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCQ2mJZJGbPPTANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3QwHhcNMTcwOTA3MjA0ODA4WhcNMTcwOTA4MjA0ODA4WjAUMRIwEAYD
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDw
yzmqi5CelqqtTr6IaFe1ssrMXEDnNtkBh95U6F5zHLsNQhJcyNUAO9um6FLMSqSd
fTztXfWUZzDgmbb6sfbx/9cqpvQ8TIjxyIz8xGM9H4legRQmsCQoYGkLjpPE5ZOa
wZrI5IaVm8LY6vbopPFwxgKOQ9bphx6k9Na055DmNyZAOTMD+4I0m/RdsrnZnYih
3DaFj1tXHKZI1jfAt/QOif5Nmk4+JckYwF+9HBysWUbbvj/gnBjVYF2Isb7q7oFD
lPGhwFoIebMqHMWD8lG7+9RJDO9dDV6f1g1/9waIrq1D+MoVXos9VMstNrPp0cKF
Ue+lAkct8tylH+2MosF7AgMBAAEwDQYJKoZIhvcNAQELBQADggEBAJMRdcQh3ayy
csVVT4TYwxV7MKWRfhDRz6X+MM9frB+Z7sI4+ZoZbXKOoZI2hSjmbdLpkNR/m9eJ
+1Uk0JKmpSY7Q+1rRrvcHsWNysGf4z+zDJXYECTrtSnXKBXtb9SJ8JAfoZOQD0lA
zmKuJjQMLTdiYMHOBR6ZWnaKaRvrQwGHcQrheJm4a90XgZF6jcRR8CPrBzkmsbCp
IU/Ux3E17wDGYPxjJs5otyQG8rN/88RGyaSeXK8rjKr9D4KFGJeasXBKmTG2afAr
yfBvS4h6s42FCOR/eLpmMllVoO9up71Fa3EtV+aK+FNNY9uMbgUHeLQE7z9nn06q
PTmvExZLkLQ=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb
  secret: 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47

Apigee প্রাইভেট ক্লাউড কনফিগারেশন ধাপ

এপিজি প্রাইভেট ক্লাউডের সাথে এজ মাইক্রোগেটওয়ে ব্যবহার করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. এজ মাইক্রোগেটওয়ে শুরু করুন (আপনাকে শুধুমাত্র একবার এই পদক্ষেপটি করতে হবে):
    edgemicro init
  2. এজমাইক্রো প্রাইভেট কনফিগার কমান্ডের জন্য সাহায্য তথ্য মুদ্রণ করুন। আপনি যেকোনো এজ মাইক্রোগেটওয়ে সিএলআই কমান্ড বা কমান্ড বিকল্পের জন্য এইভাবে সাহায্য প্রিন্ট করতে পারেন। 
    edgemicro private configure -h
  3. নিম্নলিখিত কমান্ডটি চালান। এটির জন্য আপনার Apigee Edge প্রাইভেট ক্লাউড অ্যাকাউন্ট সম্পর্কে স্ট্যান্ডার্ড তথ্য প্রয়োজন: প্রতিষ্ঠানের নাম, পরিবেশের নাম, ব্যবহারকারীর নাম (ইমেল ঠিকানা), পাসওয়ার্ড, ম্যানেজমেন্ট সার্ভার আইপি এবং রাউটার আইপি। এই কমান্ডটি ব্যবহার করার জন্য আপনাকে অবশ্যই এজ সংস্থার প্রশাসক হতে হবে: 
    edgemicro private configure -o [org] -e [env] -u [username] -r [runtime_url] -m [mgmt_url] -v [virtual_host]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • runtime_url হল আপনার ব্যক্তিগত ক্লাউড উদাহরণের জন্য রানটাইম URL।
    • mgmt_url হল আপনার ব্যক্তিগত ক্লাউড উদাহরণের জন্য ব্যবস্থাপনা সার্ভারের URL।
    • username হল আপনার Apigee অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানা।
    • virtual_host হল ভার্চুয়াল হোস্ট নামের একটি কমা দ্বারা পৃথক করা তালিকা। ডিফল্ট মানগুলি default,secure

উদাহরণ

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.52.106:9001 -m http://192.162.52.106:8080 -v default

অথবা, আপনার যদি myorg-test.mycompany.com এর একটি ভার্চুয়াল হোস্ট উপনাম থাকে, তাহলে আপনি এইরকম একটি কমান্ড ব্যবহার করবেন:

edgemicro private configure -o docs -e test -u jdoe@example.com -r myorg-test.mycompany.com -m http://192.162.52.106:8080 -v default

আউটপুট

delete cache config
checking for previously deployed proxies
configuring edgemicro internal proxy
deploying edgemicro internal proxy
deploying  edgemicro-auth  app
copy auth app into tmp dir
copy config into tmp deer
Give me a minute or two... this can take a while...
App edgemicro-auth added to your org. Now adding resources.

checking org for existing KVM
error checking for cert. Installing new cert.
creating KVM
adding private_key
adding public_key
configuring host http://192.168.52.106:9001 for region dc-1

saving configuration information to: $HOME/.edgemicro/jdoe-test-config.yaml
vault info: 
-----BEGIN CERTIFICATE----- 
MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWsKWBDP9o
Xl96dtgH7xPFRqIU0zI452jkMQ1fPz2mSaGwik245yfBku7olooXKRKTRKOUoXa 
q3Hld/RPxGSsWtiyyYtKex7tuFdq0Knm1EhowdTRGIgjNvudeYMka/XPRXuykhd 
xIDxWj4rdX+4GPx9qT2eTQC5nOAC7XHVL7ys4KqsAiv28vw10u400KstFFS8Qho 
7FaE0bOKLolKKadKyA60ha1XIw/uSTD6ZQFWQ+XM3OaRbXePWXnSZioSxXcZT7L 
hMUKbsRXw/TCvRB51LgNAgMBAAEwDQYJKoZIhvcNAQELBQADgEBAOuR1OmE/W6j 
gRAarJB5EQuTEpI/9Zpg5c5RAGjzLhkazsycn7pal+IymUjCV7D0oIxTVuTM8ZZ 
57kR5hF/C1ZypDN9i+KGP2ovX8WOCCXYtIQECgZPB/L/7/k7BDuKN4vFBvWUe3X 
s2oyjnVWy+ASqsW8gHfj8ekhe22bP240Oqkbyg9SZP9ol1tvJX6+M0thYwcTwAd 
ft929Icey/MOTQC0jB2qm0gnIx/7KInFXfS5KoFRJoGrWDeckr3RdBo2LhnPaeZ 
1gPYIqphZ3HfisF5KlBXoR8oT/Ilym/nq5COlv+3L4tMIk18F7BQZB60SRazifz 
pFkIxepyr/0= 
-----END CERTIFICATE----- 

The following credentials are required to start edge micro 
   key: a3f8f3dfe39158fc3c50b274f0af2234246e0d5f6ea4ad09389b645147151ba3
   secret: 3e9904802fb3c0e8ca408128a11119cf13546d54dac10ace944c097a726a1263

edgemicro configuration complete!

ইনস্টলেশন যাচাই করুন

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

edgemicro verify -o [org] -e [env] -k [key] -s [secret]

কোথায়:

  • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
  • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
  • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
  • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

উদাহরণ 

edgemicro verify -o docs -e test -k 93b01fd21d86331459ae52f624ae9aeb13eb94767ce40a4f621d172cdfb7e8e6 -s c8c755be97cf56c21f8b0156d7132afbd03625bbd85dc34ebfefae4f23fbcb3c

কনফিগারেশন সম্পর্কে

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

এই কনফিগারেশন তথ্য কি জন্য ব্যবহৃত হয়? এই টিউটোরিয়ালের পরবর্তী অংশে আমরা আবিষ্কার করব, যখন এজ মাইক্রোগেটওয়ে শুরু হবে, তখন এটিকে অ্যাপিজি এজ থেকে বিশেষ এজ মাইক্রোগেটওয়ে-সচেতন API প্রক্সিগুলির একটি তালিকা পেতে হবে। এই টিউটোরিয়ালের পরবর্তী অংশে, আপনি একটি মাইক্রোগেটওয়ে-সচেতন প্রক্সি তৈরি করবেন। এজ মাইক্রোগেটওয়ে ক্লায়েন্টদের শুধুমাত্র এই Microgateway-সচেতন API প্রক্সিগুলির দ্বারা ফ্রন্ট করা APIগুলিকে কল করতে সীমাবদ্ধ করে এবং ক্লায়েন্টদের প্রতিটি কলের জন্য একটি বৈধ নিরাপত্তা টোকেন উপস্থাপন করতে হবে (ডিফল্টরূপে)। এই প্রক্সিগুলি সম্পর্কে আরও পড়তে, এজ মাইক্রোগেটওয়ের ওভারভিউতে " এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি সম্পর্কে আপনার যা জানা দরকার " দেখুন৷

একজন এজ ওআরজি প্রশাসক হিসেবে, আপনি জানতে আগ্রহী হবেন যে এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি অন্য যেকোনো প্রক্সির মতো এজ পণ্যগুলিতে যোগ করা যেতে পারে। পণ্য এবং ডেভেলপার অ্যাপ ব্যবহারের মাধ্যমে, আপনি এজ মাইক্রোগেটওয়ের মাধ্যমে কল করা API-তে অ্যাক্সেস নিয়ন্ত্রণ করতে ক্লায়েন্ট-নির্দিষ্ট নিরাপত্তা টোকেন তৈরি করতে পারেন। আবার, জড়িত নিদর্শনগুলি Apigee Edge-এ যেকোন API প্রক্সি, পণ্য এবং বিকাশকারী অ্যাপগুলির সাথে কাজ করার মতো। আপনি যদি পণ্যগুলি পড়তে চান তবে একটি API পণ্য কী দিয়ে শুরু করুন? এজ ডকুমেন্টেশনে।

এরপরে আমরা এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি কীভাবে তৈরি করতে হয় তা নিয়ে চলব এবং এর পরে, আমরা এজ মাইক্রোগেটওয়ে শুরু করব এবং সেটআপ পরীক্ষা করব।

পার্ট 2: Apigee Edge এ সত্তা তৈরি করুন

এই অংশে, আপনি প্রান্তে এই সত্তাগুলি তৈরি করবেন:

  • একটি মাইক্রোগেটওয়ে-সচেতন প্রক্সি - এটি একটি বিশেষ প্রক্সি যা এজ মাইক্রোগেটওয়ে স্টার্টআপের সময় আবিষ্কার করতে পারে। মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলির একটি নামকরণের নিয়ম রয়েছে যা আপনাকে অবশ্যই অনুসরণ করতে হবে: নামটি অবশ্যই edgemicro_ সাথে হতে হবে। যেমন edgemicro_hello বা edgemicro_userinfo । এজ মাইক্রোগেটওয়ে শুরু হলে, এটি এজ থেকে একই এজ সংস্থা এবং পরিবেশ থেকে মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলির একটি তালিকা পুনরুদ্ধার করে যা আপনি এজ মাইক্রোগেটওয়ে শুরু করার সময় নির্দিষ্ট করেছিলেন।

    প্রতিটি মাইক্রোগেটওয়ে-সচেতন প্রক্সির জন্য, এজ মাইক্রোগেটওয়ে প্রক্সির টার্গেট URL এবং এর বেস পাথ পুনরুদ্ধার করে। মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি এজ প্ল্যাটফর্মের একটি প্রক্সির সাথে এজ মাইক্রোগেটওয়ে দ্বারা উত্পন্ন বিশ্লেষণ ডেটা সংযুক্ত করার একটি সুবিধাজনক উপায়ও প্রদান করে। মাইক্রোগেটওয়ে API কলগুলি পরিচালনা করে, এটি অ্যাসিঙ্ক্রোনাসভাবে বিশ্লেষণ ডেটা এজ-এ পুশ করে। অ্যানালিটিক্স ডেটা মাইক্রোগেটওয়ে-সচেতন প্রক্সি নাম(গুলি) এর অধীনে এজ অ্যানালিটিক্স UI-তে প্রদর্শিত হবে, যেমন এটি অন্য কোনো প্রক্সির জন্য দেখায়।
  • একটি পণ্য, বিকাশকারী এবং বিকাশকারী অ্যাপ্লিকেশন - Edge Microgateway OAuth2 অ্যাক্সেস টোকেন বা API কী সুরক্ষা সক্ষম করতে পণ্য, বিকাশকারী এবং বিকাশকারী অ্যাপ্লিকেশনগুলি ব্যবহার করে। এজ মাইক্রোগেটওয়ে শুরু হলে, এটি আপনার Apigee Edge প্রতিষ্ঠান থেকে সমস্ত পণ্য কনফিগারেশন ডাউনলোড করে। এটি API কী বা OAuth2 অ্যাক্সেস টোকেন সহ এজ মাইক্রোগেটওয়ের মাধ্যমে করা API কলগুলি যাচাই করতে এই তথ্য ব্যবহার করে।

1. এজ-এ একটি এজ মাইক্রোগেটওয়ে-সচেতন API প্রক্সি তৈরি করুন

  1. Apigee Edge এ আপনার প্রতিষ্ঠানে লগ ইন করুন।
  2. পাশের নেভিগেশন মেনুতে বিকাশ > API প্রক্সি নির্বাচন করুন।
  3. + প্রক্সি ক্লিক করুন। একটি প্রক্সি তৈরি করুন উইজার্ড আহ্বান করা হয়েছে৷
  4. প্রথম উইজার্ড পৃষ্ঠায়, বিপরীত প্রক্সি (সবচেয়ে সাধারণ) নির্বাচন করুন।
  5. পরবর্তী ক্লিক করুন.
  6. উইজার্ডের বিবরণ পৃষ্ঠায়, নিম্নরূপ কনফিগার করুন। দেখানো হিসাবে ঠিক উইজার্ড পূরণ করতে ভুলবেন না:
    • প্রক্সি নাম: edgemicro_hello
    • প্রক্সি বেস পাথ: /হ্যালো
    • বিদ্যমান API: http://mocktarget.apigee.net/
  7. পরবর্তী ক্লিক করুন.
  8. উইজার্ডের নিরাপত্তা পৃষ্ঠায়, পাস থ্রু (কোনটি নয়) নির্বাচন করুন।
  9. পরবর্তী ক্লিক করুন.
  10. উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, ডিফল্টগুলি গ্রহণ করুন।
  11. পরবর্তী ক্লিক করুন.
  12. উইজার্ডের বিল্ড পৃষ্ঠায়, আপনার প্রক্সি সেটিংস পর্যালোচনা করুন। পরীক্ষা পরিবেশ নির্বাচন করা হয়েছে তা নিশ্চিত করুন।
  13. Build and Deploy এ ক্লিক করুন।

2. একটি পণ্য তৈরি করুন

  1. পাশের নেভিগেশন মেনুতে প্রকাশ > API পণ্য নির্বাচন করুন।
  2. ক্লিক করুন + API পণ্য . পণ্যের বিশদ পৃষ্ঠাটি প্রদর্শিত হবে।
  3. নিম্নরূপ পণ্য বিবরণ পৃষ্ঠাটি পূরণ করুন:
    • নাম: EdgeMicroTestProduct
    • প্রদর্শনের নাম: EdgeMicroTestProduct
    • পরিবেশ: পরীক্ষা এবং পণ্য
    • প্রবেশাধিকার: সর্বজনীন
    • কী অনুমোদনের ধরন: স্বয়ংক্রিয়
  4. রিসোর্সে, +API প্রক্সিতে ক্লিক করুন
  5. edgemicro-auth নির্বাচন করুন
  6. আবার +API প্রক্সিতে ক্লিক করুন।
  7. edgemicro_hello নির্বাচন করুন
  8. + কাস্টম রিসোর্স নির্বাচন করুন
  9. লিখুন /**
  10. আবার + কাস্টম রিসোর্স নির্বাচন করুন।
  11. লিখুন /
  12. Save এ ক্লিক করুন।

3. (ঐচ্ছিক) একটি পরীক্ষা বিকাশকারী তৈরি করুন৷

এই টিউটোরিয়ালের উদ্দেশ্যে, আপনি একটি বিকাশকারী অ্যাপ তৈরি করে পরবর্তী ধাপের জন্য যে কোনো বিদ্যমান বিকাশকারী ব্যবহার করতে পারেন। কিন্তু আপনি যদি চান, এখন একটি পরীক্ষা বিকাশকারী তৈরি করুন:

  1. পাশের নেভিগেশন মেনুতে প্রকাশ > বিকাশকারী নির্বাচন করুন।
  2. + বিকাশকারী ক্লিক করুন।
  3. একটি পরীক্ষা বিকাশকারী তৈরি করতে ডায়ালগটি পূরণ করুন৷

4. একটি ডেভেলপার অ্যাপ তৈরি করুন

আপনি এজ মাইক্রোগেটওয়ের মাধ্যমে সুরক্ষিত API কল করতে এই অ্যাপ থেকে ক্লায়েন্ট শংসাপত্র ব্যবহার করতে যাচ্ছেন:

  1. পাশের নেভিগেশন মেনুতে প্রকাশ > অ্যাপ নির্বাচন করুন।
  2. + অ্যাপে ক্লিক করুন। বিকাশকারী অ্যাপের বিবরণ পৃষ্ঠাটি প্রদর্শিত হবে।
  3. নিম্নলিখিত হিসাবে বিকাশকারী অ্যাপ পৃষ্ঠাটি পূরণ করুন:
    1. নাম: EdgeMicroTestApp
    2. প্রদর্শনের নাম: EdgeMicroTestApp
    3. বিকাশকারী: আপনি যদি একটি পরীক্ষা বিকাশকারী তৈরি করেন তবে এটি নির্বাচন করুন। অথবা, আপনি এই টিউটোরিয়ালের উদ্দেশ্যে যেকোন বিদ্যমান বিকাশকারী ব্যবহার করতে পারেন।
    4. শংসাপত্র:
      1. মেয়াদ শেষ হওয়া নির্বাচন করুন: কখনই না ।
      2. পণ্য + ক্লিক করুন এবং EdgeMicroTestProduct নির্বাচন করুন (আপনার তৈরি পণ্যটি)
  4. Save এ ক্লিক করুন।
  5. আপনি অ্যাপের তালিকা পৃষ্ঠায় ফিরে এসেছেন।
  6. আপনার তৈরি করা অ্যাপটি নির্বাচন করুন, EdgeMicroTestApp ।
  7. কনজিউমার কী এবং কনজিউমার সিক্রেটের পাশে দেখান ক্লিক করুন।

পার্ট 3: এজ মাইক্রোগেটওয়ে পরিচালনা করুন

এখন আপনার কাছে একটি কনফিগার করা এজ মাইক্রোগেটওয়ে এবং অন্তত একটি এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সি রয়েছে, এটি এজ মাইক্রোগেটওয়ে শুরু করার সময়। একটি এজ মাইক্রোগেটওয়ে HTTP সার্ভার আপনার স্থানীয় মেশিনে চলবে এবং আপনি সরাসরি সেই সার্ভারে API কল করবেন।

1. এজ মাইক্রোগেটওয়ে শুরু করুন

এজ মাইক্রোগেটওয়ে শুরু করতে edgemicro start কমান্ডটি ব্যবহার করুন।

  1. আপনি edgemicro কনফিগার কমান্ড চালানোর সময় পূর্বে ফেরত দেওয়া কীগুলি আপনার কাছে আছে তা নিশ্চিত করুন। যে আউটপুট এই মত কিছু দেখায়: 
    You need key and secret while starting edgemicro instance

key: da4778e7c240a5d4585fc559eaba5083328828bc9f3a7f583e8b73e
secret: 3aad7439708b4aeb38ee08e82189921ad00e6fc1ba8a8ae9f929ee2
  2. (ঐচ্ছিক) edgemicro start কমান্ডের জন্য সাহায্য তথ্য মুদ্রণ করুন।
    edgemicro start -h
  3. এজ মাইক্রোগেটওয়ে শুরু করতে, নিম্নলিখিত কমান্ডটি চালান: 
    edgemicro start -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro start -o docs -e test -k 701e70e718ce6dc1880616b3c39177d64a88754d615c7a4e1f78b6181d000723 -s 05c14356e42d136b83dd135cf8a18531ff52d7299134677e30ef4e34ab0cc824

    আউটপুট

    স্টার্ট কমান্ড অ্যাপিজি এজ থেকে অনেক কনফিগারেশন তথ্য পুনরুদ্ধার করে (যা টার্মিনাল উইন্ডোতে স্ক্রোল করে)। আউটপুটে, আপনি মাইক্রোগেটওয়ে-সচেতন প্রক্সি এবং আবিষ্কৃত পণ্যগুলির একটি তালিকা দেখতে পাবেন। আউটপুট শেষে, আপনি এই মত কিছু দেখতে হবে:

    ...

current nodejs version is v12.5.0
current edgemicro version is 3.1.0
info: jwk_public_keys download from null returned 200 undefined
info: jwt_public_key download from https://docs-test.apigee.net/edgemicro-auth/publicKey returned 200 OK
info: products download from https://docs-test.apigee.net/edgemicro-auth/products returned 200 OK
info: config download from https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test returned 200 OK
PROCESS PID : 17991
  4. মাইক্রোগেটওয়ে স্থিতি পরীক্ষা করুন। অন্য টার্মিনাল উইন্ডোতে, একই ডিরেক্টরিতে cd যেখানে আপনি এজ মাইক্রো শুরু করেছিলেন এবং এই কমান্ডটি লিখুন: 
    edgemicro status
current nodejs version is v12.5.0
current edgemicro version is 3.1.0
edgemicro is running with 8 workers

কি হয়েছে?

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

  • আমরা যে পাবলিক কী তৈরি করেছি এবং পূর্বে একটি এনক্রিপ্ট করা কী ভ্যালু ম্যাপে (KVM) সংরক্ষণ করেছি।
  • সংস্থা/পরিবেশে বিদ্যমান সমস্ত এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলির একটি উপস্থাপনা। এগুলি সমস্ত প্রক্সি যেগুলি উপসর্গ edgemicro_ দিয়ে নামকরণ করা হয়েছে।
  • সংস্থা/পরিবেশে বিদ্যমান সমস্ত API পণ্যগুলির একটি উপস্থাপনা৷

এই তথ্যের সাহায্যে, এজ মাইক্রোগেটওয়ে জানে কোন প্রক্সি এবং প্রক্সি পাথগুলিকে প্রক্রিয়া করার অনুমতি দেওয়া হয়েছে৷ এটি নিরাপত্তা প্রয়োগ করতে পণ্যের তথ্য ব্যবহার করে (ঠিক একইভাবে যে কোনো এপিআই প্রক্সি অ্যাপিজি এজে করে, যেখানে ডেভেলপার অ্যাপ কীগুলির পণ্যের সাথে সম্পর্ক রয়েছে)। আমরা খুব শীঘ্রই এজ মাইক্রোগেটওয়েকে সুরক্ষিত করার পদক্ষেপগুলি অতিক্রম করব৷

2. টেস্ট এজ মাইক্রোগেটওয়ে

এজ মাইক্রোগেটওয়ে চালু থাকলে, আপনি প্রক্সি কল করতে পারেন। আপনি যখন এজ মাইক্রোগেটওয়ে শুরু করেছিলেন তখন এজ থেকে এজমিক্রো_হ্যালো প্রক্সির কনফিগারেশন ডাউনলোড করা হয়েছিল। মনে রাখবেন, প্রক্সি বেসপাথ হল /hello ।

এজ মাইক্রোগেটওয়ে পরীক্ষা করতে, আমরা বেস পাথ দিয়ে শুরু করি এবং একটি রিসোর্স পাথ /echo যোগ করি। লক্ষ্য করুন যে বেস পাথের পরে সবকিছু (যেকোনো ক্যোয়ারী প্যারামিটার সহ) কেবল ব্যাকএন্ড টার্গেটে পাস করা হয়:

curl -i http://localhost:8000/hello/echo
{"error":"missing_authorization","error_description":"Missing Authorization header"}

আপনি অনুরোধের সাথে একটি বৈধ API কী বা অ্যাক্সেস টোকেন পাঠাননি বলে ত্রুটিটি ঘটেছে৷ ডিফল্টরূপে, এজ মাইক্রোগেটওয়ের জন্য প্রতিটি API কলে একটি API কী বা একটি অ্যাক্সেস টোকেন প্রয়োজন। টিউটোরিয়ালের পরবর্তী ধাপে, আমরা এই APIটি সঠিকভাবে সুরক্ষিত করব এবং আপনাকে দেখাব কিভাবে একটি বৈধ অ্যাক্সেস টোকেন পেতে হয় এবং অনুরোধের সাথে এটি অন্তর্ভুক্ত করতে হয়।

4. এজ মাইক্রোগেটওয়ে বন্ধ করুন

  1. একটি পৃথক টার্মিনাল উইন্ডোতে, একই ডিরেক্টরিতে cd যেখানে আপনি এজ মাইক্রোগেটওয়ে শুরু করেছিলেন।
  2. স্টপ কমান্ড লিখুন:
    edgemicro stop

পার্ট 4: সিকিউর এজ মাইক্রোগেটওয়ে

আপনি একটি API কী বা একটি অ্যাক্সেস টোকেন ব্যবহার করে এজ মাইক্রোগেটওয়ের মাধ্যমে করা API কলগুলি সুরক্ষিত করতে পারেন।

একটি OAuth2 অ্যাক্সেস টোকেন সহ সুরক্ষিত API কল

আপনি যদি একটি OAuth2 অ্যাক্সেস টোকেন সহ API কলগুলিকে প্রমাণীকরণ করতে চান তবে এই পদক্ষেপগুলি অনুসরণ করুন:

1. প্রয়োজনীয় কী পান

  1. এজ UI-তে, আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন। অ্যাপটির নাম ছিল EdgeMicroTestApp।
  2. ডেভেলপার অ্যাপ পৃষ্ঠায়, কনজিউমার কী এবং কনজিউমার সিক্রেট দেখান এবং সেগুলো কপি করুন। পরবর্তী ধাপে একটি অ্যাক্সেস টোকেন পেতে এই মানগুলির প্রয়োজন৷

2. একটি অ্যাক্সেস টোকেন পান

একটি অ্যাক্সেস টোকেন পেতে দুটি উপায় আছে. আমরা আপনাকে উভয় পদ্ধতি দেখাব।

একটি অ্যাক্সেস টোকেন পেতে CLI ব্যবহার করে

প্রথম পদ্ধতিটি সুবিধাজনক, এবং আমরা টিউটোরিয়াল জুড়ে যে প্যাটার্ন ব্যবহার করেছি তা অনুসরণ করে। দ্বিতীয় পদ্ধতিটি সাধারণত ক্লায়েন্ট অ্যাপ ডেভেলপারদের জন্য বেশি উপযোগী যাদের টোকেন অনুরোধ করতে হবে। প্রকৃত টোকেন এন্ডপয়েন্টটি এজমাইক্রো-অথ প্রক্সিতে প্রয়োগ করা হয় যা আপনি এজ মাইক্রোগেটওয়ে কনফিগার করার সময় স্থাপন করা হয়েছিল।

  1. (ঐচ্ছিক) টোকেন গেট কমান্ডের জন্য সহায়তা দেখুন: 
    edgemicro token get -h
  2. -i এবং -s প্যারামিটারে Apigee Edge-এ আপনার তৈরি ডেভেলপার অ্যাপ থেকে আপনার কনজিউমার কী এবং কনজিউমার সিক্রেট মান প্রতিস্থাপন করে টোকেন তৈরি করুন: 
    edgemicro token get -o [org] -e [env] -i [consumer_key] -s [consumer_secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • consumer_id হল আপনার আগে তৈরি করা ডেভেলপার অ্যাপের কনজিউমার আইডি।
    • consumer_secret হল আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপের কনজিউমার সিক্রেট।

    উদাহরণ

    edgemicro token get -o docs -e test -i G0IAeU864EtBo99NvUbn6Z4CBwVcS2 -s uzHTbwNWvoSmOy

    আউটপুট (নমুনা)

    current nodejs version is v12.5.0
{ token: 'eyJ0eXAiOiJKV1QiLCJhbGciSUzI1NiJ9.eyJhcHBsaWNhdGl
vbl9uYW1lIjoiNWNiMGY0tOWMzOC00YmJjLWIzNzEtZGMxZTQzOGYxZGMxI
iwiY2xpZW50X2lkIjoiNVVdBWEdvSU9lbzYwYWV3OTRQN0c1TUFaRTNhSnA
iLCJzY29wZXMiOltdLCJhcGlfcHJvjdF9saXN0IjpbIsVkZ2VNaWNyb1Rlc
3RQcm9kdWN0IlmlhdCI6MTQ3ODIwODMzMiwiZXhwIjoxNDc4MjEwMTMxfQ.
v3Q8Rs0W9FO_XpERwIAMMXhjGamRmmmWgrAy1wJv0-99oajx5ASI5qjNubM
nCF14xxwlVXHcz1VfedA8Nx7Ih145zhWWuPKL9muzhXXnVBRFeBMeeLqJk4
QQ7Bhst7xH_68nJSTE20Egu95DHOCUemfrepDFH0VggY4BmzvwLkBNfz_te
E_YqwKZbpGOLMdKK1vMk0fk0x19SieIMS_aJYeOAklrzUhnFxWJFrsAWsax
NLx_BbQcZzYfK1JSDUrhRNVBuPHMnGjNA_oHw2J4qa6Hsp62PfchG-DIW_t
-0BFnYf3rYXmqyNORqFrOMdl4VxqQ' }

(ঐচ্ছিক) একটি টোকেন পেতে API ব্যবহার করে

আপনি যদি কার্ল বা অন্য HTTP ক্লায়েন্ট ব্যবহার করে এজ প্রক্সি কল করতে অভ্যস্ত হন, তাহলে আপনি এজমিক্রো টোকেন কমান্ড ব্যবহার না করে সরাসরি টোকেন এন্ডপয়েন্টে কল করতে পারেন তা জানতে আগ্রহী হবেন। এখানে একটি কার্ল উদাহরণ. ইউআরএল-এ শুধু আপনার প্রতিষ্ঠান এবং পরিবেশের নামগুলি প্রতিস্থাপন করুন, এবং একটি মৌলিক প্রমাণীকরণ শিরোনামে কোলন-বিচ্ছিন্ন কনজিউমার কী: কনজিউমার সিক্রেট মানগুলি পাস করুন:

curl -i -X POST "http://[org]-[env].apigee.net/edgemicro-auth/token" -d '{ "client_id": "your consumer key", "client_secret": "your consumer secret", "grant_type": "client_credentials" }' -H "Content-Type: application/json"

কোথায়:

  • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
  • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
  • আপনার আগে তৈরি করা ডেভেলপার অ্যাপের গ্রাহক আইডি হল client_id ।
  • client_secret হল আপনার আগে তৈরি করা ডেভেলপার অ্যাপের কনজিউমার সিক্রেট।

আউটপুট (নমুনা)

কমান্ড, আপনি edgemicro টোকেন CLI কমান্ড ব্যবহার করেছেন বা কার্ল ব্যবহার করে এন্ডপয়েন্টকে ডাকা হোক না কেন, একটি স্বাক্ষরিত অ্যাক্সেস টোকেন প্রদান করে যা ক্লায়েন্ট কল করতে ব্যবহার করা যেতে পারে। এরকম কিছু:

MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFsnhB0Yvg6JKWxKWBDP9o
Xl96dtgH7xPFRqIU0zI452jkMQ1fPz2mSaGwik241yfBku7olooXKRKTRKOUoXa
q3Hld/RPxGSsWtiyyYtKex7tuFdq0Knm1EhowdTRGIgjNvudeYMka/XPRXuykhd 
xIDxWj4rdX+4GPx9qT2eTQC5nOAC7XHVL7ys4KqsAiv28vw10u400KstFFS8Qho 
7FaE0bOKLolKKadKyA60ha1XIw/uSTD6ZQFWQ+XM3OaRbXePWXnSZioSxXcZT7L 
hMUKbsRXw/TCvRB51LgNAgMBAAEwDQYJKoZIhvcNAQELBQADgEBAOuR1OmE/W6j 
gRAarJB5EQuTEpI/9Zpg5c5RAGjzLhkazsycn7pal+IymUjCV7D0oIxTVuTM8ZZ 
57kR5hF/C1ZypDN9i+KGP2ovX8WOCCXYtIQECgZPB/L/7/k7BDuKN4vFBvWUe3X 
s2oyjnVWy+ASqsW8gHfj8ekhe22bP240Oqkbyg9SZP9ol1tvJX6+M0thYwcTwAd 
ft929Icey/MOTQC0jB2qm0gnIx/7KInFXfS5KoFRJoGrWDeckr3RdBo2LhnPaeZ 
1gPYIqphZ3HfisF5KlBXoR8oT/Ilym/nq5COlv+3L4tMIk18F7BQZB60SRazifz 
pFkIxepyr/0=

3. এজ মাইক্রোগেটওয়েতে কনফিগারেশন পরীক্ষা করুন

  1. $HOME/.edgemicro/org-env-config.yaml ফাইলটি খুলুন। আপনি এই ফাইলটি সনাক্ত করতে না পারলে এজ মাইক্রোগেটওয়ে কোথায় ইনস্টল করা আছে তা দেখুন৷
  2. নিশ্চিত করুন যে এই oauth প্লাগইন বৈশিষ্ট্য মিথ্যা সেট করা আছে. এগুলি ডিফল্টরূপে মিথ্যা, তবে এটি দুবার চেক করা একটি ভাল ধারণা: 
    oauth:
   allowNoAuthorization: false
   allowInvalidAuthorization: false
  3. এছাড়াও org-env-config.yaml ফাইলে, নিশ্চিত করুন যে oauth প্লাগইনটি plugins:sequence এলিমেন্টে যোগ করা হয়েছে, যেমন:: 
    plugins:
   dir: ../plugins
   sequence:
   - oauth
  4. আপনি যদি ফাইলে কোনো পরিবর্তন করেন, তাহলে চলমান এজ মাইক্রোগেটওয়ে ইনস্ট্যান্সে পরিবর্তনগুলি পুনরায় লোড করুন । এই কমান্ডটি এজ মাইক্রোগেটওয়েকে শূন্য-ডাউনটাইমের সাথে পুনরায় কনফিগার করে: 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c39177d64a88754d615c74e1f78b6181d

4. নিরাপদে API কল করুন

হাতে একটি অ্যাক্সেস টোকেন সহ, আপনি এখন নিরাপদে API কল করতে পারেন। যেমন:

  curl -i -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhcHBsaWNhdGlvbl
9uYW1lIjoiYmU2YmZjYjAtMWQ0Ni00Y2IxLWFiNGQtZTMxNzRlNTAyMDZkIiwiY2xpZW50X2lkIjoiOGxTTTVIRHdyM
VhIT1ZwbmhURExhYW9FVG5STVpwWk0iLCJzY29wZXMiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIk1pY3JvZ2F0ZXdh
eVRlQcm9kdWN0Il0sImCI6MTQzNTM0NzY5MiwiZXhwIjoxNDM1MzQ5NDkxfQ.PL30Y6uK1W1f2ONPEsBDB_BT31c6
IsjWGfwpz-p6Vak8r767tAT4mQAjuBpQYv7_IU4DxSrnxXQ_q536QYCP4p4YKfBvyqbnW0Rb2CsPFziy_n8HIczsWO
s0p4czcK63SjONaUpxV9DbfGVJ_-WrSdqrqJB5syorD2YYJPSfrCcgKm-LpJc6HCylElFDW8dHuwApaWcGRSV3l5Wx
4A8Rr-WhTIxDTX7TxkrfI4THgXAo37p3au3_7DPB_Gla5dWTzV4j93xLbXPUbwTHzpaUCFzmPnVuYM44FW5KgvBrV0
64RgPmIFUxSqBWGQU7Z1w2qFmWuaDljrMDoLEreI2g" http://localhost:8000/hello/echo

API মক সার্ভার থেকে শিরোনাম এবং অন্যান্য তথ্য প্রদান করে।

একটি API কী দিয়ে API সুরক্ষিত করা

আপনি অনুমোদনের জন্য একটি API কী ব্যবহার করতে চাইলে এই পদক্ষেপগুলি অনুসরণ করুন:

1. API কী পান

  1. এজ UI-তে, আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন। অ্যাপটির নাম ছিল EdgeMicroTestApp।
  2. বিকাশকারী অ্যাপ পৃষ্ঠায়, উপভোক্তা কী দেখান এবং এটি অনুলিপি করুন। এই মান হল API কী। আপনি প্রমাণীকৃত API কল করতে এই কী ব্যবহার করবেন।

2. এজ মাইক্রোগেটওয়েতে কনফিগারেশন পরীক্ষা করুন

  1. $HOME/.edgemicro/org-env-config.yaml. আপনি এই ফাইলটি সনাক্ত করতে না পারলে এজ মাইক্রোগেটওয়ে কোথায় ইনস্টল করা আছে তা দেখুন৷
  2. নিশ্চিত করুন যে এই oauth প্লাগইন বৈশিষ্ট্য মিথ্যা সেট করা আছে. এগুলি ডিফল্টরূপে মিথ্যা, তবে আপনি চাইলে দুবার চেক করতে পারেন: 
    oauth:
   allowNoAuthorization: false
   allowInvalidAuthorization: false
  3. এছাড়াও org-env-config.yaml ফাইলে, নিশ্চিত করুন যে oauth প্লাগইনটি plugins:sequence এলিমেন্টে যোগ করা হয়েছে, যেমন:: 
    plugins:
   dir: ../plugins
   sequence:
   - oauth
  4. আপনি যদি ফাইলে কোনো পরিবর্তন করেন, তাহলে চলমান এজ মাইক্রোগেটওয়ে ইনস্ট্যান্সে পরিবর্তনগুলি পুনরায় লোড করুন । এই কমান্ডটি এজ মাইক্রোগেটওয়েকে শূন্য-ডাউনটাইমের সাথে পুনরায় কনফিগার করে: 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c30177d64a88754d615c74e1f78b6181d

3. একটি API কী দিয়ে নিরাপদে API-কে কল করুন

নিম্নরূপ x-api-কী হেডার সহ API-কে কল করুন। আপনি ডেভেলপার অ্যাপ থেকে কপি করেছেন কনজিউমার কী মান হল API কী। ডিফল্টরূপে, এজ মাইক্রোগেটওয়ে আশা করে যে আপনি x-api-key নামক একটি শিরোনামে কী পাস করবেন, যেমন:

curl -i http://localhost:8000/hello/echo -H "x-api-key: [apikey]"

কোথায়:

  • apikey হল EdgeMicroTestApp থেকে নেওয়া কনজিউমার কী মান।

যেমন:


curl -i http://localhost:8000/hello/echo -H 'x-api-key: XsU1R4zGXz2ERxd0ilYQ5szwuljr5bB'

আপনার কাছে এখন একটি সম্পূর্ণ কার্যকরী এবং নিরাপদ এজ মাইক্রোগেটওয়ে রয়েছে। টিউটোরিয়ালের পরবর্তী অংশে, আমরা এজ মাইক্রোগেটওয়েতে কার্যকারিতা যুক্ত প্লাগইনগুলির দিকে নজর দেব।

পার্ট 5: একটি স্পাইক অ্যারেস্ট প্লাগইন যোগ করুন

এই অংশে, আমরা এজ মাইক্রোগেটওয়ের আপনার উদাহরণে স্পাইক অ্যারেস্ট নামে একটি হার-সীমিত বৈশিষ্ট্য যুক্ত করব।

প্লাগইন কি?

একটি প্লাগইন হল একটি Node.js মডিউল যা এজ মাইক্রোগেটওয়েতে কার্যকারিতা যোগ করে। প্লাগইন মডিউলগুলি একটি সামঞ্জস্যপূর্ণ প্যাটার্ন অনুসরণ করে এবং এজ মাইক্রোগেটওয়েকে পরিচিত একটি অবস্থানে সংরক্ষণ করা হয়, মাইক্রোগেটওয়েকে সেগুলি স্বয়ংক্রিয়ভাবে আবিষ্কার এবং লোড করতে সক্ষম করে৷ আপনি প্লাগইন সম্পর্কে আরও পড়তে পারেন প্লাগইন ব্যবহার করুন ।

একটি স্পাইক গ্রেফতার প্লাগইন যোগ করা হচ্ছে

একটি স্পাইক অ্যারেস্ট প্লাগইন ট্রাফিক স্পাইক থেকে রক্ষা করে। এটি একটি এজ মাইক্রোগেটওয়ে উদাহরণ দ্বারা প্রক্রিয়াকৃত অনুরোধের সংখ্যাকে থ্রোটল করে।

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

  1. $HOME/.edgemicro/org-env-config.yaml. আপনি এই ফাইলটি সনাক্ত করতে না পারলে এজ মাইক্রোগেটওয়ে কোথায় ইনস্টল করা আছে ৷
  2. নিম্নলিখিত উপাদান যোগ করুন. আপনি ফাইলের যেকোনো জায়গায় এটি যোগ করতে পারেন। 
       spikearrest:
      timeUnit: minute   
      allow: 10   
      buffersize: 0
  3. edgemicro:sequence এলিমেন্টে spikearrest যোগ করুন, যেমনটি নিচে দেখানো হয়েছে। সিকোয়েন্স কনফিগারেশন প্রপার্টি এজ মাইক্রোগেটওয়েকে বলে যে ক্রমে প্লাগইন মডিউলগুলি চালানো হয়। 
    edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
  plugins:
    dir: ../plugins
  sequence:
    - oauth
    - spikearrest
  4. কনফিগার ফাইলটি সংরক্ষণ করুন।
  5. রিলোড কমান্ড দিয়ে এজ মাইক্রোগেটওয়ে রিলোড করুন। আপনি যে ডিরেক্টরি থেকে এজ মাইক্রোগেটওয়ে শুরু করেছেন সেখান থেকে আপনাকে অবশ্যই এই কমান্ডটি চালাতে হবে।
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c39177d64a88754d615c74e1f78b6181d
  6. দ্রুত ধারাবাহিকভাবে API-কে কয়েকবার কল করার চেষ্টা করুন। দ্বিতীয় কলের পরে, এজ মাইক্রোগেটওয়ে এই ত্রুটিটি ফেরত দেয়: 
    {"message":"SpikeArrest engaged","status":503}

কারণ হল যে স্পাইক অ্যারেস্ট নির্দিষ্ট সময়ের ইউনিটে করা কলের সংখ্যাকে মসৃণ করে। সুতরাং, এই ক্ষেত্রে, আপনি এক মিনিটে 10টি কল করতে পারেন, বা প্রতি 6 সেকেন্ডে একটি কল করতে পারেন৷

অতিরিক্ত ক্রেডিট: কোটা প্লাগইন যোগ করা হচ্ছে

স্পাইক অ্যারেস্ট কনফিগার করতে ব্যবহৃত একই প্যাটার্ন অনুসরণ করে, আপনি কোটা প্লাগইন এর মত অন্যান্য প্লাগইন যোগ করতে পারেন। স্পাইক অ্যারেস্টের মতো, কোটা প্লাগইনটি প্রতিটি এজ মাইক্রোগেটওয়ে ইনস্টলেশনের সাথে অন্তর্ভুক্ত করা হয়েছে। একটি কোটা নির্দিষ্ট সময়ের ব্যবধানে (মিনিট বা ঘন্টা) একটি এপিআই-এ জমা দেওয়ার অনুমতিপ্রাপ্ত অনুরোধ বার্তাগুলির সংখ্যা নির্দিষ্ট করে৷

পার্ট 6: Apigee Edge-এ বিশ্লেষণ দেখা

আমাদের কাছে এখন একটি সম্পূর্ণরূপে কার্যকরী এজ মাইক্রোগেটওয়ে উদাহরণ রয়েছে, আসুন দেখি এটি কী হয়েছে! ডিফল্টরূপে, বিশ্লেষণ প্লাগইন মডিউল এজ মাইক্রোতে যোগ করা হয়। এই মডিউলটি নিঃশব্দে এজ মাইক্রো থেকে এপিজি প্রান্তে বিশ্লেষণ ডেটা পুশ করে, যেখানে এটি এজ অ্যানালিটিক্স সিস্টেম দ্বারা গ্রাস করা হয়। চলুন দেখা যাক:

  1. Apigee Edge এ আপনার প্রতিষ্ঠানে লগ ইন করুন।
  2. বিশ্লেষণ > প্রক্সি পারফরম্যান্স নির্বাচন করুন।
  3. প্রক্সি পারফরম্যান্স ড্যাশবোর্ডে, edgemicro_hello প্রক্সি নির্বাচন করুন।
  4. গ্রাফটি আপনাকে প্রক্সির ট্রাফিক প্যাটার্ন সম্পর্কে তথ্য দেখায়, যেমন মোট ট্রাফিক, গড় প্রতিক্রিয়া সময়, গড় লক্ষ্য প্রতিক্রিয়া সময় এবং আরও অনেক কিছু।

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

,

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

এজ মাইক্রোগেটওয়ে v. 3.2.x

ওভারভিউ

এই সেটআপ গাইডের ধাপগুলি সম্পূর্ণ করার পরে, আপনার কাছে একটি সম্পূর্ণ কনফিগার করা, কার্যকরী এজ মাইক্রোগেটওয়ে ইনস্টলেশন থাকবে যা API অনুরোধগুলি প্রক্রিয়া করতে সক্ষম। আপনি এজ মাইক্রোগেটওয়ের মাধ্যমে একটি ব্যাকএন্ড টার্গেটে সুরক্ষিত API কল করে সেটআপ পরীক্ষা করবেন। আপনি মাইক্রোগেটওয়েতে একটি স্পাইক অ্যারেস্ট প্লাগইন যুক্ত করতে শিখবেন।

এই নির্দেশিকাটি এই অংশে বিভক্ত:

পূর্বশর্ত: এজ মাইক্রোগেটওয়ে ইনস্টল করুন

এজ মাইক্রোগেটওয়ে ইনস্টল করার নির্দেশাবলী অনুসরণ করুন। আপনি যখন ইনস্টলেশন সম্পূর্ণ করবেন, আপনি এই টিউটোরিয়ালের ধাপগুলি অনুসরণ করতে প্রস্তুত হবেন।

পার্ট 1: এজ মাইক্রোগেটওয়ে কনফিগার করুন

এই অংশে আপনি Apigee Edge-এর সাথে যোগাযোগের জন্য Edge Microgateway কনফিগার করতে একটি কমান্ড-লাইন ইন্টারফেস (CLI) কমান্ড ব্যবহার করবেন।

Apigee এজ ক্লাউড কনফিগারেশন ধাপ

এপিজি এজ ক্লাউডের সাথে এজ মাইক্রোগেটওয়ে ব্যবহার করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. এজ মাইক্রোগেটওয়ে শুরু করুন (আপনাকে শুধুমাত্র একবার এই পদক্ষেপটি করতে হবে):
    edgemicro init
  2. default.yaml ফাইল নামে একটি কনফিগার ফাইল আপনার হোম ডিরেক্টরিতে .edgemicro নামক একটি সাবডিরেক্টরিতে স্থাপন করা হয়েছিল। এই ফাইলটি বিদ্যমান রয়েছে তা নিশ্চিত করতে এখনই পরীক্ষা করুন: 
    ls ~/.edgemicro
default.yaml

    দ্রষ্টব্য: এজ মাইক্রোগেটওয়ে ডক্সে, আমরা টিল্ড ( ~ ) সহ হোম ডিরেক্টরি উল্লেখ করি, যা একটি UNIX শর্টকাট। আপনি যদি উইন্ডোজে থাকেন, আপনি যদি এমন একটি শেল চালান যা টিল্ডকে সমর্থন করে না, তাহলে আপনাকে হোম ডিরেক্টরিকে উল্লেখ করে এমন কমান্ডগুলিতে টিল্ডের জন্য উপযুক্ত পরিবেশ পরিবর্তনশীল প্রতিস্থাপন করতে হবে। উদাহরণস্বরূপ: %USERPROFILE%/.edgemicro ।

  3. সমস্ত CLI কমান্ডের একটি সাহায্য ফাংশন আছে। এজমিক্রো কনফিগার কমান্ডের জন্য প্রিন্ট সহায়তা:
    edgemicro configure -h
  4. এজ মাইক্রোগেটওয়ে কনফিগার করতে নিম্নলিখিত কমান্ডটি চালান:
    edgemicro configure -o [org] -e [env] -u [username]

    কোথায়:

    • org: আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env: আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • username: আপনার Apigee অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানা।

      দ্রষ্টব্য: কনফিগার কমান্ড অতিরিক্ত পরামিতি অনুমোদন করে। একটি সম্পূর্ণ তালিকার জন্য, এপিজি এজ ক্লাউডের জন্য এজ মাইক্রোগেটওয়ে কনফিগার করা দেখুন।

উদাহরণ

edgemicro configure -o docs -e test -u jdoe@example.com

আউটপুট

./edgemicro configure -o docs -e test -u jdoe@apigee.com
password:
current nodejs version is v12.5.0
current edgemicro version is 3.1.0
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
checking org for existing KVM
error checking for cert. Installing new cert.
creating KVM
adding private_key
adding public_key
configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1

saving configuration information to: $HOME/.edgemicro/docs-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCQ2mJZJGbPPTANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3QwHhcNMTcwOTA3MjA0ODA4WhcNMTcwOTA4MjA0ODA4WjAUMRIwEAYD
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDw
yzmqi5CelqqtTr6IaFe1ssrMXEDnNtkBh95U6F5zHLsNQhJcyNUAO9um6FLMSqSd
fTztXfWUZzDgmbb6sfbx/9cqpvQ8TIjxyIz8xGM9H4legRQmsCQoYGkLjpPE5ZOa
wZrI5IaVm8LY6vbopPFwxgKOQ9bphx6k9Na055DmNyZAOTMD+4I0m/RdsrnZnYih
3DaFj1tXHKZI1jfAt/QOif5Nmk4+JckYwF+9HBysWUbbvj/gnBjVYF2Isb7q7oFD
lPGhwFoIebMqHMWD8lG7+9RJDO9dDV6f1g1/9waIrq1D+MoVXos9VMstNrPp0cKF
Ue+lAkct8tylH+2MosF7AgMBAAEwDQYJKoZIhvcNAQELBQADggEBAJMRdcQh3ayy
csVVT4TYwxV7MKWRfhDRz6X+MM9frB+Z7sI4+ZoZbXKOoZI2hSjmbdLpkNR/m9eJ
+1Uk0JKmpSY7Q+1rRrvcHsWNysGf4z+zDJXYECTrtSnXKBXtb9SJ8JAfoZOQD0lA
zmKuJjQMLTdiYMHOBR6ZWnaKaRvrQwGHcQrheJm4a90XgZF6jcRR8CPrBzkmsbCp
IU/Ux3E17wDGYPxjJs5otyQG8rN/88RGyaSeXK8rjKr9D4KFGJeasXBKmTG2afAr
yfBvS4h6s42FCOR/eLpmMllVoO9up71Fa3EtV+aK+FNNY9uMbgUHeLQE7z9nn06q
PTmvExZLkLQ=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb
  secret: 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47

Apigee প্রাইভেট ক্লাউড কনফিগারেশন ধাপ

এপিজি প্রাইভেট ক্লাউডের সাথে এজ মাইক্রোগেটওয়ে ব্যবহার করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. এজ মাইক্রোগেটওয়ে শুরু করুন (আপনাকে শুধুমাত্র একবার এই পদক্ষেপটি করতে হবে):
    edgemicro init
  2. এজমাইক্রো প্রাইভেট কনফিগার কমান্ডের জন্য সাহায্য তথ্য মুদ্রণ করুন। আপনি যেকোনো এজ মাইক্রোগেটওয়ে সিএলআই কমান্ড বা কমান্ড বিকল্পের জন্য এইভাবে সাহায্য প্রিন্ট করতে পারেন। 
    edgemicro private configure -h
  3. নিম্নলিখিত কমান্ডটি চালান। এটির জন্য আপনার Apigee Edge প্রাইভেট ক্লাউড অ্যাকাউন্ট সম্পর্কে স্ট্যান্ডার্ড তথ্য প্রয়োজন: প্রতিষ্ঠানের নাম, পরিবেশের নাম, ব্যবহারকারীর নাম (ইমেল ঠিকানা), পাসওয়ার্ড, ম্যানেজমেন্ট সার্ভার আইপি এবং রাউটার আইপি। এই কমান্ডটি ব্যবহার করার জন্য আপনাকে অবশ্যই এজ সংস্থার প্রশাসক হতে হবে: 
    edgemicro private configure -o [org] -e [env] -u [username] -r [runtime_url] -m [mgmt_url] -v [virtual_host]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • runtime_url হল আপনার ব্যক্তিগত ক্লাউড উদাহরণের জন্য রানটাইম URL।
    • mgmt_url হল আপনার ব্যক্তিগত ক্লাউড উদাহরণের জন্য ব্যবস্থাপনা সার্ভারের URL।
    • username হল আপনার Apigee অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানা।
    • virtual_host হল ভার্চুয়াল হোস্ট নামের একটি কমা দ্বারা পৃথক করা তালিকা। ডিফল্ট মানগুলি default,secure

উদাহরণ

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.52.106:9001 -m http://192.162.52.106:8080 -v default

অথবা, আপনার যদি myorg-test.mycompany.com এর একটি ভার্চুয়াল হোস্ট উপনাম থাকে, তাহলে আপনি এইরকম একটি কমান্ড ব্যবহার করবেন:

edgemicro private configure -o docs -e test -u jdoe@example.com -r myorg-test.mycompany.com -m http://192.162.52.106:8080 -v default

আউটপুট

delete cache config
checking for previously deployed proxies
configuring edgemicro internal proxy
deploying edgemicro internal proxy
deploying  edgemicro-auth  app
copy auth app into tmp dir
copy config into tmp deer
Give me a minute or two... this can take a while...
App edgemicro-auth added to your org. Now adding resources.

checking org for existing KVM
error checking for cert. Installing new cert.
creating KVM
adding private_key
adding public_key
configuring host http://192.168.52.106:9001 for region dc-1

saving configuration information to: $HOME/.edgemicro/jdoe-test-config.yaml
vault info: 
-----BEGIN CERTIFICATE----- 
MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWsKWBDP9o
Xl96dtgH7xPFRqIU0zI452jkMQ1fPz2mSaGwik245yfBku7olooXKRKTRKOUoXa 
q3Hld/RPxGSsWtiyyYtKex7tuFdq0Knm1EhowdTRGIgjNvudeYMka/XPRXuykhd 
xIDxWj4rdX+4GPx9qT2eTQC5nOAC7XHVL7ys4KqsAiv28vw10u400KstFFS8Qho 
7FaE0bOKLolKKadKyA60ha1XIw/uSTD6ZQFWQ+XM3OaRbXePWXnSZioSxXcZT7L 
hMUKbsRXw/TCvRB51LgNAgMBAAEwDQYJKoZIhvcNAQELBQADgEBAOuR1OmE/W6j 
gRAarJB5EQuTEpI/9Zpg5c5RAGjzLhkazsycn7pal+IymUjCV7D0oIxTVuTM8ZZ 
57kR5hF/C1ZypDN9i+KGP2ovX8WOCCXYtIQECgZPB/L/7/k7BDuKN4vFBvWUe3X 
s2oyjnVWy+ASqsW8gHfj8ekhe22bP240Oqkbyg9SZP9ol1tvJX6+M0thYwcTwAd 
ft929Icey/MOTQC0jB2qm0gnIx/7KInFXfS5KoFRJoGrWDeckr3RdBo2LhnPaeZ 
1gPYIqphZ3HfisF5KlBXoR8oT/Ilym/nq5COlv+3L4tMIk18F7BQZB60SRazifz 
pFkIxepyr/0= 
-----END CERTIFICATE----- 

The following credentials are required to start edge micro 
   key: a3f8f3dfe39158fc3c50b274f0af2234246e0d5f6ea4ad09389b645147151ba3
   secret: 3e9904802fb3c0e8ca408128a11119cf13546d54dac10ace944c097a726a1263

edgemicro configuration complete!

ইনস্টলেশন যাচাই করুন

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

edgemicro verify -o [org] -e [env] -k [key] -s [secret]

কোথায়:

  • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
  • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
  • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
  • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

উদাহরণ 

edgemicro verify -o docs -e test -k 93b01fd21d86331459ae52f624ae9aeb13eb94767ce40a4f621d172cdfb7e8e6 -s c8c755be97cf56c21f8b0156d7132afbd03625bbd85dc34ebfefae4f23fbcb3c

কনফিগারেশন সম্পর্কে

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

এই কনফিগারেশন তথ্য কি জন্য ব্যবহৃত হয়? এই টিউটোরিয়ালের পরবর্তী অংশে আমরা আবিষ্কার করব, যখন এজ মাইক্রোগেটওয়ে শুরু হবে, তখন এটিকে অ্যাপিজি এজ থেকে বিশেষ এজ মাইক্রোগেটওয়ে-সচেতন API প্রক্সিগুলির একটি তালিকা পেতে হবে। এই টিউটোরিয়ালের পরবর্তী অংশে, আপনি একটি মাইক্রোগেটওয়ে-সচেতন প্রক্সি তৈরি করবেন। এজ মাইক্রোগেটওয়ে ক্লায়েন্টদের শুধুমাত্র এই Microgateway-সচেতন API প্রক্সিগুলির দ্বারা ফ্রন্ট করা APIগুলিকে কল করতে সীমাবদ্ধ করে এবং ক্লায়েন্টদের প্রতিটি কলের জন্য একটি বৈধ নিরাপত্তা টোকেন উপস্থাপন করতে হবে (ডিফল্টরূপে)। এই প্রক্সিগুলি সম্পর্কে আরও পড়তে, এজ মাইক্রোগেটওয়ের ওভারভিউতে " এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি সম্পর্কে আপনার যা জানা দরকার " দেখুন৷

একজন এজ ওআরজি প্রশাসক হিসেবে, আপনি জানতে আগ্রহী হবেন যে এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি অন্য যেকোনো প্রক্সির মতো এজ পণ্যগুলিতে যোগ করা যেতে পারে। পণ্য এবং ডেভেলপার অ্যাপ ব্যবহারের মাধ্যমে, আপনি এজ মাইক্রোগেটওয়ের মাধ্যমে কল করা API-তে অ্যাক্সেস নিয়ন্ত্রণ করতে ক্লায়েন্ট-নির্দিষ্ট নিরাপত্তা টোকেন তৈরি করতে পারেন। আবার, জড়িত নিদর্শনগুলি Apigee Edge-এ যেকোন API প্রক্সি, পণ্য এবং বিকাশকারী অ্যাপগুলির সাথে কাজ করার মতো। আপনি যদি পণ্যগুলি পড়তে চান তবে একটি API পণ্য কী দিয়ে শুরু করুন? এজ ডকুমেন্টেশনে।

এরপরে আমরা এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি কীভাবে তৈরি করতে হয় তা নিয়ে চলব এবং এর পরে, আমরা এজ মাইক্রোগেটওয়ে শুরু করব এবং সেটআপ পরীক্ষা করব।

পার্ট 2: Apigee Edge এ সত্তা তৈরি করুন

এই অংশে, আপনি প্রান্তে এই সত্তাগুলি তৈরি করবেন:

  • একটি মাইক্রোগেটওয়ে-সচেতন প্রক্সি - এটি একটি বিশেষ প্রক্সি যা এজ মাইক্রোগেটওয়ে স্টার্টআপের সময় আবিষ্কার করতে পারে। মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলির একটি নামকরণের নিয়ম রয়েছে যা আপনাকে অবশ্যই অনুসরণ করতে হবে: নামটি অবশ্যই edgemicro_ সাথে হতে হবে। যেমন edgemicro_hello বা edgemicro_userinfo । এজ মাইক্রোগেটওয়ে শুরু হলে, এটি এজ থেকে একই এজ সংস্থা এবং পরিবেশ থেকে মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলির একটি তালিকা পুনরুদ্ধার করে যা আপনি এজ মাইক্রোগেটওয়ে শুরু করার সময় নির্দিষ্ট করেছিলেন।

    প্রতিটি মাইক্রোগেটওয়ে-সচেতন প্রক্সির জন্য, এজ মাইক্রোগেটওয়ে প্রক্সির টার্গেট URL এবং এর বেস পাথ পুনরুদ্ধার করে। মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলি এজ প্ল্যাটফর্মের একটি প্রক্সির সাথে এজ মাইক্রোগেটওয়ে দ্বারা উত্পন্ন বিশ্লেষণ ডেটা সংযুক্ত করার একটি সুবিধাজনক উপায়ও প্রদান করে। মাইক্রোগেটওয়ে API কলগুলি পরিচালনা করে, এটি অ্যাসিঙ্ক্রোনাসভাবে বিশ্লেষণ ডেটা এজ-এ পুশ করে। অ্যানালিটিক্স ডেটা মাইক্রোগেটওয়ে-সচেতন প্রক্সি নাম(গুলি) এর অধীনে এজ অ্যানালিটিক্স UI-তে প্রদর্শিত হবে, যেমন এটি অন্য কোনো প্রক্সির জন্য দেখায়।
  • একটি পণ্য, বিকাশকারী এবং বিকাশকারী অ্যাপ্লিকেশন - Edge Microgateway OAuth2 অ্যাক্সেস টোকেন বা API কী সুরক্ষা সক্ষম করতে পণ্য, বিকাশকারী এবং বিকাশকারী অ্যাপ্লিকেশনগুলি ব্যবহার করে। এজ মাইক্রোগেটওয়ে শুরু হলে, এটি আপনার Apigee Edge প্রতিষ্ঠান থেকে সমস্ত পণ্য কনফিগারেশন ডাউনলোড করে। এটি API কী বা OAuth2 অ্যাক্সেস টোকেন সহ এজ মাইক্রোগেটওয়ের মাধ্যমে করা API কলগুলি যাচাই করতে এই তথ্য ব্যবহার করে।

1. এজ-এ একটি এজ মাইক্রোগেটওয়ে-সচেতন API প্রক্সি তৈরি করুন

  1. Apigee Edge এ আপনার প্রতিষ্ঠানে লগ ইন করুন।
  2. পাশের নেভিগেশন মেনুতে বিকাশ > API প্রক্সি নির্বাচন করুন।
  3. + প্রক্সি ক্লিক করুন। একটি প্রক্সি তৈরি করুন উইজার্ড আহ্বান করা হয়েছে৷
  4. প্রথম উইজার্ড পৃষ্ঠায়, বিপরীত প্রক্সি (সবচেয়ে সাধারণ) নির্বাচন করুন।
  5. পরবর্তী ক্লিক করুন.
  6. উইজার্ডের বিবরণ পৃষ্ঠায়, নিম্নরূপ কনফিগার করুন। দেখানো হিসাবে ঠিক উইজার্ড পূরণ করতে ভুলবেন না:
    • প্রক্সি নাম: edgemicro_hello
    • প্রক্সি বেস পাথ: /হ্যালো
    • বিদ্যমান API: http://mocktarget.apigee.net/
  7. পরবর্তী ক্লিক করুন.
  8. উইজার্ডের নিরাপত্তা পৃষ্ঠায়, পাস থ্রু (কোনটি নয়) নির্বাচন করুন।
  9. পরবর্তী ক্লিক করুন.
  10. উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, ডিফল্টগুলি গ্রহণ করুন।
  11. পরবর্তী ক্লিক করুন.
  12. উইজার্ডের বিল্ড পৃষ্ঠায়, আপনার প্রক্সি সেটিংস পর্যালোচনা করুন। পরীক্ষা পরিবেশ নির্বাচন করা হয়েছে তা নিশ্চিত করুন।
  13. Build and Deploy এ ক্লিক করুন।

2. একটি পণ্য তৈরি করুন

  1. পাশের নেভিগেশন মেনুতে প্রকাশ > API পণ্য নির্বাচন করুন।
  2. ক্লিক করুন + API পণ্য . পণ্যের বিশদ পৃষ্ঠাটি প্রদর্শিত হবে।
  3. নিম্নরূপ পণ্য বিবরণ পৃষ্ঠাটি পূরণ করুন:
    • নাম: EdgeMicroTestProduct
    • প্রদর্শনের নাম: EdgeMicroTestProduct
    • পরিবেশ: পরীক্ষা এবং পণ্য
    • প্রবেশাধিকার: সর্বজনীন
    • কী অনুমোদনের ধরন: স্বয়ংক্রিয়
  4. রিসোর্সে, +API প্রক্সিতে ক্লিক করুন
  5. edgemicro-auth নির্বাচন করুন
  6. আবার +API প্রক্সিতে ক্লিক করুন।
  7. edgemicro_hello নির্বাচন করুন
  8. + কাস্টম রিসোর্স নির্বাচন করুন
  9. লিখুন /**
  10. আবার + কাস্টম রিসোর্স নির্বাচন করুন।
  11. লিখুন /
  12. Save এ ক্লিক করুন।

3. (ঐচ্ছিক) একটি পরীক্ষা বিকাশকারী তৈরি করুন৷

এই টিউটোরিয়ালের উদ্দেশ্যে, আপনি একটি বিকাশকারী অ্যাপ তৈরি করে পরবর্তী ধাপের জন্য যে কোনো বিদ্যমান বিকাশকারী ব্যবহার করতে পারেন। কিন্তু আপনি যদি চান, এখন একটি পরীক্ষা বিকাশকারী তৈরি করুন:

  1. পাশের নেভিগেশন মেনুতে প্রকাশ > বিকাশকারী নির্বাচন করুন।
  2. + বিকাশকারী ক্লিক করুন।
  3. একটি পরীক্ষা বিকাশকারী তৈরি করতে ডায়ালগটি পূরণ করুন৷

4. একটি ডেভেলপার অ্যাপ তৈরি করুন

আপনি এজ মাইক্রোগেটওয়ের মাধ্যমে সুরক্ষিত API কল করতে এই অ্যাপ থেকে ক্লায়েন্ট শংসাপত্র ব্যবহার করতে যাচ্ছেন:

  1. পাশের নেভিগেশন মেনুতে প্রকাশ > অ্যাপ নির্বাচন করুন।
  2. + অ্যাপে ক্লিক করুন। বিকাশকারী অ্যাপের বিবরণ পৃষ্ঠাটি প্রদর্শিত হবে।
  3. নিম্নলিখিত হিসাবে বিকাশকারী অ্যাপ পৃষ্ঠাটি পূরণ করুন:
    1. নাম: EdgeMicroTestApp
    2. প্রদর্শনের নাম: EdgeMicroTestApp
    3. বিকাশকারী: আপনি যদি একটি পরীক্ষা বিকাশকারী তৈরি করেন তবে এটি নির্বাচন করুন। অথবা, আপনি এই টিউটোরিয়ালের উদ্দেশ্যে যেকোন বিদ্যমান বিকাশকারী ব্যবহার করতে পারেন।
    4. শংসাপত্র:
      1. মেয়াদ শেষ হওয়া নির্বাচন করুন: কখনই না ।
      2. পণ্য + ক্লিক করুন এবং EdgeMicroTestProduct নির্বাচন করুন (আপনার তৈরি পণ্যটি)
  4. Save এ ক্লিক করুন।
  5. আপনি অ্যাপের তালিকা পৃষ্ঠায় ফিরে এসেছেন।
  6. আপনার তৈরি করা অ্যাপটি নির্বাচন করুন, EdgeMicroTestApp ।
  7. কনজিউমার কী এবং কনজিউমার সিক্রেটের পাশে দেখান ক্লিক করুন।

পার্ট 3: এজ মাইক্রোগেটওয়ে পরিচালনা করুন

এখন আপনার কাছে একটি কনফিগার করা এজ মাইক্রোগেটওয়ে এবং অন্তত একটি এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সি রয়েছে, এটি এজ মাইক্রোগেটওয়ে শুরু করার সময়। একটি এজ মাইক্রোগেটওয়ে HTTP সার্ভার আপনার স্থানীয় মেশিনে চলবে এবং আপনি সরাসরি সেই সার্ভারে API কল করবেন।

1. এজ মাইক্রোগেটওয়ে শুরু করুন

এজ মাইক্রোগেটওয়ে শুরু করতে edgemicro start কমান্ডটি ব্যবহার করুন।

  1. আপনি edgemicro কনফিগার কমান্ড চালানোর সময় পূর্বে ফেরত দেওয়া কীগুলি আপনার কাছে আছে তা নিশ্চিত করুন। যে আউটপুট এই মত কিছু দেখায়: 
    You need key and secret while starting edgemicro instance

key: da4778e7c240a5d4585fc559eaba5083328828bc9f3a7f583e8b73e
secret: 3aad7439708b4aeb38ee08e82189921ad00e6fc1ba8a8ae9f929ee2
  2. (ঐচ্ছিক) edgemicro start কমান্ডের জন্য সাহায্য তথ্য মুদ্রণ করুন।
    edgemicro start -h
  3. এজ মাইক্রোগেটওয়ে শুরু করতে, নিম্নলিখিত কমান্ডটি চালান: 
    edgemicro start -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro start -o docs -e test -k 701e70e718ce6dc1880616b3c39177d64a88754d615c7a4e1f78b6181d000723 -s 05c14356e42d136b83dd135cf8a18531ff52d7299134677e30ef4e34ab0cc824

    আউটপুট

    স্টার্ট কমান্ড অ্যাপিজি এজ থেকে অনেক কনফিগারেশন তথ্য পুনরুদ্ধার করে (যা টার্মিনাল উইন্ডোতে স্ক্রোল করে)। আউটপুটে, আপনি মাইক্রোগেটওয়ে-সচেতন প্রক্সি এবং আবিষ্কৃত পণ্যগুলির একটি তালিকা দেখতে পাবেন। আউটপুট শেষে, আপনি এই মত কিছু দেখতে হবে:

    ...

current nodejs version is v12.5.0
current edgemicro version is 3.1.0
info: jwk_public_keys download from null returned 200 undefined
info: jwt_public_key download from https://docs-test.apigee.net/edgemicro-auth/publicKey returned 200 OK
info: products download from https://docs-test.apigee.net/edgemicro-auth/products returned 200 OK
info: config download from https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test returned 200 OK
PROCESS PID : 17991
  4. মাইক্রোগেটওয়ে স্থিতি পরীক্ষা করুন। অন্য টার্মিনাল উইন্ডোতে, একই ডিরেক্টরিতে cd যেখানে আপনি এজ মাইক্রো শুরু করেছিলেন এবং এই কমান্ডটি লিখুন: 
    edgemicro status
current nodejs version is v12.5.0
current edgemicro version is 3.1.0
edgemicro is running with 8 workers

কি হয়েছে?

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

  • আমরা যে পাবলিক কী তৈরি করেছি এবং পূর্বে একটি এনক্রিপ্ট করা কী ভ্যালু ম্যাপে (KVM) সংরক্ষণ করেছি।
  • সংস্থা/পরিবেশে বিদ্যমান সমস্ত এজ মাইক্রোগেটওয়ে-সচেতন প্রক্সিগুলির একটি উপস্থাপনা। এগুলি সমস্ত প্রক্সি যেগুলি উপসর্গ edgemicro_ দিয়ে নামকরণ করা হয়েছে।
  • সংস্থা/পরিবেশে বিদ্যমান সমস্ত API পণ্যগুলির একটি উপস্থাপনা৷

এই তথ্যের সাহায্যে, এজ মাইক্রোগেটওয়ে জানে কোন প্রক্সি এবং প্রক্সি পাথগুলিকে প্রক্রিয়া করার অনুমতি দেওয়া হয়েছে৷ এটি নিরাপত্তা প্রয়োগ করতে পণ্যের তথ্য ব্যবহার করে (ঠিক একইভাবে যে কোনো এপিআই প্রক্সি অ্যাপিজি এজে করে, যেখানে ডেভেলপার অ্যাপ কীগুলির পণ্যের সাথে সম্পর্ক রয়েছে)। আমরা খুব শীঘ্রই এজ মাইক্রোগেটওয়েকে সুরক্ষিত করার পদক্ষেপগুলি অতিক্রম করব৷

2. টেস্ট এজ মাইক্রোগেটওয়ে

এজ মাইক্রোগেটওয়ে চালু থাকলে, আপনি প্রক্সি কল করতে পারেন। আপনি যখন এজ মাইক্রোগেটওয়ে শুরু করেছিলেন তখন এজ থেকে এজমিক্রো_হ্যালো প্রক্সির কনফিগারেশন ডাউনলোড করা হয়েছিল। মনে রাখবেন, প্রক্সি বেসপাথ হল /hello ।

এজ মাইক্রোগেটওয়ে পরীক্ষা করতে, আমরা বেস পাথ দিয়ে শুরু করি এবং একটি রিসোর্স পাথ /echo যোগ করি। লক্ষ্য করুন যে বেস পাথের পরে সবকিছু (যেকোনো ক্যোয়ারী প্যারামিটার সহ) কেবল ব্যাকএন্ড টার্গেটে পাস করা হয়:

curl -i http://localhost:8000/hello/echo
{"error":"missing_authorization","error_description":"Missing Authorization header"}

আপনি অনুরোধের সাথে একটি বৈধ API কী বা অ্যাক্সেস টোকেন পাঠাননি বলে ত্রুটিটি ঘটেছে৷ ডিফল্টরূপে, এজ মাইক্রোগেটওয়ের জন্য প্রতিটি API কলে একটি API কী বা একটি অ্যাক্সেস টোকেন প্রয়োজন। টিউটোরিয়ালের পরবর্তী ধাপে, আমরা এই APIটি সঠিকভাবে সুরক্ষিত করব এবং আপনাকে দেখাব কিভাবে একটি বৈধ অ্যাক্সেস টোকেন পেতে হয় এবং অনুরোধের সাথে এটি অন্তর্ভুক্ত করতে হয়।

4. এজ মাইক্রোগেটওয়ে বন্ধ করুন

  1. একটি পৃথক টার্মিনাল উইন্ডোতে, একই ডিরেক্টরিতে cd যেখানে আপনি এজ মাইক্রোগেটওয়ে শুরু করেছিলেন।
  2. স্টপ কমান্ড লিখুন:
    edgemicro stop

পার্ট 4: সিকিউর এজ মাইক্রোগেটওয়ে

আপনি একটি API কী বা একটি অ্যাক্সেস টোকেন ব্যবহার করে এজ মাইক্রোগেটওয়ের মাধ্যমে করা API কলগুলি সুরক্ষিত করতে পারেন।

একটি OAuth2 অ্যাক্সেস টোকেন সহ সুরক্ষিত API কল

আপনি যদি একটি OAuth2 অ্যাক্সেস টোকেন সহ API কলগুলিকে প্রমাণীকরণ করতে চান তবে এই পদক্ষেপগুলি অনুসরণ করুন:

1. প্রয়োজনীয় কী পান

  1. এজ UI-তে, আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন। অ্যাপটির নাম ছিল EdgeMicroTestApp।
  2. ডেভেলপার অ্যাপ পৃষ্ঠায়, কনজিউমার কী এবং কনজিউমার সিক্রেট দেখান এবং সেগুলো কপি করুন। পরবর্তী ধাপে একটি অ্যাক্সেস টোকেন পেতে এই মানগুলির প্রয়োজন৷

2. একটি অ্যাক্সেস টোকেন পান

একটি অ্যাক্সেস টোকেন পেতে দুটি উপায় আছে. আমরা আপনাকে উভয় পদ্ধতি দেখাব।

একটি অ্যাক্সেস টোকেন পেতে CLI ব্যবহার করে

প্রথম পদ্ধতিটি সুবিধাজনক, এবং আমরা টিউটোরিয়াল জুড়ে যে প্যাটার্ন ব্যবহার করেছি তা অনুসরণ করে। দ্বিতীয় পদ্ধতিটি সাধারণত ক্লায়েন্ট অ্যাপ ডেভেলপারদের জন্য বেশি উপযোগী যাদের টোকেন অনুরোধ করতে হবে। প্রকৃত টোকেন এন্ডপয়েন্টটি এজমাইক্রো-অথ প্রক্সিতে প্রয়োগ করা হয় যা আপনি এজ মাইক্রোগেটওয়ে কনফিগার করার সময় স্থাপন করা হয়েছিল।

  1. (ঐচ্ছিক) টোকেন গেট কমান্ডের জন্য সহায়তা দেখুন: 
    edgemicro token get -h
  2. -i এবং -s প্যারামিটারে Apigee Edge-এ আপনার তৈরি ডেভেলপার অ্যাপ থেকে আপনার কনজিউমার কী এবং কনজিউমার সিক্রেট মান প্রতিস্থাপন করে টোকেন তৈরি করুন: 
    edgemicro token get -o [org] -e [env] -i [consumer_key] -s [consumer_secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • consumer_id হল আপনার আগে তৈরি করা ডেভেলপার অ্যাপের কনজিউমার আইডি।
    • consumer_secret হল আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপের কনজিউমার সিক্রেট।

    উদাহরণ

    edgemicro token get -o docs -e test -i G0IAeU864EtBo99NvUbn6Z4CBwVcS2 -s uzHTbwNWvoSmOy

    আউটপুট (নমুনা)

    current nodejs version is v12.5.0
{ token: 'eyJ0eXAiOiJKV1QiLCJhbGciSUzI1NiJ9.eyJhcHBsaWNhdGl
vbl9uYW1lIjoiNWNiMGY0tOWMzOC00YmJjLWIzNzEtZGMxZTQzOGYxZGMxI
iwiY2xpZW50X2lkIjoiNVVdBWEdvSU9lbzYwYWV3OTRQN0c1TUFaRTNhSnA
iLCJzY29wZXMiOltdLCJhcGlfcHJvjdF9saXN0IjpbIsVkZ2VNaWNyb1Rlc
3RQcm9kdWN0IlmlhdCI6MTQ3ODIwODMzMiwiZXhwIjoxNDc4MjEwMTMxfQ.
v3Q8Rs0W9FO_XpERwIAMMXhjGamRmmmWgrAy1wJv0-99oajx5ASI5qjNubM
nCF14xxwlVXHcz1VfedA8Nx7Ih145zhWWuPKL9muzhXXnVBRFeBMeeLqJk4
QQ7Bhst7xH_68nJSTE20Egu95DHOCUemfrepDFH0VggY4BmzvwLkBNfz_te
E_YqwKZbpGOLMdKK1vMk0fk0x19SieIMS_aJYeOAklrzUhnFxWJFrsAWsax
NLx_BbQcZzYfK1JSDUrhRNVBuPHMnGjNA_oHw2J4qa6Hsp62PfchG-DIW_t
-0BFnYf3rYXmqyNORqFrOMdl4VxqQ' }

(ঐচ্ছিক) একটি টোকেন পেতে API ব্যবহার করে

আপনি যদি কার্ল বা অন্য HTTP ক্লায়েন্ট ব্যবহার করে এজ প্রক্সি কল করতে অভ্যস্ত হন, তাহলে আপনি এজমিক্রো টোকেন কমান্ড ব্যবহার না করে সরাসরি টোকেন এন্ডপয়েন্টে কল করতে পারেন তা জানতে আগ্রহী হবেন। এখানে একটি কার্ল উদাহরণ. ইউআরএল-এ শুধু আপনার প্রতিষ্ঠান এবং পরিবেশের নামগুলি প্রতিস্থাপন করুন, এবং একটি মৌলিক প্রমাণীকরণ শিরোনামে কোলন-বিচ্ছিন্ন কনজিউমার কী: কনজিউমার সিক্রেট মানগুলি পাস করুন:

curl -i -X POST "http://[org]-[env].apigee.net/edgemicro-auth/token" -d '{ "client_id": "your consumer key", "client_secret": "your consumer secret", "grant_type": "client_credentials" }' -H "Content-Type: application/json"

কোথায়:

  • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
  • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
  • আপনার আগে তৈরি করা ডেভেলপার অ্যাপের গ্রাহক আইডি হল client_id ।
  • client_secret হল আপনার আগে তৈরি করা ডেভেলপার অ্যাপের কনজিউমার সিক্রেট।

আউটপুট (নমুনা)

কমান্ড, আপনি edgemicro টোকেন CLI কমান্ড ব্যবহার করেছেন বা কার্ল ব্যবহার করে এন্ডপয়েন্টকে ডাকা হোক না কেন, একটি স্বাক্ষরিত অ্যাক্সেস টোকেন প্রদান করে যা ক্লায়েন্ট কল করতে ব্যবহার করা যেতে পারে। এরকম কিছু:

MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFsnhB0Yvg6JKWxKWBDP9o
Xl96dtgH7xPFRqIU0zI452jkMQ1fPz2mSaGwik241yfBku7olooXKRKTRKOUoXa
q3Hld/RPxGSsWtiyyYtKex7tuFdq0Knm1EhowdTRGIgjNvudeYMka/XPRXuykhd 
xIDxWj4rdX+4GPx9qT2eTQC5nOAC7XHVL7ys4KqsAiv28vw10u400KstFFS8Qho 
7FaE0bOKLolKKadKyA60ha1XIw/uSTD6ZQFWQ+XM3OaRbXePWXnSZioSxXcZT7L 
hMUKbsRXw/TCvRB51LgNAgMBAAEwDQYJKoZIhvcNAQELBQADgEBAOuR1OmE/W6j 
gRAarJB5EQuTEpI/9Zpg5c5RAGjzLhkazsycn7pal+IymUjCV7D0oIxTVuTM8ZZ 
57kR5hF/C1ZypDN9i+KGP2ovX8WOCCXYtIQECgZPB/L/7/k7BDuKN4vFBvWUe3X 
s2oyjnVWy+ASqsW8gHfj8ekhe22bP240Oqkbyg9SZP9ol1tvJX6+M0thYwcTwAd 
ft929Icey/MOTQC0jB2qm0gnIx/7KInFXfS5KoFRJoGrWDeckr3RdBo2LhnPaeZ 
1gPYIqphZ3HfisF5KlBXoR8oT/Ilym/nq5COlv+3L4tMIk18F7BQZB60SRazifz 
pFkIxepyr/0=

3. এজ মাইক্রোগেটওয়েতে কনফিগারেশন পরীক্ষা করুন

  1. $HOME/.edgemicro/org-env-config.yaml ফাইলটি খুলুন। আপনি এই ফাইলটি সনাক্ত করতে না পারলে এজ মাইক্রোগেটওয়ে কোথায় ইনস্টল করা আছে তা দেখুন৷
  2. নিশ্চিত করুন যে এই oauth প্লাগইন বৈশিষ্ট্য মিথ্যা সেট করা আছে. এগুলি ডিফল্টরূপে মিথ্যা, তবে এটি দুবার চেক করা একটি ভাল ধারণা: 
    oauth:
   allowNoAuthorization: false
   allowInvalidAuthorization: false
  3. এছাড়াও org-env-config.yaml ফাইলে, নিশ্চিত করুন যে oauth প্লাগইনটি plugins:sequence এলিমেন্টে যোগ করা হয়েছে, যেমন:: 
    plugins:
   dir: ../plugins
   sequence:
   - oauth
  4. আপনি যদি ফাইলে কোনো পরিবর্তন করেন, তাহলে চলমান এজ মাইক্রোগেটওয়ে ইনস্ট্যান্সে পরিবর্তনগুলি পুনরায় লোড করুন । এই কমান্ডটি এজ মাইক্রোগেটওয়েকে শূন্য-ডাউনটাইমের সাথে পুনরায় কনফিগার করে: 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c39177d64a88754d615c74e1f78b6181d

4. নিরাপদে API কল করুন

হাতে একটি অ্যাক্সেস টোকেন সহ, আপনি এখন নিরাপদে API কল করতে পারেন। যেমন:

  curl -i -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhcHBsaWNhdGlvbl
9uYW1lIjoiYmU2YmZjYjAtMWQ0Ni00Y2IxLWFiNGQtZTMxNzRlNTAyMDZkIiwiY2xpZW50X2lkIjoiOGxTTTVIRHdyM
VhIT1ZwbmhURExhYW9FVG5STVpwWk0iLCJzY29wZXMiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIk1pY3JvZ2F0ZXdh
eVRlQcm9kdWN0Il0sImCI6MTQzNTM0NzY5MiwiZXhwIjoxNDM1MzQ5NDkxfQ.PL30Y6uK1W1f2ONPEsBDB_BT31c6
IsjWGfwpz-p6Vak8r767tAT4mQAjuBpQYv7_IU4DxSrnxXQ_q536QYCP4p4YKfBvyqbnW0Rb2CsPFziy_n8HIczsWO
s0p4czcK63SjONaUpxV9DbfGVJ_-WrSdqrqJB5syorD2YYJPSfrCcgKm-LpJc6HCylElFDW8dHuwApaWcGRSV3l5Wx
4A8Rr-WhTIxDTX7TxkrfI4THgXAo37p3au3_7DPB_Gla5dWTzV4j93xLbXPUbwTHzpaUCFzmPnVuYM44FW5KgvBrV0
64RgPmIFUxSqBWGQU7Z1w2qFmWuaDljrMDoLEreI2g" http://localhost:8000/hello/echo

API মক সার্ভার থেকে শিরোনাম এবং অন্যান্য তথ্য প্রদান করে।

একটি API কী দিয়ে API সুরক্ষিত করা

আপনি অনুমোদনের জন্য একটি API কী ব্যবহার করতে চাইলে এই পদক্ষেপগুলি অনুসরণ করুন:

1. API কী পান

  1. এজ UI-তে, আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন। অ্যাপটির নাম ছিল EdgeMicroTestApp।
  2. বিকাশকারী অ্যাপ পৃষ্ঠায়, উপভোক্তা কী দেখান এবং এটি অনুলিপি করুন। এই মান হল API কী। আপনি প্রমাণীকৃত API কল করতে এই কী ব্যবহার করবেন।

2. এজ মাইক্রোগেটওয়েতে কনফিগারেশন পরীক্ষা করুন

  1. $HOME/.edgemicro/org-env-config.yaml. আপনি এই ফাইলটি সনাক্ত করতে না পারলে এজ মাইক্রোগেটওয়ে কোথায় ইনস্টল করা আছে তা দেখুন৷
  2. নিশ্চিত করুন যে এই oauth প্লাগইন বৈশিষ্ট্য মিথ্যা সেট করা আছে. এগুলি ডিফল্টরূপে মিথ্যা, তবে আপনি চাইলে দুবার চেক করতে পারেন: 
    oauth:
   allowNoAuthorization: false
   allowInvalidAuthorization: false
  3. এছাড়াও org-env-config.yaml ফাইলে, নিশ্চিত করুন যে oauth প্লাগইনটি plugins:sequence এলিমেন্টে যোগ করা হয়েছে, যেমন:: 
    plugins:
   dir: ../plugins
   sequence:
   - oauth
  4. আপনি যদি ফাইলে কোনো পরিবর্তন করেন, তাহলে চলমান এজ মাইক্রোগেটওয়ে ইনস্ট্যান্সে পরিবর্তনগুলি পুনরায় লোড করুন । এই কমান্ডটি এজ মাইক্রোগেটওয়েকে শূন্য-ডাউনটাইমের সাথে পুনরায় কনফিগার করে: 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c30177d64a88754d615c74e1f78b6181d

3. একটি API কী দিয়ে নিরাপদে API-কে কল করুন

নিম্নরূপ x-api-কী হেডার সহ API-কে কল করুন। আপনি ডেভেলপার অ্যাপ থেকে কপি করেছেন কনজিউমার কী মান হল API কী। ডিফল্টরূপে, এজ মাইক্রোগেটওয়ে আশা করে যে আপনি x-api-key নামক একটি শিরোনামে কী পাস করবেন, যেমন:

curl -i http://localhost:8000/hello/echo -H "x-api-key: [apikey]"

কোথায়:

  • apikey হল EdgeMicroTestApp থেকে নেওয়া কনজিউমার কী মান।

যেমন:


curl -i http://localhost:8000/hello/echo -H 'x-api-key: XsU1R4zGXz2ERxd0ilYQ5szwuljr5bB'

আপনার কাছে এখন একটি সম্পূর্ণ কার্যকরী এবং নিরাপদ এজ মাইক্রোগেটওয়ে রয়েছে। টিউটোরিয়ালের পরবর্তী অংশে, আমরা এজ মাইক্রোগেটওয়েতে কার্যকারিতা যুক্ত প্লাগইনগুলির দিকে নজর দেব।

পার্ট 5: একটি স্পাইক অ্যারেস্ট প্লাগইন যোগ করুন

এই অংশে, আমরা এজ মাইক্রোগেটওয়ের আপনার উদাহরণে স্পাইক অ্যারেস্ট নামে একটি হার-সীমিত বৈশিষ্ট্য যুক্ত করব।

প্লাগইন কি?

একটি প্লাগইন হল একটি Node.js মডিউল যা এজ মাইক্রোগেটওয়েতে কার্যকারিতা যোগ করে। প্লাগইন মডিউলগুলি একটি সামঞ্জস্যপূর্ণ প্যাটার্ন অনুসরণ করে এবং এজ মাইক্রোগেটওয়েকে পরিচিত একটি অবস্থানে সংরক্ষণ করা হয়, মাইক্রোগেটওয়েকে সেগুলি স্বয়ংক্রিয়ভাবে আবিষ্কার এবং লোড করতে সক্ষম করে৷ আপনি প্লাগইন সম্পর্কে আরও পড়তে পারেন প্লাগইন ব্যবহার করুন ।

একটি স্পাইক গ্রেফতার প্লাগইন যোগ করা হচ্ছে

একটি স্পাইক অ্যারেস্ট প্লাগইন ট্রাফিক স্পাইক থেকে রক্ষা করে। এটি একটি এজ মাইক্রোগেটওয়ে উদাহরণ দ্বারা প্রক্রিয়াকৃত অনুরোধের সংখ্যাকে থ্রোটল করে।

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

  1. $HOME/.edgemicro/org-env-config.yaml. আপনি এই ফাইলটি সনাক্ত করতে না পারলে এজ মাইক্রোগেটওয়ে কোথায় ইনস্টল করা আছে ৷
  2. নিম্নলিখিত উপাদান যোগ করুন. আপনি ফাইলের যেকোনো জায়গায় এটি যোগ করতে পারেন। 
       spikearrest:
      timeUnit: minute   
      allow: 10   
      buffersize: 0
  3. edgemicro:sequence এলিমেন্টে spikearrest যোগ করুন, যেমনটি নিচে দেখানো হয়েছে। সিকোয়েন্স কনফিগারেশন প্রপার্টি এজ মাইক্রোগেটওয়েকে বলে যে ক্রমে প্লাগইন মডিউলগুলি চালানো হয়। 
    edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
  plugins:
    dir: ../plugins
  sequence:
    - oauth
    - spikearrest
  4. কনফিগার ফাইলটি সংরক্ষণ করুন।
  5. রিলোড কমান্ড দিয়ে এজ মাইক্রোগেটওয়ে রিলোড করুন। আপনি যে ডিরেক্টরি থেকে এজ মাইক্রোগেটওয়ে শুরু করেছেন সেখান থেকে আপনাকে অবশ্যই এই কমান্ডটি চালাতে হবে।
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    কোথায়:

    • org হল আপনার এজ প্রতিষ্ঠানের নাম (আপনাকে অবশ্যই একজন প্রতিষ্ঠান প্রশাসক হতে হবে)।
    • env হল আপনার প্রতিষ্ঠানের একটি পরিবেশ (যেমন পরীক্ষা বা পণ্য)।
    • key হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।
    • secret হল সেই কী যা পূর্বে কনফিগার কমান্ড দ্বারা ফেরত দেওয়া হয়েছিল।

    উদাহরণ

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c39177d64a88754d615c74e1f78b6181d
  6. দ্রুত ধারাবাহিকভাবে API-কে কয়েকবার কল করার চেষ্টা করুন। দ্বিতীয় কলের পরে, এজ মাইক্রোগেটওয়ে এই ত্রুটিটি ফেরত দেয়: 
    {"message":"SpikeArrest engaged","status":503}

কারণ হল যে স্পাইক অ্যারেস্ট নির্দিষ্ট সময়ের ইউনিটে করা কলের সংখ্যাকে মসৃণ করে। সুতরাং, এই ক্ষেত্রে, আপনি এক মিনিটে 10টি কল করতে পারেন, বা প্রতি 6 সেকেন্ডে একটি কল করতে পারেন৷

অতিরিক্ত ক্রেডিট: কোটা প্লাগইন যোগ করা হচ্ছে

স্পাইক অ্যারেস্ট কনফিগার করতে ব্যবহৃত একই প্যাটার্ন অনুসরণ করে, আপনি কোটা প্লাগইন এর মত অন্যান্য প্লাগইন যোগ করতে পারেন। স্পাইক অ্যারেস্টের মতো, কোটা প্লাগইনটি প্রতিটি এজ মাইক্রোগেটওয়ে ইনস্টলেশনের সাথে অন্তর্ভুক্ত করা হয়েছে। একটি কোটা নির্দিষ্ট সময়ের ব্যবধানে (মিনিট বা ঘন্টা) একটি এপিআই-এ জমা দেওয়ার অনুমতিপ্রাপ্ত অনুরোধ বার্তাগুলির সংখ্যা নির্দিষ্ট করে৷

পার্ট 6: Apigee Edge-এ বিশ্লেষণ দেখা

আমাদের কাছে এখন একটি সম্পূর্ণরূপে কার্যকরী এজ মাইক্রোগেটওয়ে উদাহরণ রয়েছে, আসুন দেখি এটি কী হয়েছে! ডিফল্টরূপে, বিশ্লেষণ প্লাগইন মডিউল এজ মাইক্রোতে যোগ করা হয়। এই মডিউলটি নিঃশব্দে এজ মাইক্রো থেকে এপিজি প্রান্তে বিশ্লেষণ ডেটা পুশ করে, যেখানে এটি এজ অ্যানালিটিক্স সিস্টেম দ্বারা গ্রাস করা হয়। চলুন দেখা যাক:

  1. Apigee Edge এ আপনার প্রতিষ্ঠানে লগ ইন করুন।
  2. বিশ্লেষণ > প্রক্সি পারফরম্যান্স নির্বাচন করুন।
  3. প্রক্সি পারফরম্যান্স ড্যাশবোর্ডে, edgemicro_hello প্রক্সি নির্বাচন করুন।
  4. গ্রাফটি আপনাকে প্রক্সির ট্রাফিক প্যাটার্ন সম্পর্কে তথ্য দেখায়, যেমন মোট ট্রাফিক, গড় প্রতিক্রিয়া সময়, গড় লক্ষ্য প্রতিক্রিয়া সময় এবং আরও অনেক কিছু।

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