نظرة عامة على Edge Microgateway

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

Edge Microgateway‏ 2.4.x

الجمهور

هذا الموضوع هو مقدّمة عامة عن Edge Microgateway مخصّصة لجميع شرائح الجمهور.

ما هو مكوّن Apigee Edge Microgateway؟

‫Apigee Edge Microgateway هي معالج رسائل آمن لـ واجهات برمجة التطبيقات يستند إلى بروتوكول HTTP. وتتمثل مهمته الرئيسية في معالجة الطلبات والردود من خدمات الخلفية وإليها بشكل آمن مع دفع بيانات تنفيذ واجهة برمجة التطبيقات القيّمة بشكل غير متزامن إلى Apigee Edge حيث يتم استخدامها من خلال نظام Edge Analytics. من السهل تثبيت "بوابة Edge المصغّرة" ونشرها، ويمكنك إعداد مثيل وتشغيله في غضون دقائق.

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

حالات الاستخدام الأساسية

تشمل حالات الاستخدام المعتادة لحلّ إدارة واجهة برمجة التطبيقات المختلطة في السحابة الإلكترونية، مثل Edge Microgateway، ما يلي:

  • تقليل وقت استجابة زيارات واجهة برمجة التطبيقات للخدمات التي يتم تشغيلها في مكان قريب على سبيل المثال، إذا كان مطوّرو واجهات برمجة التطبيقات ومستهلكيها قريبين من بعضهم، قد لا تحتاج إلى توجيه واجهات برمجة التطبيقات عبر بوابة مركزية.

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

الميزات والمزايا الرئيسية

  • الأمان: تُجري Edge Microgateway مصادقة الطلبات باستخدام رمز دخول موقَّع أو مفتاح واجهة برمجة التطبيقات الذي أصدرته Apigee Edge لكل تطبيق عميل.
  • النشر السريع: على عكس عملية النشر الكاملة لخدمة Apigee Edge، يمكنك نشر مثيل من Edge Microgateway وتشغيله في غضون دقائق.
  • قرب الشبكة: يمكنك تثبيت Edge Microgateway وإدارته في الجهاز أو الشبكة الفرعية أو مركز البيانات نفسهما اللذان تتوفّر فيهما واجهات برمجة التطبيقات المستهدَفة للخلفية التي تتفاعل معها Edge Microgateway.
  • إحصاءات Google: تُرسِل بوابة Edge Microgateway بيانات تنفيذ واجهة برمجة التطبيقات بشكل غير متزامن إلى Apigee Edge، حيث يعالجها نظام Edge Analytics. يمكنك استخدام ال suite الكاملة من مقاييس "إحصاءات Edge" ولوحات البيانات وواجهات برمجة التطبيقات.
  • وقت استجابة منخفض: تكون جميع عمليات التواصل مع Apigee Edge غير متزامنة ولا تحدث كجزء من معالجة طلبات البيانات من واجهة برمجة التطبيقات الخاصة بالعملاء. يتيح ذلك لـ Edge Microgateway جمع بيانات واجهة برمجة التطبيقات وإرسالها إلى Apigee Edge بدون التأثير في وقت الاستجابة.
  • الشعور بالراحة: يستخدم Edge Microgateway ميزات Apigee Edge ويتفاعل معها، والتي يعرفها مشرفو Edge جيدًا، مثل الخوادم الوكيلة والمنتجات وتطبيقات المطوّرين.
  • الإعداد: لا يلزم إجراء أيّ برمجة لإعداد "بوابة Edge المصغّرة" وإدارتها. ويتم تنفيذ كل ذلك من خلال الإعداد.
  • السهولة: يمكنك دمج Edge Microgateway مع البنية الأساسية والعمليات الحالية لمراقبة التطبيقات وإدارتها.
  • بسيط: يمكن تثبيته وضبطه وصيانتها بسهولة.
  • التسجّل: توضِّح ملفات السجلّ جميع الأحداث العادية والاستثنائية التي تحدث أثناء معالجة واجهة برمجة التطبيقات بواسطة Edge Microgateway.
  • CLI: تتيح لك واجهة سطر الأوامر بدء "بوابة Edge المصغرة" وإيقافها وإعادة تشغيلها واستخراج إحصاءات التشغيل وعرض ملفات السجلّ وطلب الرموز المميّزة للوصول وغيرها.

المعلومات التي تحتاج إلى معرفتها عن بوابة Edge الصغيرة

يصف هذا القسم آلية عمل "بوابة Edge المصغّرة" وبنيتها الأساسية وإعدادها و نشرها.

لماذا يجب استخدام Edge Microgateway؟

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

باستخدام Edge Microgateway، يمكنك الحصول على تطبيق صغير نسبيًا يتم تشغيله بالقرب من تطبيقات الخلفية. ويمكنك الاستفادة من Apigee Edge بالكامل للإحصاءات والأمان وغيرها من الميزات.

أمثلة على سيناريوهات النشر

يوضّح هذا القسم العديد من سيناريوهات النشر المحتمَلة لـ Edge Microgateway.

