إنشاء بوابة متكاملة

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

توفّر Apigee Edge بوابة متكاملة سهلة الاستخدام لتوثيق واجهات برمجة التطبيقات وإدارة إمكانية الوصول إليها، وتعزيز مجتمع مطوّري التطبيقات.

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

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

توفّر لك البوابة المتكاملة المزايا والميزات الرئيسية التالية:

الميزة	المزايا
تطوير محتوى البوابة	يمكنك تطوير محتوى البوابة بسرعة وسهولة. إنشاء صفحات باستخدام محرّر الصفحات السهل الاستخدام استخدام Markdown وHTML لإنشاء المحتوى إضافة قوائم للتنقّل في البوابة
مظهر البوابة	يمكنك تخصيص مظهر البوابة بالكامل باستخدام أوراق الأنماط SCSS والعلامة التجارية المخصّصة.
مستند واجهة برمجة التطبيقات	يمكنك إنشاء مستندات مرجعية لواجهة برمجة التطبيقات تلقائيًا استنادًا إلى مواصفات OpenAPI.
التسجيل الذاتي	يمكنك توفير عملية تسجيل ذاتية للمطوّرين لإنشاء تطبيقات باستخدام واجهات برمجة التطبيقات.
إدارة الجمهور	يمكنك التحكّم في المستخدمين الذين يمكنهم الوصول إلى محتوى البوابة وواجهات برمجة التطبيقات.
إحصاءات Google	يمكنك ضبط "إحصاءات Google" وتتبُّع الإحصاءات المخصّصة.
التخصيصات المتقدّمة	يمكنك إجراء تخصيصات متقدّمة للبوابة، بما في ذلك: تخصيص نطاقك إضافة حقول تسجيل مخصّصة توسيع نطاق البوابة باستخدام البرامج النصية ضبط بريدك الإلكتروني

البدء في إنشاء البوابة

كيف تعالج Apigee الأمان في البوابة المتكاملة؟

يوضّح الجدول التالي كيف تعالج Apigee الأمان من خلال الميزات المضمّنة في البوابة المتكاملة.

الميزة	العناوين
تتطلّب بروتوكول HTTPS وأمان طبقة النقل (TLS)	تفرض الاتصال المشفّر
تتضمّن تسجيل نطاق apigee.io باستخدام قائمة اللاحقات العامة	تمنع ضبط "ملفات تعريف الارتباط الكبيرة" على النطاقات الفرعية لـ apigee.io
تتيح ضبط سياسة أمان المحتوى (CSP)	تحمي من هجمات النصوص البرمجية على المواقع الإلكترونية (XSS) وهجمات حقن الرموز البرمجية الأخرى
تتطلّب ما يلي: تنقيح إدخالات النموذج يقتصر حقن JavaScript على مستوى الموقع الإلكتروني على المشرفين	تحمي من هجمات حقن HTML أو SQL أو من جهة الخادم
تتضمّن عنوان XSS x-content-type-options: nosniff	تمنع المتصفّحات من محاولة تخمين أنواع MIME
تتضمّن عنوان XSS x-frame-options: deny	تمنع تضمين محتوى البوابة في إطار iframe
تتضمّن عنوان XSS x-xss-protection: 1	تمنع تحميل الصفحات عند رصد هجمات النصوص البرمجية على المواقع الإلكترونية (XSS) المنعكسة
تستخدم رموز CSRF المميّزة	تحمي من هجمات تزوير الطلبات بين المواقع الإلكترونية
تستفيد من ما يلي: تشفير بيانات Google Cloud أثناء الراحة سياسات الاحتفاظ ببيانات المستخدمين في Google وسياسات بيانات المستخدمين عزل المستأجرين الاحتفاظ ببيانات السجلّ وبيانات تصحيح الأخطاء (6 أسابيع)	إجراءات حماية بيانات العملاء

كيف تتواصل البوابة المتكاملة مع Edge؟

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

تقدّم الأقسام التالية مزيدًا من التفاصيل.

مكان تخزين تسجيل التطبيق ومفاتيح واجهة برمجة التطبيقات

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

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

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

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

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

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

مكان تخزين معلومات حساب مطوّر التطبيق

يتم تخزين معلومات حساب المطوّر على Edge، على النحو التالي:

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

يتم تخزين معلومات حساب المستخدِم التالية على Edge:

• الاسم الأول واسم العائلة
• عنوان البريد الإلكتروني
• اسم المستخدم
• حالة حساب البوابة (نشط أو غير نشط)
• دور البوابة (مستخدِم مصادَق عليه أو مشرف أو غير ذلك)
• الأذونات المستندة إلى الدور
• الفِرق التي ينتمي إليها مستخدِم البوابة (إذا كنت قد سجّلت في الإصدار التجريبي من ميزة الفِرق)

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تسجيل مطوّري التطبيقات.

مكان تخزين معلومات فريق المطوّرين (إصدار تجريبي)

عندما ينشئ مستخدِم بوابة فريق مطوّرين على البوابة، يتم تخزين معلومات فريق المطوّرين على Edge، بما في ذلك:

• اسم فريق المطوّرين ووصفه
• أعضاء فريق المطوّرين وأدوارهم
• التطبيقات التي تم تعيينها لفريق المطوّرين
• شرائح الجمهور المعيّنة لفريق المطوّرين
• وقت إنشاء فريق المطوّرين

يتم إنشاء عنوان بريد إلكتروني فريد يتم إنشاؤه تلقائيًا لفريق المطوّرين، ويُستخدم كمفتاح أساسي يستخدِمه Edge لتحديد فريق المطوّرين.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي مشاركة مسؤولية تطبيق باستخدام فِرق المطوّرين (إصدار تجريبي) وإدارة فِرق المطوّرين.

لمحة عن البوابة النموذجية

عند إنشاء بوابة جديدة، يتم توفير مجموعة من صفحات البداية لاستخدامها كنقطة انطلاق. تحتوي صفحات البداية على محتوى تجريبي للمساعدة في إلهام عملية تطوير البوابة الخاصة بك أثناء استبدال النص والصور بمحتواك الفريد. يستخدم مظهر البوابة النموذجية تصميم Material وتنسيق SCSS.

تعرض الصورة التالية الصفحة الرئيسية للبوابة النموذجية.

تتضمّن صفحات البداية المتوفّرة مع البوابة النموذجية ما يلي:

الصفحة	الوصف
الصفحة الرئيسية	الصفحة الرئيسية للبوابة التي تصف واجهات برمجة التطبيقات المعروضة تُستخدم كصفحة رئيسية تلقائية لبوابتك (index.html) توضّح كيفية استخدام مكوّنات تصميم Material في Angular، كما هو موضّح في مقالة إضافة مكوّنات تصميم Material في Angular
البدء بسرعة	مجموعة من خطوات البدء السريع التي توضّح كيفية تخصيص البوابة انقر على البدء بسرعة في البوابة النموذجية للانتقال إلى خطوات إضافة محتوى إلى صفحة البدء.
البدء	صفحة محتوى نموذجية يُرجى الاطّلاع على صفحة البدء في البوابة النموذجية لمعرفة كيفية تعديل هذه الصفحة وإضافتها إلى شريط التنقّل العلوي.
واجهات برمجة التطبيقات	قائمة بواجهات برمجة التطبيقات المتاحة عند إنشاء مستندات مرجع واجهة برمجة التطبيقات التفاعلية، تتم إضافة روابط إلى المحتوى في هذه الصفحة تلقائيًا. ملاحظة: يتم إنشاء محتوى هذه الصفحة تلقائيًا استنادًا إلى واجهات برمجة التطبيقات التي تنشرها على بوابتك. لا يمكنك تعديل محتوى هذه الصفحة مباشرةً، ولا تظهر في قائمة الصفحات. يمكنك تعديل تصميم الصفحة باستخدام محرّر مظهر البوابة.
تطبيقاتي	قائمة بالتطبيقات المسجّلة لمستخدِم مأذون يُرجى الاطّلاع على مقالة كيفية تفاعل مستخدِمي البوابة مع بوابتك. ملاحظة: يتم إنشاء محتوى هذه الصفحة تلقائيًا استنادًا إلى تطبيقات المستخدِم المسجّلة. لا يمكنك تعديل محتوى الصفحة مباشرةً، ولا تظهر في قائمة الصفحات. يمكنك تعديل تصميم الصفحة باستخدام محرّر المظهر.
تسجيل الدخول	صفحة تسجيل الدخول للمستخدِمين المسجّلين يمكن للمستخدِمين الجدد التسجيل من هذه الصفحة من خلال النقر على تسجيل الدخول. يُرجى الاطّلاع على مقالة كيفية تفاعل مستخدِمي البوابة مع بوابتك. ملاحظة: يتم تضمين صفحة "تسجيل الدخول" في بوابتك تلقائيًا. يمكنك تخصيص الشعار في صفحة "تسجيل الدخول" وإضافة حقول تسجيل مخصّصة إلى صفحة "إنشاء حساب". لا يمكنك تعديل محتوى الصفحة مباشرةً، ولا تظهر في قائمة الصفحات.
الأحكام والشروط	صفحة نموذجية للأحكام والشروط

دعم المتصفح

تتطابق إصدارات المتصفّحات التي تتوافق مع البوابات المتكاملة في Apigee مع إصدارات المتصفّحات التي تتوافق مع Apigee Edge.