الاتصال بين بوابة تستند إلى Drupal وEdge

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

تعمل بوابة "خدمات المطوِّرين" كعميل لخدمة Apigee Edge. وهذا يعني أنّ البوابة لا تعمل كنظام مستقل. بدلاً من ذلك، يتم في الواقع تخزين الكثير من المعلومات التي تستخدمها البوابة على Edge. عند الضرورة، تُجري البوابة طلب HTTP أو HTTPS لاسترداد المعلومات من Edge أو لإرسال المعلومات إلى Edge.

لا يرسل Edge طلبات إلى البوابة، بل يستجيب فقط للطلبات الواردة من البوابة. وبالتالي، تبدأ جميع التفاعلات بين البوابة وEdge.

ضبط عملية الربط بين البوابة وEdge

هناك ثلاث معلومات تحتاج إليها البوابة للتواصل مع Edge، كما هو موضّح أدناه.

• عنوان URL لنقطة نهاية Edge
  
  نقطة النهاية التلقائية لإصدار Edge المستنِد إلى السحابة الإلكترونية هي https://api.enterprise.apigee.com/v1.
  
  بالنسبة إلى التثبيت في Private Cloud، سيظهر عنوان URL على النحو التالي: http://EdgePrivateCloudIp:8080/v1 أو https://EdgePrivateCloudIp:TLSport/v1.
  
  حيث يكون EdgePrivateCloudIp هو عنوان IP لخادم إدارة Edge ويكون TLSport هو منفذ TLS/SSL لواجهة برمجة تطبيقات إدارة Edge. مثلاً، 8443.
• اسم مؤسسة Apigee
  
  هذا هو اسم مؤسستك على Edge. يمكنك إعداد المؤسسة عند إنشاء حسابك على Edge.
• اسم المستخدم وكلمة المرور لمشرف المطوّر
  
  تتم مصادقة الطلبات من البوابة إلى Edge وتتطلب مستخدمًا لديه امتيازات مشرف المطوّر. عندما يتم توفير بوابة مطوِّر البرامج لك، تتم إضافة دور مشرف المطوِّر إلى مؤسستك. وهذا الدور، الذي يضم مستخدمًا واحدًا يُسمى devadmin+{org_name}@apigee.com، يهدف فقط إلى ربط "بوابة المطوِّر" الخاصة بك بمؤسستك على Edge. وبما أنّ البوابة تعرض تطبيقات مطوّري برامج Edge ومنتجات واجهة برمجة التطبيقات وما إلى ذلك، يجب أن تبقى متزامنة مع بنية Edge من خلال إجراء طلبات بيانات من واجهة برمجة تطبيقات الإدارة التي تتطلّب مصادقة. يمتلك "مستخدم" devadmin الأذونات اللازمة.
  

لعرض معلومات الاتصال:

1. في قائمة إدارة Drupal، اختَر الإعدادات > بوابة مطوّري البرامج > إعدادات التطبيق.

لتغيير الإعدادات:

تعتمد كيفية تغيير الضبط على تثبيت البوابة وإصدارها:

• تثبيت مستند إلى السحابة الإلكترونية للإصدار 15.01.06 والإصدارات الأحدث من البوابة: عليك تقديم طلب إلى فريق دعم Apigee Edge لتغيير معلومات الاتصال. على سبيل المثال، إذا كنت تريد تغيير اسم المؤسسة.
• التثبيت داخل المؤسسة والبوابة المستندة إلى السحابة الإلكترونية التي تسبق الإصدار 15.01.06: يمكنك تغيير معلومات الاتصال كما هو موضّح أدناه:

1. في قائمة إدارة Drupal، اختَر الضبط > إعدادات بوابة مطوّري البرامج.
2. أدخِل اسم مؤسستك في مؤسسة Management API.
3. أدخِل عنوان URL لنقطة نهاية Edge في عنوان URL لنقطة نهاية واجهة برمجة التطبيقات للإدارة.
4. أدخِل بيانات اعتماد مشرف المؤسسة في المستخدم الذي تمت المصادقة عليه من نقطة النهاية وكلمة المرور الخاصة بالمستخدم الذي تمت المصادقة عليه.
5. اختَر اختبار الاتصال للتأكد من نجاح الاتصال.
6. اختَر حفظ الضبط.

ضمان الوصول إلى Edge من البوابة

بما أنّ الكثير من المعلومات التي تستخدمها البوابة يتم تخزينها على Edge، يجب أن تتأكّد من أنّ البوابة يمكنها الوصول إلى Edge. تبدأ البوابة الاتصال مع Edge من خلال تقديم طلبات REST عبر HTTP وHTTPS. على سبيل المثال، عندما يسجّل مطوّر البرامج تطبيقًا جديدًا على البوابة، ترسل البوابة طلبًا إلى Edge لإرسال معلومات حول التطبيق إلى Edge.

يمكن نشر كل من Edge والبوابة في السحابة الإلكترونية أو في مقر الشركة، ويمكنك الخلط بين أنواع عمليات النشر. على سبيل المثال، يمكنك نشر كلا التنسيقَين في السحابة الإلكترونية، سواء في المقر الرئيسي، أو نشر حزمة في السحابة الإلكترونية وأخرى في الإدارة:

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

إدارة التطبيقات ومفاتيح واجهة برمجة التطبيقات من البوابة

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

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

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

على سبيل المثال، يسجّل أحد مطوّري البرامج الدخول إلى البوابة وينتقل إلى صفحة "تطبيقاتي". لتعبئة صفحة "تطبيقاتي"، ترسل البوابة طلبًا إلى Edge لاسترداد المعلومات حول تطبيقات المطوّر ومفاتيح واجهة برمجة التطبيقات. وتظهر تلك المعلومات بعد ذلك في صفحة "تطبيقاتي" لدى المطوّر في البوابة:

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

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

• إضافة تطبيق مطوِّر أو إزالته أو تعديله
• إبطال مفتاح واجهة برمجة التطبيقات أو الموافقة عليه لتطبيق

يظهر أدناه التطبيق نفسه، "My Weather App"، كما يظهر للمشرف على واجهة مستخدم Edge:

إدارة المطوّرين من البوابة

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

تتضمن معلومات المطور المخزنة على Edge ما يلي:

• الاسم الأوّل
• اسم العائلة
• عنوان البريد الإلكتروني
• المعلومات الإضافية الاختيارية التي تم إرسالها من البوابة

وتخزِّن البوابة المعلومات نفسها المتوفّرة في متصفّح Edge، ولكنها تخزِّن أيضًا معلومات إضافية، بما في ذلك:

• كلمة مرور البوابة
• حالة حساب المدخل: نشط أو محظور
• دور البوابة: مستخدم تمت مصادقته أو مشرف أو غير ذلك
• الأذونات المستندة إلى الدور: تحديد الإجراءات التي يُسمح للمطوّر بتنفيذها على المنصة

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

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

لمزيد من المعلومات، اطّلِع على إضافة حسابات المستخدمين وإدارتها.

مزامنة مطوري التطبيقات بين البوابة وEdge

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

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

لمزامنة البوابة مع مطوري التطبيقات على Edge

:

• سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
• اختَر الأشخاص في قائمة إدارة Drupal.
• حدد الزر Dev البوابة Developer Sync في أعلى الصفحة للمزامنة مع مطوري التطبيقات على Edge.