الجهاز نفسه

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

الشكل 1: أبسط طريقة لنشر Edge Microgateway

جهاز مختلف

بما أنّ جميع عمليات الاتّصال بين العملاء وEdge Microgateway وعمليات تنفيذ واجهة برمجة التطبيقات في الخلفية تتمّ باستخدام بروتوكول HTTP، يمكنك تثبيت Apigee Edge Microgateway على جهاز مختلف عن جهاز تنفيذ واجهة برمجة التطبيقات، كما هو موضّح في الشكل 2.

الشكل 2: واجهة برمجة التطبيقات Edge Microgateway مفصولة عن واجهات برمجة التطبيقات المستهدَفة للخلفية

استخدام خادم وكيل لتطبيقات متعددة

يمكن استخدام مثيل واحد من Edge Microgateway لتقديم تطبيقات مستهدفة متعددة في الخلفية، كما هو موضّح في الشكل 3.

الشكل 3: يمكن أن تُستخدم بوابة Edge Microgateway كوسيط بين تطبيقات متعددة تستخدم واجهات برمجة تطبيقات

مع جهاز موازنة الحمل

يمكن أن يكون Edge Microgateway نفسه في المقدّمة من خلال خادم وكيل عكسي عادي أو موازن تحميل لإنهاء بروتوكول SSL و/أو موازنة الحمل، كما هو موضّح في الشكل 4.

الشكل 4: تشغيل Edge Microgateway مع أداة موازنة التحميل

نشر الشبكة الداخلية

استخدِم Edge Microgateway لحماية حركة مرور الشبكة الداخلية مع حماية حركة مرور الإنترنت باستخدام Apigee Edge، كما هو موضّح في الشكل 5. لنفترض أنّ نقطة نهاية واجهة برمجة التطبيقات /orders يتمّ تمثيلها من خلال Apigee Edge Cloud، وتصل إلى هدف الخلفية https://mycompany.com/orders. ويُمثّل ذلك تنفيذ واجهة برمجة التطبيقات المستهدفة على اليسار. بعد ذلك، قد تطلب واجهة برمجة التطبيقات هذه نقاط نهاية متعددة لواجهة برمجة التطبيقات ممثّلةً بتنفيذ الاستهداف على اليمين. على سبيل المثال، قد يتصل داخليًا بـ /customers و /transactions. اطّلِع أيضًا على هذه المشاركة في منتدى Apigee.

الشكل 5: تشغيل بوابة Edge المصغّرة لحماية عدد الزيارات إلى الشبكة الداخلية

التبعية لخدمة Apigee Edge

تعتمد بوابة Edge Microgateway على Apigee Edge وتتفاعل معها. يجب أن تتواصل بوابة Edge Microgateway مع Apigee Edge لكي تعمل. في ما يلي الطرق الأساسية التي يتفاعل بها Edge Microgateway مع Edge:

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

الإعداد لمرة واحدة

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

لا يلزم أن تكون بوابة Edge Microgateway متاحة في الموقع الجغرافي نفسه الذي يتوفّر فيه Apigee Edge، إذ تعمل عروض Apigee Edge السحابية العامة والخاصة بشكلٍ جيد بالقدر نفسه.

إذا كنت تريد التعلم من خلال الممارسة، انتقِل إلى مقالة إعداد وضبط Edge Microgateway التي تشرح عملية إعداد وضبط Edge Microgateway باستخدام أمر مناسب في سطر الأوامر.

المعلومات التي تحتاج إلى معرفتها عن الخوادم الوكيلة المتوافقة مع Edge Microgateway

توفّر الخوادم الوكيلة المتوافقة مع Edge Microgateway معلومات معيّنة تتيح لـ Edge Microgateway معالجة طلبات واجهة برمجة التطبيقات المقدَّمة من العميل. يتم تنزيل معلومات عن هذه الخوادم الوكيلة من Apigee Edge إلى Edge Microgateway عند بدء تشغيل Edge Microgateway.

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

تشمل خصائص الخوادم الوكيلة المتوافقة مع Edge Microgateway ما يلي:

  • توفّر الخوادم الوكيلة المتوافقة مع المحتوى الصغير لمدخل Edge Microgateway قطعتَي معلومات رئيسيتين: مسار أساسي وعنوان URL المستهدف.
  • يجب أن تشير الخوادم الوكيلة المتوافقة مع المعالجة الدقيقة إلى نقاط نهاية HTTP المستهدفة. لا يمكن أن يكون استهداف الخلفية هو تطبيق Node.js الذي يشير إليه عنصر ScriptTarget في تعريف TargetEndpoint. راجِع المذكرة السابقة للحصول على مزيد من المعلومات.
  • يجب أن تسبق أسماء الخوادم الوكيلة البادئة edgemicro_. على سبيل المثال: edgemicro_weather.
  • لا يمكن تعديل الخوادم الوكيلة لـ Edge Microgateway في "محرر الخادم الوكيل" لواجهة مستخدم إدارة Apigee Edge. وهذا يعني أنّه لا يمكنك إضافة سياسات أو إضافة مسارات مشروطة. (أو سيتم تجاهلها في حال محاولة استخدامها).
  • بخلاف ذلك، تظهر أدوات الربط الوكيلة لواجهة برمجة التطبيقات في واجهة مستخدم إدارة Edge تمامًا مثل أي أدوات ربط وكيلة أخرى لواجهة برمجة التطبيقات على Edge.
  • كما هو الحال مع أيّ وكيل لواجهة برمجة التطبيقات على Edge، يمكن تجميع وكلاء Edge Microgateway في المنتجات وربطها بتطبيقات المطوّرين.
  • كما هو الحال مع أي خادم وكيل آخر، يمكنك تتبُّع إحصاءات خادم الوكيل Edge Microgateway.
  • لا يمكن تتبُّع الخوادم الوكيلة لـ Edge Microgateway باستخدام أداة Apigee Edge Trace.

