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

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

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

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

ضبط الاتصال بين البوابة وEdge

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

:

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