تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

الأسئلة الشائعة حول Edge Microgateway

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الخطوات الأولى

كيف يمكنني تثبيت Edge Microgateway؟: راجِع تثبيت Edge Microgateway.
كيف يمكنني تشغيل Edge Microgateway؟: راجِع إعداد Edge Microgateway وضبطها.
هل أحتاج إلى قاعدة بيانات لتشغيل Microgateway؟: قد تتفاعل واجهات برمجة التطبيقات التي يتم توجيهها من خلال Edge Microgateway مع قاعدة بيانات تعمل كجزء من خدمة مستهدَفة. ومع ذلك، يعمل Edge Microgateway بشكل مستقل عن أي قاعدة بيانات أو متجر بيانات للخلفية.

العملية

ما هي التغييرات التي تتطلّب إعادة تشغيل Edge Microgateway؟

تتولّى Edge Microgateway تلقائيًا البحث عن التغييرات التي تم إجراؤها على Apigee Edge، مثل التغييرات التي تم إجراؤها على الخوادم الوكيلة أو المنتجات أو تطبيقات المطوّرين المتوافقة مع microgateway. فترة الاقتراع التلقائية هي 600 ثانية، ولكن يمكنك تغييرها باستخدام إعداد الضبط config_change_poll_interval. اطّلِع على سمات edgemicro.

إذا كنت لا تريد الانتظار حتى انتهاء فترة الاستطلاع، استخدِم الأمر edgemicro reload للحصول على آخر التغييرات. راجِع مقالة إعادة تحميل مجموعة البوابة المصغّرة.

كيف يمكنني التمييز بين وكيل تم نشره على Edge ووكيل على Edge Microgateway؟

عند ضبط Edge Microgateway، يتم تنزيل قائمة بالخوادم الوكيلة المتوافقة مع microgateway والمستضافة على Apigee Edge إلى الإعدادات المحلية لـ Edge Microgateway. الخوادم الوكيلة المتوافقة مع Microgateway هي تلك التي تبدأ أسماؤها بالبادئة edgemicro_.

ما هي الخيارات المتاحة لتسجيل الدخول باستخدام Edge Microgateway؟

Edge Microgateway ميزة تسجيل مدمَجة. لمزيد من التفاصيل، يُرجى الاطّلاع على إدارة ملفات السجلّ.

يمكنك أيضًا كتابة مكوّن إضافي مخصّص لاستخدام خدمة تسجيل تابعة لجهة خارجية مع Edge Microgateway. بسبب طريقة عمل Edge Microgateway، لا يمكنك استخدام سياسة تسجيل الرسائل في Apigee Edge لتسجيل الرسائل في Edge Microgateway. يمكنك أيضًا الاطّلاع على مقالة المنتدى حول Logging Plugin for Microgateway.

هل يمكنني إعادة استخدام مجموعات المفاتيح/الأسرار بين مثيلات Edge Microgateway؟

طالما أنّ المؤسسة والبيئة متماثلتان بالنسبة إلى مثيلات Microgateway، يمكنك إعادة استخدام مفتاح/سر يتم إنشاؤه أثناء عملية الإعداد.

كيف يمكنني ضبط Edge Microgateway لبدء التشغيل في بيئة التشغيل الفعلي؟

يمكنك ضبط متغيرات البيئة لمَعلمات أمر بدء التشغيل، مثل EDGEMICRO_KEY وEDGEMICRO_SECRET وEDGEMICRO_ORG وEDGEMICRO_ENV. باستخدام هذه المتغيرات (وغيرها)، يمكنك بدء تشغيل Edge Microgateway باستخدام الأمر الفردي edgemicro start. يمكنك الاطّلاع أيضًا على ضبط متغيّرات البيئة.

هل يمكنني استخدام سمات مخصّصة للمنتج أو تطبيق المطوّر مع Edge Microgateway؟

لا، لأنّ Edge Microgateway لا يتفاعل تلقائيًا إلا مع السمات المرتبطة بالتوجيه الأساسي والأمان. ومع ذلك، يمكنك تجربة الحلّ التالي:

