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

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

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

ওভারভিউ

এই টিউটোরিয়ালটি আপনাকে এজ মাইক্রোগেটওয়ে আপ এবং রান করার একটি উদাহরণ পেতে প্রয়োজনীয় পদক্ষেপের মধ্য দিয়ে চলে।

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

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

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

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

আপনার ইনস্টলেশন শেষ হলে, পরবর্তী বিভাগে যান, " অংশ 1: ​​এজ মাইক্রোগেটওয়ে কনফিগার করুন "।

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

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

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

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

  1. আপনি যদি এটি আগে না করে থাকেন তবে এজ মাইক্রোগেটওয়ে শুরু করুন (আপনাকে শুধুমাত্র একবার এই পদক্ষেপটি করতে হবে):
    edgemicro init
  2. (ঐচ্ছিক) এজমাইক্রো কনফিগার কমান্ডের জন্য প্রিন্ট সহায়তা:
    edgemicro configure -h
  3. এজ মাইক্রোগেটওয়ে কনফিগার করতে নিম্নলিখিত কমান্ডটি চালান:
    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 v6.1.0
current edgemicro version is 2.2.3-beta
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
creating vault
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/wwitman-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCaDpaTttaDANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3QwHhcNMTYxAxMjA0NzIyWhcNMTYxMTAyMjA0NzIyWjAUMRIwEAYD
VQQDEwlsb2NhbGhvcwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDA
YbtbsFe50GgBrI8QTih5yzxxxvCfdubGrLWmovwwCCFthno3u8lS54ekOL9jQu
JTJsocJfNhZxvnXifDsCk5Muwx87Z/D0BYLw9ZhM8TMyA2MCkXgC6RfKT69IdJ
jT3X+3D0s+apr3lACsDhgOfaeQfeHAm1SSwH/VemaJqdImGkQMtM8uscMDwG6k
vBbCSNS+hh6ZH1m3tAkcKXqvj/E1hbrHNTWr+uiYFRByUzeo1I607daQD4Lxid
il4Ng3hr3LC1gEzvobWgVyhQ2ovYB57T886H7dGghTnOUxLm2y/TwmQya+44SL
JSsDwauArMF38cRKZZ7VAgMBAAEwDQYJKoZIhvcNAQELBQADEBAHwwu+gOn8Tq
jKOYBTXtOX11HPMTxmyvZ/I57R4roE7Z/lXg/DXwbiFpFG2uamXNKq7yTDJH2i
iiqdERZOGfv7TJMjRlxEnfVHoCV7UKguKq4zeeAEU2x55yFwpWNrarx0kMXRwI
v3WgGfo2bimFQrCjDCNIkDKmYYt4SXIF5zUJmBWPCaK9aJoQb7ARXQO9s2zoOI
XZ5bCUDbehQZ+6LyqC0hgDXiIZYy7R0j93yCbQgoHaHUMEprJEEjE24SHdsWBO
nxGZxB20JLq5AHTm8lbZp7XtvbU0jVpxyrBo2/olFnmpvBVOq9eIp042IVD7nT
J4rPejdK6C4=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: e88ec9d5da17cd88ca338d532b7c7a8c4f43ddd3da139d95955ab345af30352d
  secret: d7f64854eb6889d06b809dd7c161dba5eeba4a2657277fd819921bf992221a8f

edgemicro configuration complete!

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

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

  1. এজমাইক্রো প্রাইভেট কনফিগার কমান্ডের জন্য সাহায্য তথ্য মুদ্রণ করুন। আপনি যেকোনো এজ মাইক্রোগেটওয়ে সিএলআই কমান্ড বা কমান্ড বিকল্পের জন্য এইভাবে সাহায্য প্রিন্ট করতে পারেন। 
    edgemicro private configure -h
  2. নিম্নলিখিত কমান্ডটি চালান। এটির জন্য আপনার 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 vault creating vault adding private_key adding public_key
configuring host http://192.168.52.106:9001 for region dc-1

saving configuration information to: /Users/ApigeeCorporation/.edgemicro/jdoe-test-config.yaml 
vault info: 
-----BEGIN CERTIFICATE----- 
MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWxKWBDP9o 
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: a3f8f3dfe39158fc3c50b274f0af2234246e0d5f6ea4dd09389b645147151ba3 
   secret: 3e9904802fb3c0e8ca408128a11119cf13546d54dac30ace944c097a726a1263

edgemicro configuration complete!

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

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

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

কোথায়:

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

উদাহরণ 

edgemicro verify -o docs -e test -k 93b01fd21d86331459ae52f664ae9aeb13eb94767ce40a4f621d172cdfb7e8e6 -s c8c755be97cf56c21f8b0556d7132afbd03625bbd85dc34ebfefae4f23fbcb3c

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

এ পর্যন্ত করা সমস্ত কনফিগারেশন এজ মাইক্রোগেটওয়েকে অ্যাপিজি এজে বুটস্ট্র্যাপ করার অনুমতি দেয়। বুটস্ট্র্যাপিং সফল হওয়ার পরে, এজ মাইক্রোগেটওয়ে 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. এজ ক্লাসিক UI-তে যেতে SWITCH TO CLASSIC-এ ক্লিক করুন।
  3. শীর্ষ মেনু থেকে APIs > API প্রক্সি নির্বাচন করুন।
  4. API প্রক্সি পৃষ্ঠায়, + API প্রক্সিতে ক্লিক করুন।
  5. বিল্ড এ প্রক্সি উইজার্ডে, রিভার্স প্রক্সি (সবচেয়ে সাধারণ) নির্বাচন করুন।
  6. পরবর্তী ক্লিক করুন.
  7. উইজার্ডের বিবরণ পৃষ্ঠায়, নিম্নরূপ কনফিগার করুন। দেখানো হিসাবে ঠিক উইজার্ড পূরণ করতে ভুলবেন না:
    • প্রক্সি নাম: edgemicro_hello
    • প্রক্সি বেস পাথ: /হ্যালো
    • বিদ্যমান API: http://mocktarget.apigee.net/
  8. পরবর্তী ক্লিক করুন.
  9. উইজার্ডের নিরাপত্তা পৃষ্ঠায়, পাস থ্রু (কোনটি নয়) নির্বাচন করুন।
  10. পরবর্তী ক্লিক করুন.
  11. উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, ডিফল্টগুলি গ্রহণ করুন।
  12. পরবর্তী ক্লিক করুন.
  13. উইজার্ডের বিল্ড পৃষ্ঠায়, আপনার প্রক্সি সেটিংস পর্যালোচনা করুন। পরীক্ষা পরিবেশ নির্বাচন করা হয়েছে তা নিশ্চিত করুন।
  14. Build and Deploy এ ক্লিক করুন।

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

দুটি প্রক্সি রয়েছে এমন একটি পণ্য তৈরি করুন:

  • আপনার মাইক্রোগেটওয়ে-সচেতন প্রক্সি: edgemicro_hello
  • এজ মাইক্রোগেটওয়ে দ্বারা ইনস্টল করা প্রমাণীকরণ প্রক্সি: edgemicro-auth ।
  1. এজ UI (ক্লাসিক সংস্করণ) এ, Publish > Products- এ যান।
  2. পণ্য পৃষ্ঠায়, + পণ্য ক্লিক করুন। নিম্নরূপ পণ্য বিবরণ পৃষ্ঠাটি পূরণ করুন:
    • নাম: EdgeMicroTestProduct
    • প্রদর্শনের নাম: EdgeMicroTestProduct
    • পরিবেশ: পরীক্ষা এবং পণ্য
    • প্রবেশাধিকার: সর্বজনীন
    • কী অনুমোদনের ধরন: স্বয়ংক্রিয়
    • সম্পদ:
      • API প্রক্সি: edgemicro_hello নির্বাচন করুন
      • রিভিশনঃ ১
      • সম্পদ পথ: /**
  3. রিসোর্স আমদানিতে ক্লিক করুন।
  4. রিসোর্সে, +API প্রক্সিতে ক্লিক করুন
  5. edgemicro-auth নির্বাচন করুন
  6. Save এ ক্লিক করুন।

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

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

  1. Publish > Developers- এ যান।
  2. পণ্য পৃষ্ঠায়, + বিকাশকারীতে ক্লিক করুন।
  3. একটি পরীক্ষা বিকাশকারী তৈরি করতে ডায়ালগটি পূরণ করুন৷

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

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

  1. Publish > ডেভেলপার অ্যাপে যান।
  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: da4778e7c240a5d4585fc559eaba5083328828ac9f3a7f583e8b73e
secret: 3aad7439708b4aeb38ee08e87189921ad00e6fc1ba8a8ae9f929ee2
  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

    আউটপুট

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

    ...

PROCESS PID : 9757
installed plugin from analytics
installed plugin from oauth
eb725020-a2b0-11e6-8a52-6de156e3a6e2 edge micro listening on port 8000
installed plugin from analytics
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
eb77ce60-a2b0-11e6-8a88-b96278c0c198 edge micro listening on port 8000
eb78b8c0-a2b0-11e6-bf36-717b986c91fe edge micro listening on port 8000
eb77f570-a2b0-11e6-883e-472b9104351e edge micro listening on port 8000

কি হয়েছে?

টার্মিনালটি দেখুন যেখানে আপনি edgemicro config কমান্ডটি চালান। স্ট্যান্ডার্ড আউটপুটের মাধ্যমে স্ক্রোল করলে, আপনি দেখতে পাবেন যে কমান্ডটি এপিজি এজ থেকে এজ মাইক্রোগেটওয়ে কনফিগারেশন তথ্যের একটি পেলোড পুনরুদ্ধার করে। এই তথ্য অন্তর্ভুক্ত:

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

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

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-তে, আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন, যেমনটি পার্ট 2-এ বর্ণিত হয়েছে: Apigee Edge-এ সত্তা তৈরি করুন । অ্যাপটির নাম ছিল 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 v4.4.4
{ token: 'eyJ0eXAiOiJKV1QiLCJhbGciSUzI1NiJ9.eyJhcHBsaWNhdGl
vbl9uYW1lIjoiNWNiMGY0tOWMzOC00YmJjLWIzNzEtZGMxZTQzOGYxZGMxI
iwiY2xpZW50X2lkIjoiNVVdBWEdvSU9lbzYwYWV3OTRQN0c1TUFaRTNhSnA
iLCJzY29wZXMiOltdLCJhcGlfcHJvjdF9saXN0IjpbIkVkZ2VNaWNyb1Rlc
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+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWxKWBDP9o 
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=

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

  1. ~ /.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.PN30Y6uK1W1f2ONPEsBDB_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-তে, আপনার পূর্বে তৈরি করা ডেভেলপার অ্যাপে নেভিগেট করুন, যেমনটি পার্ট 2-এ বর্ণিত হয়েছে: Apigee Edge-এ সত্তা তৈরি করুন । অ্যাপটির নাম ছিল EdgeMicroTestApp।
  2. বিকাশকারী অ্যাপ পৃষ্ঠায়, উপভোক্তা কী দেখান এবং এটি অনুলিপি করুন। এই মান হল API কী। আপনি প্রমাণীকৃত API কল করতে এই কী ব্যবহার করবেন।

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

  1. ~ /.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

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: XsU1R4zGXz2ERxa0ilYQ5szwuljr5bB'

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

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

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

প্লাগইন কি?

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

স্পাইক অ্যারেস্ট প্লাগইন যোগ করা হচ্ছে

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

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

  1. ~ /.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:
    - spikearrest
    - oauth
  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. গ্রাফটি আপনাকে প্রক্সির ট্রাফিক প্যাটার্ন সম্পর্কে তথ্য দেখায়, যেমন মোট ট্রাফিক, গড় প্রতিক্রিয়া সময়, গড় লক্ষ্য প্রতিক্রিয়া সময় এবং আরও অনেক কিছু।

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