আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
শুরু করা
- আমি কীভাবে Edge Microgateway ইনস্টল করব?
- Edge Microgateway ইনস্টল করা দেখুন।
- আমি কীভাবে Edge Microgateway চালাব?
- Edge Microgateway সেট-আপ ও কনফিগার করা দেখুন।
- Microgateway চালানোর জন্য আমার কি ডেটাবেস প্রয়োজন?
- Edge Microgateway-এর মাধ্যমে প্রক্সি করা API, টার্গেট পরিষেবার অংশ হিসেবে রান করা ডেটাবেসের সাথে ইন্টার্যাক্ট করতে পারে। তবে, Edge Microgateway কোনও ডেটাবেস বা ব্যাকএন্ড ডেটা স্টোর থেকে স্বাধীনভাবে কাজ করে।
অপারেশন
- Edge-এ কী কী পরিবর্তন করলে Edge Microgateway রিস্টার্ট করতে হয়?
- Apigee Edge-এ করা পরিবর্তনগুলি Edge Microgateway অটোমেটিক পোল করে, যেমন
মাইক্রোগেটওয়ে-অ্যাওয়ার প্রক্সি, প্রোডাক্ট বা ডেভেলপার
অ্যাপে করা পরিবর্তন। ডিফল্ট পোলিং ইন্টারভ্যাল হল ৬০০ সেকেন্ড; তবে, আপনি
config_change_poll_intervalকনফিগারেশন সেটিংয়ের মাধ্যমে ইন্টারভ্যাল পরিবর্তন করতে পারবেন। edgemicro অ্যাট্রিবিউট দেখুন। - আপনি পোলিং ইন্টারভ্যালের জন্য অপেক্ষা করতে না চাইলে, লেটেস্ট পরিবর্তন পেতে
edgemicro reloadকমান্ড ব্যবহার করুন। দেখুন মাইক্রোগেটওয়ে ক্লাস্টার আবার লোড করা। - Edge-এ ডিপ্লয় করা প্রক্সি এবং Edge Microgateway-তে থাকা প্রক্সির মধ্যে পার্থক্য কীভাবে বুঝব?
- আপনি Edge Microgateway কনফিগার করলে, Apigee
Edge-এ ডেপ্লয় করা মাইক্রোগেটওয়ে-অ্যাওয়ার প্রক্সির একটি তালিকা Edge Microgateway-এর লোকাল কনফিগারেশনে ডাউনলোড করা হয়। মাইক্রোগেটওয়ে-অ্যাওয়ার প্রক্সি
হল সেইসব প্রক্সি যেগুলির নামের আগে
edgemicro_প্রিফিক্স থাকে। - Edge Microgateway-তে লগ-ইন করার জন্য আমার কাছে কী কী বিকল্প আছে?
- Edge Microgateway-তে বিল্ট-ইন লগিং ফিচার আছে। আরও বিবরণের জন্য, লগ ফাইল ম্যানেজ করা দেখুন।
- এছাড়াও, Edge Microgateway-এর সাথে থার্ড-পার্টি লগিং পরিষেবা ব্যবহার করতে, আপনি একটি কাস্টম প্লাগ-ইন লিখতে পারেন। Edge Microgateway যেভাবে কাজ করে, সেই কারণে আপনি Edge Microgateway-এর জন্য মেসেজ লগ করতে Apigee Edge-এর মেসেজ লগিং নীতি ব্যবহার করতে পারবেন না। এছাড়াও, Microgateway-এর জন্য লগিং প্লাগ-ইন কমিউনিটি নিবন্ধটি দেখুন।
- Edge Microgateway-এর একাধিক ইনস্ট্যান্সের মধ্যে কী/সিক্রেট কম্বিনেশন কি আবার ব্যবহার করা যায়?
- মাইক্রোগেটওয়ে ইনস্ট্যান্সের জন্য সংস্থা ও এনভায়রনমেন্ট একই থাকলে, আপনি কনফিগারেশনের সময় তৈরি হওয়া কী/সিক্রেট পেয়ার আবার ব্যবহার করতে পারবেন।
- প্রোডাকশন এনভায়রনমেন্টে চালু করার জন্য আমি কীভাবে Edge Microgateway কনফিগার করব?
- আপনি স্টার্ট-আপ কমান্ড প্যারামিটারের জন্য এনভায়রনমেন্ট ভেরিয়েবল সেট করতে পারবেন, যেমন
EDGEMICRO_KEY,EDGEMICRO_SECRET,EDGEMICRO_ORGএবংEDGEMICRO_ENV। এইসব (এবং অন্যান্য) ভেরিয়েবল ব্যবহার করে আপনিedgemicro startকমান্ডের মাধ্যমে Edge Microgateway শুরু করতে পারবেন। এছাড়াও এনভায়রনমেন্ট ভেরিয়েবল সেট করা দেখুন। - আমি কি Edge Microgateway-এর সাথে কাস্টম প্রোডাক্ট বা ডেভেলপার অ্যাপ অ্যাট্রিবিউট ব্যবহার করতে পারি?
- না। ডিফল্ট হিসেবে, Edge Microgateway শুধুমাত্র প্রাথমিক রাউটিং ও
নিরাপত্তা সংক্রান্ত অ্যাট্রিবিউট অনুযায়ী কাজ করে। তবে, বিকল্প হিসেবে, আপনার কাছে নিম্নলিখিত সম্ভাব্য বিকল্প আছে:
-
Edge Microgateway, Apigee
Edge-এ যে
edgemicro-authপ্রক্সি ডেপ্লয় করে তাতে কাস্টম অ্যাট্রিবিউট যোগ করুন। API কী বা OAuth টোকেন নিরাপত্তা ব্যবহার করার সময় এইসব অ্যাট্রিবিউট উপলভ্য হবে। - সেইসব অ্যাট্রিবিউট অনুযায়ী কাজ করতে OAuth প্লাগ-ইন পরিবর্তন করুন।
-
Edge Microgateway, Apigee
Edge-এ যে
- অনুরোধের হেডার সাইজের কি কোনও সীমা আছে?
- আপনি Node.js-কে v8.14.0 বা এর পরের যেকোনও ভার্সনে আপগ্রেড করলে, মনে রাখবেন যে অনুরোধে অনুমোদিত সর্বাধিক হেডার সাইজ ৮০কেবি থেকে কমিয়ে ৮কেবি করা হয়েছে। ৮ কেবির বেশি হেডার থাকলে HTTP 431 সমস্যা হয়।
- Node.js v11.6.0-এ যোগ করা Node.js কনফিগারেশন বিকল্প আপনাকে ডিফল্ট সর্বাধিক
হেডার সাইজ পরিবর্তন করতে দেয়। এই প্যারামিটার,
--max-http-header-size, আপনাকে HTTP হেডার সর্বাধিক সাইজ, বাইটে, নির্দিষ্ট করতে দেয়। - ডিফল্ট কনফিগারেশন পরিবর্তন করতে, কমান্ড লাইনে
NODE_OPTIONSএনভায়রনমেন্ট ভেরিয়েবলের ভ্যালু নিচে উল্লেখ করা পদ্ধতি অনুযায়ী সেট করুন:NODE_OPTIONS=--max-http-header-size=NUM_BYTES
যেমন:
NODE_OPTIONS=--max-http-header-size=80000
Edge Microgateway কোন ম্যানেজমেন্ট API ব্যবহার করে?
নিচে উল্লেখ করা Edge Microgateway কমান্ডগুলি তাদের কাজ করার জন্য Apigee Edge ম্যানেজমেন্ট API-কে কল করে, যেমন Edge Microgateway-এর জন্য CLI রেফারেন্সে বর্ণনা করা হয়েছে:
edgemicro configureedgemicro upgradeauthedgemicro upgradekvmedgemicro rotatekeyedgemicro cert checkedgemicro cert deleteedgemicro cert install
নিচে উল্লেখ করা বিভাগে ম্যানেজমেন্ট API কলের তালিকা দেওয়া আছে যা প্রতিটি কমান্ড ব্যবহার করে।
edgemicro configure ও upgradeauth কমান্ড নিম্নলিখিত ম্যানেজমেন্ট API-কে কল করে:
- (ডেপ্লয়মেন্টের তালিকা)
GET: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/deployments - (get deployment info)
GET: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=java&name=micro-gateway-products-javacallout-2.0.0.jar - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=adjust-quota.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=generate-jwk.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=generate-verify-jwt.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=jsrsasign-all-min.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=jwt-initialization.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=send-jwk-response.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=send-product-list.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=send-public-key.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=set-jwt-variables.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=set-quota-variables.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=set-response.js - (রিসোর্স আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=validate-params.js - (create api proxy)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis?action=import&validate=false&name=edgemicro-auth - (আপলোড নীতি)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/policies - (প্রক্সি আপলোড করুন)
POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/proxies?name=default - (প্রক্সি ডেপ্লয় করা)
POST: https://api.enterprise.apigee.com/v1/o/[org]/e/[env]/apis/edgemicro-auth/revisions/1/deployments
upgradekvm কমান্ড নিম্নলিখিত ম্যানেজমেন্ট API কল করে:
PUT: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway
rotatekey কমান্ড নিম্নলিখিত ম্যানেজমেন্ট API কল করে:
GET: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway/entries/private_key
cert check কমান্ড নিম্নলিখিত ম্যানেজমেন্ট API কল করে:
GET: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway
cert delete কমান্ড নিম্নলিখিত ম্যানেজমেন্ট API কল করে:
DELETE: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway
cert install কমান্ড নিম্নলিখিত ম্যানেজমেন্ট API কল করে:
POST: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps
ডিপ্লয়মেন্ট
- আমার টার্গেট পরিষেবা যে সার্ভারে চলছে, আমি কি সেই একই সার্ভারে Edge Microgateway ডিপ্লয় করতে পারি?
- হ্যাঁ। Edge Microgateway হল একটি হালকা প্রসেস যা আপনার টার্গেট পরিষেবার কাছাকাছি রান করতে পারে, যার মধ্যে একই মেশিনে রান করাও অন্তর্ভুক্ত।
- আমি কি Edge Microgateway ডিপ্লয়মেন্ট হিসেবে আগে থেকে থাকা Edge প্রক্সি বান্ডেল ডিপ্লয় করতে পারি?
- না। Edge Microgateway-সচেতন প্রক্সির নির্দিষ্ট প্রয়োজনীয়তা আছে এবং এটি সাধারণ Edge প্রক্সির সব ফিচার সাপোর্ট করে না। পার্ট ২: Apigee Edge-এ এন্টিটি তৈরি করা দেখুন
- একই API প্রক্সির জন্য Edge প্রক্সি বান্ডেল ডেপ্লয়মেন্ট ও Edge Microgateway ডেপ্লয়মেন্টের মধ্যে কি আমি ফেলওভার চালু করতে পারি?
- না। Edge Microgateway, Apigee Edge-এ নন-মাইক্রোগেটওয়ে API প্রক্সি ডেপ্লয়মেন্ট সম্পর্কে জানে না।
- Edge Microgateway-এর জন্য হাই অ্যাভেলিবিলিটি ডিপ্লয়মেন্ট মডেল কী?
- লোড ব্যালেন্সার হিসেবে NGINX ব্যবহার করে Edge Microgateway কীভাবে রান করাতে হয় সেই বিষয়ে ভাল আলোচনা পেতে, দেখুন Apigee Edge Microgateway ও NGINX-এর মাধ্যমে API ম্যানেজ করা।
- Edge Microgateway-এর সাথে আমি কোন লোড ব্যালেন্সার ব্যবহার করতে পারি?
- Edge Microgateway যেকোনও লোড ব্যালেন্সারের সাথে কাজ করতে পারে।
- আমি কতগুলি Edge Microgateway প্রক্সি ডেপ্লয় করতে পারব তার কি কোনও সীমা আছে?
- সাধারণ Edge প্রক্সির জন্য নির্দিষ্ট করা প্রোডাক্ট কনফিগারেশন সীমা দেখুন। Apigee Edge সংস্থা ও এনভায়রনমেন্টে আপনি যতগুলি মাইক্রোগেটওয়ে-অ্যাওয়ার প্রক্সি ডেপ্লয় করতে পারবেন এবং Edge মাইক্রোগেটওয়ের মাধ্যমে কল করতে পারবেন, সেগুলির সংখ্যা একই সীমার মধ্যে থাকতে হবে।
- আমি কি Edge Microgateway ডিপ্লয়মেন্টকে নির্দিষ্ট কোনও সংস্থা ও এনভায়রনমেন্টের সাথে অ্যাসোসিয়েট করতে পারি?
- Edge Microgateway-এর কোনও ইনস্ট্যান্স কনফিগার করার সময় আপনাকে অবশ্যই এটিকে নির্দিষ্ট Edge সংস্থা ও এনভায়রনমেন্টের সাথে অ্যাসোসিয়েট করতে হবে।
- আমি কি Edge Microgateway ডিপ্লয়মেন্টকে কোনও নির্দিষ্ট অঞ্চলের সাথে অ্যাসোসিয়েট করতে পারি (যদি আমি একাধিক অঞ্চলের গ্রাহক হই)?
- Apigee Edge-এর সাথে ইন্টার্যাকশনের জন্য Edge Microgateway অটোমেটিক সেরা অঞ্চল বেছে নেয়। আপনি পরিষেবা দিতে চান এমন প্রতিটি অঞ্চলে Edge Microgateway ইনস্ট্যান্স ডেপ্লয় করতে পারবেন।
প্রশাসন
- Edge Microgateway কনফিগার ও ডেপ্লয় করার জন্য আমাকে কি কোনও সংস্থার অ্যাডমিনিস্ট্রেটর হতে হবে?
- হ্যাঁ। Edge Microgateway কনফিগার ও ডেপ্লয় করার জন্য আপনার কাছে অর্গানাইজেশন অ্যাডমিনের ক্রেডেনশিয়াল থাকতে হবে।
- Edge Microgateway চালানোর জন্য আমাকে কি কোনও সংস্থার অ্যাডমিনিস্ট্রেটর হতে হবে?
- না। Edge Microgateway হল একটি
Node.jsঅ্যাপ্লিকেশন এবং কোনও মেশিনে এই ধরনের অ্যাপ্লিকেশন চালানোর অনুমতি আছে এমন যেকোনও ব্যক্তি এটি চালাতে পারেন। - আমার সংস্থার ব্যবহারকারীদের মধ্যে কেউ কি Edge Microgateway ব্যবহার করতে পারবেন?
- Edge Microgateway-এর মাধ্যমে API কল করার জন্য আপনাকে Apigee Edge সংস্থার ব্যবহারকারী হতে হবে না। তবে, Edge-এ ডেপ্লয় করা Edge Microgateway অ্যাওয়্যার প্রক্সি তৈরি বা পরিবর্তন করার জন্য আপনার কাছে অবশ্যই সংস্থা-লেভেল অনুমতি থাকতে হবে।
পারফর্ম্যান্স
- Edge Microgateway ব্যবহার করার সময় পারফর্ম্যান্স সংক্রান্ত কী কী বিষয় বিবেচনা করতে হবে?
- টার্গেট অ্যাপ্লিকেশনের সাথে Edge Microgateway কোলোকেট করা হলে, সার্ভারের যথেষ্ট ক্যাপাসিটি আছে কিনা তা নিশ্চিত করুন।
- Edge Microgateway-কে বড় স্কেলে চালানোর জন্য পেশাদার পদ্ধতি কী কী?
- Apigee, NGINX-এর মতো লোড ব্যালেন্সার দ্বারা ফ্রন্ট-এন্ডেড বিভিন্ন সার্ভারে Edge Microgateway-এর একাধিক ইনস্ট্যান্স চালানোর সাজেশন দেয়। এছাড়াও দেখুন Apigee Edge Microgateway ও NGINX-এর মাধ্যমে API ম্যানেজ করা এবং Apigee কমিউনিটিতে ভার্টিক্যাল হরাইজন্টাল স্কেলিং।
- Edge Microgateway-এর ডিফল্ট TPS কত এবং Microgateway ইনস্ট্যান্সের জন্য কী কী হার্ডওয়্যার প্রয়োজন
- Edge Microgateway-এর মাধ্যমে হার্ডওয়্যার সংক্রান্ত প্রয়োজনীয়তা ও TPS পরিমাপ করা কঠিন। এটি আপনার সেট-আপের উপর নির্ভর করে, যা Edge Microgateway টিউনিং, প্লাগ-ইন ব্যবহার, কাস্টম প্লাগ-ইন এবং TLS-এর মতো অন্যান্য জিনিস কনফিগার করার একটি সংমিশ্রণ। Apigee সাধারণত সাজেস্ট করে যে আপনি আইটেমের সেইসব কম্বিনেশন সম্পর্কে একটি ধারণা পান এবং আপনার নির্দিষ্ট সেট-আপের সাথে পারফর্ম্যান্স টেস্টিং করুন।
প্রাইভেট ক্লাউড ডিপ্লয়মেন্ট
- Edge Microgateway কি Edge for Private Cloud-এর সাথে কাজ করে?
- হ্যাঁ। বিস্তারিত জানতে, Apigee প্রাইভেট ক্লাউড কনফিগারেশন সংক্রান্ত ধাপ দেখুন।
প্লাগ-ইন
- Edge Microgateway-এর মাধ্যমে কোটা কীভাবে প্রয়োগ করা হয়?
- আপনি চাইলে Edge Microgateway-এর ইনস্ট্যান্সে কোটা প্লাগ-ইন যোগ করতে পারেন। আরও বিবরণের জন্য কোটা প্লাগ-ইন ব্যবহার করা দেখুন।
- Edge Microgateway-এর মাধ্যমে কীভাবে Spike Arrest এনফোর্স করা হয়?
- আপনি চাইলে Edge Microgateway-এর ইনস্ট্যান্সে স্পাইক অ্যারেস্ট প্লাগ-ইন যোগ করতে পারেন। আরও বিবরণের জন্য স্পাইক অ্যারেস্ট প্লাগ-ইন ব্যবহার করা দেখুন।
- Edge Microgateway-এর জন্য
Node.jsছাড়া অন্য কোনও উপায়ে কি প্লাগ-ইন লেখা যায়? - না। প্লাগ-ইন
Node.js-এ লিখতে হবে। - Edge Microgateway, Edge-এ Analytics ডেটা আপলোড করতে না পারলে কী হয়?
- Edge Microgateway-তে ইন-মেমরি বাফার আছে। বাফার ভর্তি হয়ে গেলে, API ট্রাফিক মসৃণভাবে প্রবাহিত হতে দেওয়ার জন্য পুরনো পে-লোড বাদ দেওয়া হয়।
- আমি কি Edge Microgateway-তে নীতি যোগ করতে পারি?
- আপনি যদি Apigee Edge-এ মাইক্রোগেটওয়ে-অ্যাওয়ার
প্রক্সি সার্ভারে সাধারণ Apigee Edge নীতি অ্যাটাচ করেন, তাহলে সেগুলি উপেক্ষা করা হয়। এর পরিবর্তে, Edge Microgateway, Edge-এর নীতির মতো কোটা, স্পাইক অ্যারেস্ট, API কী নিরাপত্তা এবং
OAuth2 নিরাপত্তার মতো কার্যকারিতা প্রদান করতে প্লাগ-ইন ব্যবহার করে। এছাড়াও, আপনি কাস্টম প্লাগ-ইন লিখতে পারবেন। প্লাগ-ইন ব্যবহার করা এবং
কাস্টম প্লাগ-ইন ডেভেলপ করা দেখুন।
নিম্নলিখিত Apigee কমিউনিটি পোস্ট ও ব্লগে অতিরিক্ত প্লাগ-ইন ব্যবহারের সম্ভাব্য পরিস্থিতি নিয়ে আলোচনা করা হয়েছে:
নিরাপত্তা
- আমি কীভাবে
/productsরিসোর্স সুরক্ষিত রাখব? - এক নজরে
- আপনি Edge Microgateway কনফিগার করলে,
Apigee Edge-এ আপনার সংস্থা:পরিবেশে
edgemicro-authনামের একটি API প্রক্সি ডেপ্লয় করা হয়। এই প্রক্সি একটি/productsএন্ডপয়েন্ট এক্সপোজ করে যা API প্রোডাক্টের একটি তালিকা রিটার্ন করে। আপনি যদি ৫ অক্টোবর, ২০১৮ তারিখে বা তার আগে Edge Microgateway ইনস্টল করে থাকেন, তাহলে Apigee সাজেস্ট করে যে এই এন্ডপয়েন্ট সুরক্ষিত করার জন্য পদক্ষেপ নিন, কারণ উত্তরে সেই ডেভেলপারের ইমেল আইডি থাকে যিনি আপনার Apigee সংস্থায় API প্রোডাক্ট তৈরি ও পরিবর্তন করেছেন। - Edge Microgateway আপগ্রেড করে অথবা মিউচুয়াল TLS কনফিগার করে আপনি এন্ডপয়েন্ট সুরক্ষিত করতে পারবেন। এইসব বিকল্পের বর্ণনা নিচে দেওয়া হল।
/productsএন্ডপয়েন্ট সুরক্ষিত কিনা তা চেক করুন-
/productsএন্ডপয়েন্ট সুরক্ষিত কিনা সেই ব্যাপারে নিশ্চিত না হলে,/productsরিসোর্স সুরক্ষিত কিনা তা যাচাই করুন বিভাগে যান এবং চালিয়ে যাওয়ার আগে সেখানে উল্লেখ করা ধাপগুলি সম্পূর্ণ করুন।বিকল্প ১: Edge Microgateway আপগ্রেড করা
আপনি যদি ৫ অক্টোবর, ২০১৮ তারিখে বা তার আগে Edge Microgateway ইনস্টল করে থাকেন, তাহলে Apigee সাজেস্ট করে যে আপনি Edge Microgateway-এর লেটেস্ট ভার্সনে আপগ্রেড করুন। আপনার ইন্টারনেট কানেকশন থাকলে Edge Microgateway আপগ্রেড করা লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।
আপনি এই মুহূর্তে আপগ্রেড করতে না পারলে, বিকল্প ২-এ যান।
বিকল্প ২: মিউচুয়াল TLS কনফিগার করা
আপনি এই মুহূর্তে Edge Microgateway আপগ্রেড করতে না পারলে, Edge Microgateway ও
edgemicro-authপ্রক্সির মধ্যে পারস্পরিক TLS (এটি টু-ওয়ে TLS নামেও পরিচিত) ব্যবহার করে যোগাযোগ সুরক্ষিত করার জন্য Apigee সাজেস্ট করে।- ফাইল
$HOME/.edgemicro/org-env-config.yamlখুলুন। আপনি এই ফাইলটি খুঁজে না পেলে, Edge Microgateway কোথায় ইনস্টল করা হয় দেখুন। - Edge Microgateway এবং Apigee Edge-এর মধ্যে মিউচুয়াল TLS চালু করতে
org-env-config.yamlফাইলে নিম্নলিখিতtlsOptionsব্লক যোগ করুন:edge_config: bootstrap: >- https://domain/edgemicro/bootstrap/organization/org/environment/env jwt_public_key: 'https://domain/edgemicro-auth/publicKey' managementUri: 'https://api.enterprise.apigee.com' tlsOptions: agentOptions: requestCert: true cert: 'path/to/cert' key: 'path/to/key'যেমন:
tlsOptions: agentOptions: requestCert: true cert: '/Users/jdoe/twowayssl/ssl/client.key' key: '/Users/jdoe/twowayssl/ssl/ca.crt'এছাড়াও, আপনি নিম্নলিখিত ঐচ্ছিক
agentOptionsপ্যারামিটার যোগ করতে পারেন:ca: সার্টিফিকেশন কর্তৃপক্ষের পাথ নির্দিষ্ট করে।pfx: cert ও key-এর পরিবর্তে p12/pfx ফাইল ব্যবহার করতে চাইলে এটি অন্তর্ভুক্ত করুন।passphrase: pfx ফাইলের জন্য পাসফ্রেজ।ciphers: TLS সাইফার নির্দিষ্ট করে।
edgemicro-authপ্রক্সি যে ভার্চুয়াল হোস্টে ডিপ্লয় করা হয়েছে সেখানে মিউচুয়াল TLS চালু আছে কিনা তা নিশ্চিত করুন। বিস্তারিত জানতে, Apigee Edge ডকুমেন্টেশনে টু-ওয়ে TLS-এর জন্য ভার্চুয়াল হোস্ট নির্ধারণ করা লিঙ্ক দেখুন।নিচের স্ক্রিনশট থেকে বোঝা যায় যে কীভাবে Apigee Edge UI-তে ভার্চুয়াল হোস্টে মিউচুয়াল TLS চালু করতে হয়:
- Edge UI-তে
edgemicro-authAPI প্রক্সি দেখুন এবং নিশ্চিত করুন যে প্রক্সি কনফিগে সঠিক ভার্চুয়াল হোস্ট নির্দিষ্ট করা আছে। যেমন, আপনি TLS চালু করাmutualtlsনামের ভার্চুয়াল হোস্ট তৈরি করলে, প্রক্সিরHTTPProxyConnectionস্ট্যাঞ্জা এইরকম দেখতে হবে:<HTTPProxyConnection> <BasePath>/edgemicro-auth</BasePath> <Properties/> <VirtualHost>mutualtls</VirtualHost> </HTTPProxyConnection>
- ফাইল
/products রিসোর্স সুরক্ষিত আছে কিনা তা যাচাই করুন/products
রিসোর্স সুরক্ষিত আছে কিনা তা চেক করার জন্য কীভাবে পরীক্ষা করতে হয় তা ব্যাখ্যা করা হয়েছে। সম্পদ সুরক্ষিত রাখতে, ধাপগুলি (বিকল্প ১ বা বিকল্প ২) সম্পূর্ণ করার পরে এই পরীক্ষাটি করা গুরুত্বপূর্ণ।
আপনি এটি cURL-এর মাধ্যমে করতে পারেন, যেমন:
curl -v https://your_domain/edgemicro-auth/products
/products এন্ডপয়েন্ট সুরক্ষিত আছে:
{
"error":"unauthorized",
"error_description": "authentication failed"
}অথবা
curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number
আপনি যদি এমন কোনও উত্তর দেখতে পান, তাহলে /products রিসোর্স সুরক্ষিত নয়
এবং ডেভেলপার ইমেল আইডি প্রকাশ হয়ে যেতে পারে:
{ "apiProduct":[ { "apiResources":[ "/", "/**" ], "approvalType":"auto", "attributes":[ ], "createdAt":1537374680948, "createdBy":"jdoe@foo.com", "description":"", "displayName":"mock", "environments":[ "test" ], "lastModifiedAt":1537374680948, "lastModifiedBy":"test@test.com", "name":"mock", "proxies":[ "edgemicro-auth", "edgemicro_mock" ], "quota":"null", "quotaInterval":"null", "quotaTimeUnit":"null", "scopes":[ "" ] } ] }
এছাড়াও, Apigee সাজেস্ট করে যে আপনি HTTP ভার্চুয়াল হোস্ট পরীক্ষা করে দেখুন:
যেমন:
curl -v http://your_domain/edgemicro-auth/products
cURL কল API প্রোডাক্টের তালিকা রিটার্ন করলে, এটি হতে পারে যে ডেভেলপার ইমেল
প্রকাশিত হয়েছে। আপনি যদি এই নন-TLS ভার্চুয়াল হোস্টের সাথে এন্ডপয়েন্ট এক্সপোজ করতে না চান, তাহলে
edgemicro-auth HTTPProxyConnection কনফিগারেশন থেকে এটি সরিয়ে দিতে ভুলবেন না।
রিসোর্স সুরক্ষিত রাখতে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি বেছে নিন:
বর্তমানে, আপনি কোনও Edge Microgateway ইনস্ট্যান্সের জন্য JWT টোকেন রিনিউ করতে পারবেন না।
সমস্যা সমাধানের বিকল্প:
প্রতিটি JWT টোকেনে exp অ্যাট্রিবিউট থাকে যা টোকেনের মেয়াদ শেষ হওয়ার তারিখ উল্লেখ করে। কোনও অ্যাপ
মেয়াদ শেষ হওয়ার সময় গণনা করতে পারে এবং সরাসরি
edgemicro-auth টোকেন এন্ডপয়েন্টে API কল করে নতুন টোকেনের অনুরোধ করতে পারে। যেমন, আপনি এই ধরনের API কল করতে পারেন:
POST https: //{your_org}-{your_env}.apigee.net/edgemicro-auth/token
... এই ধরনের JSON বডি সহ:
{ "client_id": {your_id}, "client_secret": {your_secret},
"grant_type": "client_credentials" }
এটিও দেখুন:
- Edge Microgateway ডকুমেন্টেশনে OAuth টোকেন বা API key-এর মাধ্যমে API সুরক্ষিত করুন।
- Apigee কমিউনিটিতে বেয়ারার টোকেনের মেয়াদ শেষ হয়ে গেলে সেটি রিনিউ করার প্রসেস কী।
বর্তমানে, কোনও নির্দিষ্ট OAuth টোকেনের সাথে যুক্ত API প্রোডাক্টের জন্য কোনও API অনুমোদিত কিনা তা নির্ধারণ করতে শুধুমাত্র বেসপাথ চেক করা হয়।
যেমন:
- আপনি বেস পাথ ও টার্গেট সহ
edgemicro_প্রিফিক্সড প্রক্সি তৈরি করেন। - আপনি কোনও প্রোডাক্টে এই প্রক্সি যোগ করেন। চলো, এটিকে
edgemicro-prod1বলা যাক। - API কী বা OAuth
টোকেন ব্যবহার করে Edge Microgateway-এর মাধ্যমে কোনও API কল করা হলে, Edge Microgateway চেক করে দেখে যে API-এর বেসপাথ, সেই কী বা টোকেনের জন্য অনুমোদিত প্রোডাক্টের তালিকার জন্য অনুমোদিত
edgemicro_*প্রক্সির বেসপাথের সাথে ম্যাচ করছে কিনা।
এছাড়াও, Apigee কমিউনিটিতে প্রোডাক্টে edgemicro গেটওয়ে ব্যবহার করার সময়, প্রোডাক্টে কোন URL হোয়াইটলিস্ট করতে হবে যা রিসোর্সের অধীনে ব্যবহার করা হয়? দেখুন।
বর্তমানে শুধুমাত্র ডিফল্ট Apigee SSL সার্টিফিকেট কাজ করে। এই মুহূর্তে কাস্টম SSL সার্টিফিকেট কাজ করে না।
সমস্যার সমাধান:
আপনি কাস্টম (Apigee ডিফল্ট নয়) SSL সার্টিফিকেট ব্যবহার করতে চাইলে, আপনার কাছে এইসব বিকল্প আছে:
-
SSL নয় এমন
jwt_public_keyএন্ডপয়েন্ট ব্যবহার করুন।http://{org}-{env}.apigee.net/edgemicro-auth/publicKeyব্যবহার করতে Edge Microgateway কনফিগারেশন ফাইল পরিবর্তন করুন -অথবা- -
Edge Microgateway শুরু করার আগে, এই এনভায়রনমেন্ট ভেরিয়েবল সেট করুন: export
NODE_TLS_REJECT_UNAUTHORIZED ="0"
এছাড়াও, Apigee কমিউনিটিতে SSL cert-এ Edge Micro ইনস্টল সংক্রান্ত সমস্যা যাচাই করুন দেখুন।
edgemicro-auth প্রক্সি ডেপ্লয় করে এবং এই
ডেপ্লয়মেন্টের জন্য Org Admin ক্রেডেনশিয়াল প্রয়োজন।আপনি নিজের টোকেন ব্যবহার করতে পারবেন, তবে প্রথমে আপনাকে Edge Microgateway-এর জন্য বিল্ট-ইন অনুমোদন বন্ধ করতে হবে। এটি করতে:
- Edge Microgateway-এর জন্য কনফিগারেশন ফাইল খুলুন।
-
দুটি oauth সেটিংকে নিম্নলিখিত উপায়ে true হিসেবে পরিবর্তন করুন:
oauth: allowNoAuthorization: true allowInvalidAuthorization: true
edgemicro start -o [org] -e [env] -k [key] -s [secret]টেস্টিং ও ডিবাগিং
- লোড টেস্টিংয়ের সময় আমি কীভাবে "অনেক ফাইল খোলা" সংক্রান্ত সমস্যা প্রতিরোধ করব?
-
কিছু ক্ষেত্রে, আপনার সিস্টেম এমন পরিস্থিতিতে পড়তে পারে যেখানে অনেক বেশি ফাইল কানেকশন খোলা থাকে এবং এর ফলে Edge Micro ক্র্যাশ করতে পারে। ডিফল্ট লগিংয়ের জন্য Microgateway-এর মাধ্যমে ইনকামিং ও আউটগোয়িং ট্রানজ্যাকশনের জন্য দুটি HTTP কানেকশন প্রয়োজন।
পরীক্ষা ও বেঞ্চমার্কিংয়ের উদ্দেশ্যে, Apigee আপনার সিস্টেমের ulimit কমান্ড আনলিমিটেড হিসেবে সেট করার জন্য সাজেস্ট করে:
ulimit -n unlimited। এছাড়াও, Apigee কমিউনিটিতে লোড টেস্টিংয়ের সময় Edge মাইক্রোগেটওয়ে সংক্রান্ত সমস্যা দেখুন। - দ্রুত ডেভেলপমেন্ট ও ডিবাগিং সংক্রান্ত পরামর্শ
-
আপনি Edge Microgateway-এর জন্য প্লাগ-ইন ডেভেলপ করলে, আপনি দেখতে পেতে পারেন যে দ্রুত ডেভেলপমেন্টের জন্য সহায়তা সীমিত।
আপাতত, এখানে কিছু পরামর্শ দেওয়া হল:
- Edge Microgateway চালু করার জন্য, আপনি পরিবেশগত ভেরিয়েবল EDGEMICRO_KEY এবং EDGEMICRO_SECRET-কে Microgateway স্টার্ট-আপ কমান্ডের প্রয়োজনীয় কী/সিক্রেট পেয়ারে সেট করতে পারেন। এর ফলে, কমান্ড লাইনে কী/সিক্রেট না লিখেও আপনি Edge Microgateway চালু করতে পারবেন। এছাড়াও, Edge Microgateway ডকুমেন্টেশনে এনভায়রনমেন্ট ভেরিয়েবল সেট করা দেখুন।
-
কমান্ড টার্মিনালে অতিরিক্ত আউটপুট দেখতে DEBUG মোডে Edge Microgateway চালু করুন:
DEBUG=* edgemicro start -o [org] -e [env] -k [key] -s [secret]
ব্যবসা ও লাইসেন্স
- Apigee-127 এবং Edge Microgateway সহায়তা মডেলের মধ্যে সম্পর্ক কী?
-
Apigee-127 হল একটি ওপেন সোর্স সফ্টওয়্যার প্রোজেক্ট যা ওপেন সোর্স মডেলে কাজ করে। অর্থাৎ, আপনি GitHub প্রোজেক্টে সমস্যা জানাতে পারেন এবং কোনও কিছু সমাধান করার চেষ্টা করলে পুল অনুরোধ করতে পারেন। Apigee-127-এর Apigee-এর সাথে কোনও সফ্টওয়্যার লাইসেন্স চুক্তি প্রয়োজন বা অন্তর্ভুক্ত নয়।
অন্যদিকে, Edge Microgateway হল একটি এন্টারপ্রাইজ প্রোডাক্ট যা Apigee গ্রাহকদের জন্য Apigee-এর মাধ্যমে কাজ করে। অর্থাৎ, Apigee গ্রাহকরা Google Cloud Apigee Edge সহায়তা ব্যবহার করে সহায়তা টিকিট, ফিচার সংক্রান্ত অনুরোধ ও বাগ রিপোর্ট তৈরি করতে পারবেন।