أضِف سمات مخصّصة إلى خادم edgemicro-auth الوكيل الذي تنشره Edge Microgateway على Apigee Edge. ستتوفّر هذه السمات عند استخدام أمان مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز.
عدِّل المكوّن الإضافي OAuth للتعامل مع هذه السمات.

هل هناك حدّ أقصى لحجم عنوان الطلب؟

إذا تمت ترقية Node.js إلى الإصدار v8.14.0 أو إصدار أحدث، يُرجى العِلم أنّه تم تقليل الحد الأقصى لحجم العنوان المسموح به في الطلبات من 80 كيلوبايت إلى 8 كيلوبايت. تؤدي العناوين التي تتجاوز 8 كيلوبايت إلى حدوث خطأ HTTP 431.

يتيح لك خيار إعداد Node.js الذي تمت إضافته في الإصدار 11.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؟

تستدعي أوامر Edge Microgateway التالية واجهات برمجة التطبيقات الإدارية في Apigee Edge لتنفيذ مهامها، كما هو موضّح في مرجع واجهة سطر الأوامر لـ Edge Microgateway:

edgemicro configure
edgemicro upgradeauth
edgemicro upgradekvm
edgemicro rotatekey
edgemicro cert check
edgemicro cert delete
edgemicro cert install

تدرِج الأقسام التالية طلبات البيانات من واجهة برمجة التطبيقات الإدارية التي يستخدمها كل أمر.

يطلب الأمران edgemicro configure وupgradeauth البيانات من واجهات برمجة التطبيقات الإدارية التالية:

(list deployments) 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
(إنشاء خادم وكيل لواجهة برمجة التطبيقات) 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 واجهة برمجة التطبيقات الإدارية التالية:

PUT: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway

يستدعي الأمر rotatekey واجهة برمجة التطبيقات الإدارية التالية:

GET: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway/entries/private_key

يستدعي الأمر cert check واجهة برمجة التطبيقات الإدارية التالية:

GET: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway

يستدعي الأمر cert delete واجهة برمجة التطبيقات الإدارية التالية:

DELETE: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway

يستدعي الأمر cert install واجهة برمجة التطبيقات الإدارية التالية:

POST: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps

النشر

هل يمكنني نشر Edge Microgateway على الخادم نفسه الذي يتم تشغيل الخدمة المستهدَفة عليه؟: نعم. ‫Edge Microgateway هي عملية بسيطة يمكن تشغيلها بالقرب من الخدمة المستهدَفة، بما في ذلك على الجهاز نفسه.
هل يمكنني نشر حزمة وكيل Edge حالية كعملية نشر Edge Microgateway؟: لا، لأنّ الخوادم الوكيلة المتوافقة مع Edge Microgateway لها متطلبات محدّدة ولا تتوافق مع جميع ميزات خوادم Edge الوكيلة العادية. راجِع الجزء 2: إنشاء عناصر على Apigee Edge
هل يمكنني تفعيل التبديل الاحتياطي بين عملية نشر لحزمة وكيل Edge وعملية نشر لـ Edge Microgateway لوكيل API نفسه؟: لا، لا تعرف Edge Microgateway عمليات نشر خوادم وكيلة لواجهات برمجة التطبيقات غير تابعة لـ Edge Microgateway على Apigee Edge.
ما هو نموذج النشر الذي يتيح توفّر Edge Microgateway بشكل مستمر؟: للحصول على مناقشة جيدة حول كيفية تشغيل Edge Microgateway باستخدام NGINX كموازن تحميل، راجِع إدارة واجهات برمجة التطبيقات باستخدام Apigee Edge Microgateway وNGINX.
ما هي موازنات التحميل التي يمكنني استخدامها مع Edge Microgateway؟: يمكن أن تعمل Edge Microgateway مع أي أداة موازنة تحميل.
هل هناك حدّ أقصى لعدد خوادم Edge Microgateway الوكيلة التي يمكنني نشرها؟: راجِع حدود إعدادات المنتج المحدّدة لوكلاء Edge العاديين. يجب أن يتوافق عدد الخوادم الوكيلة المتوافقة مع البوابة المصغّرة التي يمكنك نشرها في مؤسسة وبيئة Apigee Edge والتي يمكنك استدعاؤها من خلال Edge Microgateway مع هذه الحدود نفسها.
هل يمكنني ربط عملية نشر Edge Microgateway بمؤسسة وبيئة معيّنتَين؟: عند ضبط مثيل من Edge Microgateway، يجب ربطه بمؤسسة وبيئة محدّدتين في Edge.
هل يمكنني ربط عملية نشر Edge Microgateway بمنطقة معيّنة (إذا كنت عميلاً في مناطق متعددة)؟: يختار Edge Microgateway تلقائيًا أفضل منطقة للتفاعل مع Apigee Edge. يمكنك نشر مثيلات Edge Microgateway في كل منطقة تريد تقديم الخدمة فيها.

الإدارة

هل يجب أن أكون مشرفًا في المؤسسة لإعداد Edge Microgateway ونشره؟: نعم. يجب أن تكون لديك بيانات اعتماد مشرف المؤسسة لإعداد Edge Microgateway ونشره.
هل يجب أن أكون مشرفًا على المؤسسة لتشغيل Edge Microgateway؟: لا، Edge Microgateway هو Node.js تطبيق، ويمكن لأي شخص لديه إذن بتشغيل مثل هذه التطبيقات على جهاز معيّن تشغيله.
هل يمكن لأي من مستخدمي مؤسستي استخدام Edge Microgateway؟: لا يلزم أن تكون مستخدمًا في مؤسسة Apigee Edge لإجراء طلبات إلى واجهة برمجة التطبيقات من خلال Edge Microgateway. ومع ذلك، يجب أن يكون لديك أذونات على مستوى المؤسسة لإنشاء أو تغيير وكلاء متوافقين مع Edge Microgateway يتم نشرهم على Edge.

الأداء

ما هي اعتبارات الأداء عند استخدام Edge Microgateway؟: إذا كنت تشغّل Edge Microgateway في الموقع الجغرافي نفسه مع التطبيق المستهدَف، تأكَّد من أنّ الخادم لديه سعة كافية.
ما هي أفضل الممارسات لتشغيل Edge Microgateway على نطاق واسع؟: تنصح Apigee بتشغيل نُسخ متعددة من Edge Microgateway على خوادم مختلفة يتم توجيهها من خلال موازنات التحميل، مثل NGINX. يمكنك أيضًا الاطّلاع على إدارة واجهات برمجة التطبيقات باستخدام Apigee Edge Microgateway وNGINX و التوسيع النطاقي العمودي والأفقي على "منتدى Apigee".
ما هي عدد المعاملات في الثانية (TPS) التي يمكن أن تعالجها Edge Microgateway تلقائيًا، وما هي متطلبات الأجهزة اللازمة لتشغيل مثيل من Microgateway؟: يصعب قياس متطلبات الأجهزة وقياسات المعاملات في الثانية باستخدام Edge Microgateway. يعتمد ذلك على إعداداتك، وهي مزيج من ضبط Edge Microgateway واستخدام المكوّنات الإضافية والمكوّنات الإضافية المخصّصة وإعداد أشياء أخرى، مثل بروتوكول أمان طبقة النقل (TLS). تنصح Apigee عادةً بالتعرّف على هذه المجموعة من العناصر وإجراء اختبار الأداء باستخدام الإعدادات المحدّدة.

عمليات النشر في السحابة الإلكترونية الخاصة

هل يتوافق Edge Microgateway مع Edge for Private Cloud؟: نعم. لمزيد من التفاصيل، يُرجى الاطّلاع على خطوات إعداد Apigee Private Cloud.

المكوّنات الإضافية

كيف يتم فرض الحصة باستخدام Edge Microgateway؟

يمكنك اختياريًا إضافة مكوّن إضافي للحصة إلى مثيل Edge Microgateway. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة استخدام إضافة الحصة.

كيف يتم فرض Spike Arrest باستخدام Edge Microgateway؟

يمكنك اختياريًا إضافة مكوّن إضافي لمنع الارتفاع المفاجئ في عدد الزيارات إلى مثيل Edge Microgateway. لمزيد من التفاصيل، يُرجى الاطّلاع على استخدام مكوّن Spike Arrest الإضافي.

هل هناك طرق أخرى لكتابة المكوّنات الإضافية غير Node.js لـ Edge Microgateway؟

لا، يجب كتابة الإضافات بلغة Node.js.

ماذا يحدث عندما يتعذّر على Edge Microgateway تحميل بيانات "إحصاءات Google" إلى Edge؟

Edge Microgateway على مخزن مؤقت في الذاكرة. في حال امتلاء المخزن المؤقت، يتم إسقاط الحِزم القديمة للسماح بتدفق بيانات واجهة برمجة التطبيقات بسلاسة.

هل يمكنني إضافة سياسات إلى Edge Microgateway؟

في حال ربط سياسات Apigee Edge العادية بخوادم وكيلة متوافقة مع البوابة المصغّرة في Apigee Edge، سيتم تجاهلها. بدلاً من ذلك، تستخدم Edge Microgateway المكوّنات الإضافية لتوفير وظائف مشابهة للسياسات في Edge، مثل الحصة والحدّ من الارتفاع المفاجئ في عدد الزيارات وأمان مفتاح واجهة برمجة التطبيقات وأمان OAuth2. يمكنك أيضًا كتابة مكوّنات إضافية مخصّصة. اطّلِع على استخدام المكوّنات الإضافية وتطوير مكوّنات إضافية مخصّصة.

تتناول مشاركات ومدوّنات "منتدى Apigee" التالية حالات استخدام إضافية للمكوّنات الإضافية:

الأمان

كيف يمكنني حماية المورد /products؟

ملاحظة: إذا ثبّت Edge Microgateway في 5 تشرين الأول (أكتوبر) 2018 أو قبله، تنصحك Apigee باتّباع الخطوات الواردة في هذا القسم لحماية نقطة النهاية /products لخادم وكيل edgemicro-auth.

نظرة عامة

عند ضبط Edge Microgateway، يتم نشر خادم وكيل لواجهة برمجة التطبيقات باسم edgemicro-auth في مؤسستك:بيئتك على Apigee Edge. يعرض هذا الخادم الوكيل نقطة نهاية /products تعرض قائمة بمنتجات واجهة برمجة التطبيقات. إذا ثبّت Edge Microgateway في 5 تشرين الأول (أكتوبر) 2018 أو قبله، تنصحك Apigee باتّخاذ خطوات لحماية نقطة النهاية هذه، لأنّ الردّ يتضمّن عنوان البريد الإلكتروني للمطوّر الذي أنشأ منتجات واجهة برمجة التطبيقات وعدّلها في مؤسستك على Apigee.

يمكنك حماية نقطة النهاية من خلال ترقية Edge Microgateway أو ضبط بروتوكول أمان طبقة النقل المتبادل. يتم توضيح كلا الخيارين أدناه.

التحقّق مما إذا كانت نقطة النهاية /products محمية

إذا لم تكن متأكدًا مما إذا كانت نقطة النهاية /products محمية، انتقِل إلى القسم التأكّد من أنّ مورد /products محمي واتّبِع الخطوات الواردة فيه قبل المتابعة.

الخيار 1: ترقية Edge Microgateway

إذا ثبّت Edge Microgateway في 5 تشرين الأول (أكتوبر) 2018 أو قبل ذلك، تنصحك Apigee بالترقية إلى أحدث إصدار من Edge Microgateway. اتّبِع الخطوات الواردة في مقالة ترقية Edge Microgateway في حال توفّر اتصال بالإنترنت.

إذا تعذّر عليك الترقية في الوقت الحالي، انتقِل إلى الخيار 2.

الخيار 2: ضبط بروتوكول أمان طبقة النقل (TLS) المتبادل

إذا لم تتمكّن من ترقية Edge Microgateway في الوقت الحالي، تنصح Apigee بحماية الاتصال بين Edge Microgateway وخادم وكيل edgemicro-auth باستخدام بروتوكول أمان طبقة النقل (TLS) المتبادل (المعروف أيضًا باسم بروتوكول أمان طبقة النقل الثنائي الاتجاه).

افتح الملف $HOME/.edgemicro/org-env-config.yaml. راجِع مكان تثبيت Edge Microgateway إذا لم تتمكّن من العثور على هذا الملف.
أضِف كتلة tlsOptions التالية إلى ملف org-env-config.yaml لتفعيل بروتوكول أمان طبقة النقل المتبادل بين Edge Microgateway وApigee Edge:
ملاحظة: يجب ضبط requestCert على true لتفعيل هذه السمة.
```
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: أدرِج هذه السمة إذا كنت تريد استخدام ملف p12/pfx بدلاً من ملف الشهادة والمفتاح.
- passphrase: عبارة المرور لملف pfx
- ‫ciphers: تحدّد رموز TLS.
تأكَّد من تفعيل بروتوكول أمان طبقة النقل المتبادل على المضيف الافتراضي الذي تم نشر وكيل edgemicro-auth عليه. لمعرفة التفاصيل، يُرجى الاطّلاع على تحديد مضيف افتراضي لبروتوكول أمان طبقة النقل (TLS) الثنائي الاتجاه في مستندات Apigee Edge.
تعرض لقطة الشاشة التالية كيفية تفعيل بروتوكول أمان طبقة النقل المتبادلة على مضيف افتراضي في واجهة مستخدم Apigee Edge:
اطّلِع على edgemicro-auth خادم وكيل لواجهة برمجة التطبيقات في واجهة مستخدم Edge، وتأكَّد من تحديد المضيف الافتراضي الصحيح في إعدادات الخادم الوكيل. على سبيل المثال، إذا أنشأت مضيفًا افتراضيًا مفعّلاً لبروتوكول أمان طبقة النقل (TLS) باسم mutualtls، يجب أن يبدو مقطع HTTPProxyConnection الخاص بالخادم الوكيل على النحو التالي:
```
<HTTPProxyConnection>
    <BasePath>/edgemicro-auth</BasePath>
    <Properties/>
    <VirtualHost>mutualtls</VirtualHost>
</HTTPProxyConnection>
```

التأكّد من أنّ مورد /products محمي

يوضّح هذا القسم كيفية إجراء اختبار للتحقّق مما إذا كان المرجع /products محميًا. من المهم إجراء هذا الاختبار بعد إكمال الخطوات (الخيار 1 أو الخيار 2) لحماية المرجع. يمكنك إجراء ذلك باستخدام 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 قائمة بمنتجات واجهة برمجة التطبيقات، من المحتمل أن تكون عناوين البريد الإلكتروني للمطوّرين مكشوفة. إذا كنت لا تريد عرض نقطة النهاية باستخدام المضيف الافتراضي غير TLS هذا، احرص على إزالته من إعدادات edgemicro-auth HTTPProxyConnection.

لحماية المرجع، اتّبِع أحد الخيارات التالية:

الخيار 1: ترقية Edge Microgateway
الخيار 2: ضبط بروتوكول أمان طبقة النقل الثنائي

كيف يمكنني تجديد رمز مميّز منتهي الصلاحية؟

في الوقت الحالي، لا يمكنك تجديد رمز JWT المميز لمثيل معيّن من Edge Microgateway.

الحلّ البديل:

يحتوي كل رمز مميّز بتنسيق JWT على سمة exp تحدّد تاريخ انتهاء صلاحية الرمز المميّز. يمكن لأي تطبيق احتساب وقت انتهاء الصلاحية وطلب رمز مميّز جديد من خلال إرسال طلب بيانات من واجهة برمجة التطبيقات مباشرةً إلى نقطة نهاية الرمز المميّز edgemicro-auth. على سبيل المثال، يمكنك إجراء طلب بيانات من واجهة برمجة التطبيقات على النحو التالي:

POST https: //{your_org}-{your_env}.apigee.net/edgemicro-auth/token

... مع نص JSON على النحو التالي:

{ "client_id": {your_id}, "client_secret": {your_secret}, "grant_type": "client_credentials" }

انظر أيضًا:

تأمين واجهة برمجة التطبيقات باستخدام رمز OAuth مميز أو مفتاح واجهة برمجة تطبيقات في مستندات Edge Microgateway
ما هي إجراءات تجديد رموز الدخول المميزة عند انتهاء صلاحيتها في "منتدى Apigee"؟

ضبط إعدادات SSL على Windows

إذا كنت تستخدم Edge Microgateway على نظام التشغيل Windows، يجب تثبيت OpenSSL على الجهاز وإضافته إلى PATH. لا يتم شحن جميع أجهزة Windows مع OpenSSL. يُرجى الرجوع إلى مستندات OpenSSL للحصول على معلومات حول تنزيل OpenSSL وتثبيته.

هل يمكنني السماح بالوصول إلى موارد واجهة برمجة التطبيقات باستخدام منتج واجهة برمجة التطبيقات المرتبط بخادم وكيل متوافق مع Edge Micro؟

في الوقت الحالي، يتم التحقّق من المسار الأساسي فقط لتحديد ما إذا تمت الموافقة على واجهة برمجة تطبيقات لمنتجات واجهة برمجة التطبيقات المرتبطة برمز OAuth مميّز معيّن.

على سبيل المثال:

يمكنك إنشاء وكيل يبدأ بالبادئة edgemicro_ مع المسار الأساسي والهدف.
يمكنك إضافة هذا الوكيل إلى منتج. لنسمِّها edgemicro-prod1.
عند إجراء طلب بيانات من واجهة برمجة التطبيقات من خلال Edge Microgateway باستخدام مفتاح واجهة برمجة تطبيقات أو رمز OAuth المميز، تتحقّق Edge Microgateway مما إذا كان المسار الأساسي لواجهة برمجة التطبيقات يتطابق مع المسار الأساسي لخادم edgemicro_* الوكيل الذي تمت الموافقة عليه في قائمة المنتجات التي تمت الموافقة عليها لهذا المفتاح أو الرمز المميز.

راجِع أيضًا When using the edgemicro gateway in the products which url needs whitelisting in the products used under resources?‎ في "منتدى Apigee".

هل يمكنني استخدام شهادات SSL مخصّصة مع Edge Microgateway؟

لا يتوفّر حاليًا سوى شهادة SSL التلقائية من Apigee. شهادات SSL المخصّصة غير متاحة في الوقت الحالي.

الحلول البديلة:

إذا كنت تريد استخدام شهادة SSL مخصّصة (غير شهادة Apigee التلقائية)، لديك الخيارات التالية:

استخدِم نقطة نهاية jwt_public_key غير متوافقة مع بروتوكول SSL. عدِّل ملف إعداد Edge Microgateway لاستخدام http://{org}-{env}.apigee.net/edgemicro-auth/publicKey -or-
قبل بدء Edge Microgateway، اضبط متغيّر البيئة هذا: export NODE_TLS_REJECT_UNAUTHORIZED ="0"

ملاحظة: تأكَّد أيضًا من استخدام إصدار Node.js المتوافق مع إصدار Edge Microgateway. راجِع المتطلبات الأساسية في مستند التثبيت الخاص بـ Edge Microgateway.

يمكنك أيضًا الاطّلاع على التحقّق من أخطاء تثبيت Edge Micro على شهادة SSL في "منتدى Apigee".

هل يمكنني تجنُّب استخدام حسابات مشرف المؤسسة مع Edge Microgateway؟

ينشر نص برمجي لإعداد Edge Microgateway خادمًا وكيلاً edgemicro-auth على Edge، ويتطلّب هذا النشر بيانات اعتماد مشرف المؤسسة.

ومع ذلك، بعد عملية النشر الأولية هذه، من المفترض أن تتمكّن من إكمال عملية الإعداد والضبط بدون الحاجة إلى بيانات اعتماد مشرف المؤسسة. يمكنك أيضًا الاطّلاع على منشور المنتدى هذا حول بيانات اعتماد مشرف المؤسسة.

هل يمكنني استخدام رمز OAuth المميز الخاص بي مع Edge Microgateway؟

يمكنك استخدام الرمز المميّز الخاص بك، ولكن عليك أولاً إيقاف التفويض المضمّن في Edge Microgateway. ولإجراء ذلك:

افتح ملف الإعدادات الخاص بـ Edge Microgateway.

غيِّر إعدادَي oauth إلى "صحيح"، كما يلي:

oauth:
    allowNoAuthorization: true
    allowInvalidAuthorization: true

تظهر لي رسالة الخطأ "تم رفض الوصول" عند بدء Edge Microgateway

إذا ظهرت لك رسالة خطأ تفيد بتعذُّر الوصول عند بدء Edge Microgateway باستخدام هذا الأمر:

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

من المحتمل أن يكون المفتاح والسر غير صالحَين لسبب ما. أفضل ما يمكنك فعله هو إعادة إنشاء المفتاح والسر باستخدام الأمر edgemicro genkeys.

الاختبار وتصحيح الأخطاء

كيف يمكنني منع حدوث أخطاء "عدد كبير جدًا من الملفات المفتوحة" أثناء اختبار التحميل؟

في بعض الحالات، قد يواجه نظامك مشكلة بسبب كثرة اتصالات الملفات المفتوحة، ما قد يؤدي إلى تعطُّل Edge Micro. يتطلّب التسجيل التلقائي اتصالَي HTTP للمعاملات الواردة والصادرة من خلال Microgateway.

لأغراض الاختبار وقياس الأداء، تنصح Apigee بضبط الأمر ulimit في نظامك على قيمة غير محدودة: ulimit -n unlimited. يمكنك أيضًا الاطّلاع على خطأ Edge Microgateway أثناء اختبار التحميل في "منتدى Apigee".

نصائح للتطوير السريع وتصحيح الأخطاء

إذا كنت بصدد تطوير مكوّنات إضافية لـ Edge Microgateway، قد تجد أنّ الدعم المتاح للتطوير السريع محدود.

إليك بعض النصائح في الوقت الحالي:

لبدء Edge Microgateway، يمكنك ضبط متغيّري البيئة EDGEMICRO_KEY وEDGEMICRO_SECRET على زوج المفتاح/السر المطلوب من خلال أمر بدء تشغيل Microgateway. يتيح لك ذلك بدء Edge Microgateway بدون إدخال المفتاح/السر في سطر الأوامر. يمكنك أيضًا الاطّلاع على ضبط متغيرات البيئة في مستندات Edge Microgateway.
ابدأ Edge Microgateway في وضع DEBUG للاطّلاع على ناتج إضافي في وحدة طرفية الأوامر: DEBUG=* edgemicro start -o [org] -e [env] -k [key] -s [secret]

النشاط التجاري والترخيص

ما هي العلاقة بين نماذج الدعم في Apigee-127 وEdge Microgateway؟

‫Apigee-127 هو مشروع برنامج مفتوح المصدر يتم دعمه في نموذج المصدر المفتوح. أي أنّه يمكنك الإبلاغ عن مشاكل في مشروع GitHub وتقديم طلب سحب إذا حاولت إصلاح مشكلة ما. لا تتطلّب حزمة Apigee-127 أو تتضمّن أي اتفاقيات ترخيص برامج مع Apigee.

في المقابل، Edge Microgateway هو منتج Enterprise توفّره Apigee لعملاء Apigee. أي أنّ عملاء Apigee يمكنهم إنشاء طلبات دعم وطلبات ميزات وتقارير أخطاء باستخدام دعم Apigee Edge في Google Cloud.

ملاحظة: لا يستند Edge Microgateway بأي شكل من الأشكال إلى Apigee-127. وهما مشروعان مختلفان تمامًا ولهما أهداف مختلفة، والتشابه الوحيد بينهما هو أنّهما تم تنفيذهما في Node.js. يجب عدم افتراض أي سمات مشتركة أخرى.