مزيد من المعلومات عن Edge Microgateway وApigee Edge Analytics

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

الشكل 6: لوحة بيانات "عدد زيارات الخادم الوكيل" على Edge

لمزيد من المعلومات عن "إحصاءات Edge"، اطّلِع على لوحات بيانات "إحصاءات Google".

لمحة عن Edge أمان بوابة Microgateway

دور Apigee Edge

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

  • توفير بيانات اعتماد العميل المستخدَمة كمفاتيح لواجهة برمجة التطبيقات أو لإنشاء رموز مميّزة صالحة للوصول يستخدمها العميل لطلب البيانات من واجهة برمجة التطبيقات بشكل آمن من خلال Edge Microgateway
  • تقديم بيانات الاعتماد التي تحتاجها Edge Microgateway لإرسال بيانات تنفيذ واجهة برمجة التطبيقات إلى نظام Apigee Edge Analytics تحصل بوابة Edge Microgateway على بيانات الاعتماد هذه مرة واحدة أثناء الخطوات الأولية للإعداد. (اطّلِع على مقالة إعداد "بوابة Edge المصغّرة" وضبطها للاطّلاع على الخطوات التفصيلية).
  • توفير المنصة لتجميع موارد واجهات برمجة التطبيقات في المنتجات، وتسجيل المطوّرين وإدارتهم، وإنشاء تطبيقات المطوّرين وإدارتها

مصادقة تطبيق العميل

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

مصادقة Edge Microgateway على Apigee Edge

  • إنّ طلبات البيانات غير المتزامنة التي يجريها Edge Microgateway لتعديل بيانات الإحصاءات على Apigee Edge تتطلّب المصادقة. يتم توفير هذه المصادقة من خلال مفتاحَي تشفير عام/سري يتم تمريرهما إلى Edge Microgateway من خلال وحدة التحكّم في الخطوط أو باستخدام متغيّرات البيئة. يمكنك الحصول على هذين المفتاحَين واستخدامهما مرة واحدة عند تثبيت Edge Microgateway وتشغيله لأول مرة.

منصّة إدارة المنتجات باستخدام واجهة برمجة التطبيقات

  • تُعدّ Edge منصة لتجميع موارد واجهات برمجة التطبيقات في المنتجات، وتسجيل المطوّرين وإدارتهم، وإنشاء تطبيقات المطوّرين وإدارتها. على سبيل المثال، تمامًا كما يمكنك إنشاء كيانات مثل المنتجات وتطبيقات المطوّرين وتجميعها في أدوات الربط العادية في Apigee Edge، يمكنك إجراء الإجراء نفسه تمامًا مع أدوات الربط في Edge Microgateway. يمكن توفير الأمان على مستوى واجهة برمجة التطبيقات من خلال إنشاء مفاتيح أمان عامة وخاصة لكل "حزمة". هذه الآلية مطابقة لطريقة عمل أمان واجهة برمجة التطبيقات على Apigee Edge.

هل يمكنني نقل عمليات تنفيذ الخادم الوكيل الحالي في Edge إلى Edge Microgateway؟

لا يمكنك نقل الخوادم الوكيلة الحالية مع السياسات أو التدفقات الشَرطية المرتبطة بها إلى Edge Microgateway. تتطلّب بوابة Edge Microgateway إنشاء خوادم وكيلة جديدة "متوافقة مع بوابة microgateway". يجب تسمية هذه الخوادم الوكيلة باستخدام بادئة خاصة، وهي edgemicro_. عند بدء التشغيل، يكتشف Edge Microgateway وكلاء edgemicro_* هؤلاء وينزِّل معلومات الضبط لكلٍّ منهم. وتشمل هذه المعلومات عناوين URL المستهدَفة ومسارات الموارد. من هذه النقطة فصاعدًا، لن يتم استخدام الخوادم الوكيلة. ولن يتم تنفيذ أي سياسات أو مسارات مشروطة في هذه الخوادم الوكيلة.

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

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

هل يمكنني استخدام السياسات مع الخوادم الوكيلة لـ Edge Microgateway؟

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

ما هي أفضل طريقة للتعرّف على Edge Microgateway؟

تقدّم Apigee هذه المراجع: