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

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

يتيح "بوابة مخصّصة للمطوّرين" للمستخدمين إنشاء حساب المستخدم وتسجيل الدخول وإدارة التطبيقات التي ستستهلك واجهات برمجة التطبيقات.

توضّح الأقسام التالية كيفية تفاعل مستخدمي البوابة مع البوابة.

تسجيل الدخول إلى البوابة

توضّح الأقسام التالية كيفية تسجيل دخول مستخدمي البوابة إلى البوابة المدمجة باستخدام بيانات اعتماد المستخدم (موفّر الهوية المضمّن) أو باستخدام SAML (إصدار تجريبي).

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

تسجيل الدخول إلى البوابة باستخدام بيانات اعتماد المستخدم (موفِّر الهوية المضمّن)

عند تفعيل مزوّد خدمة تحديد الهوية المضمّن، يمكن لمستخدمي البوابة تسجيل الدخول إلى البوابة المدمجة باستخدام بيانات اعتماد المستخدم (اسم المستخدم وكلمة المرور)، كما هو موضّح في الأقسام التالية:

• إنشاء حساب مستخدم على البوابة المدمجة
• تسجيل الدخول إلى البوابة المدمجة
• تغيير كلمة المرور

إنشاء حساب مستخدم على البوابة المدمجة

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

ينشئ مستخدمو البوابة حساب مستخدم على البوابة المدمجة باتّباع الخطوات التالية:

1. انتقِل إلى البوابة.

2. انقروا على تسجيل الدخول.

   تظهر صفحة "تسجيل الدخول".

3. انقر على إنشاء حساب.

   ستظهر صفحة "إنشاء حسابك".

   

4. أكمل النموذج.

   يجب إدخال قيم في جميع الحقول المطلوبة. يجب أن تتكوّن كلمات المرور من 8 أحرف على الأقل وأن تتضمّن نوعًا واحدًا على الأقل من كل مما يلي: رقم وحرف صغير وحرف كبير ورمز خاص.

5. راجِع البنود ووافِق عليها.

6. انقر على إنشاء حساب.

7. أكمِل نموذج CAPTCHA وانقر على التحقّق (إذا ظهر).

   يتم إنشاء حساب المستخدم وإرسال رسالة تأكيد إلكترونية.

8. في غضون 10 دقائق، انقر على الرابط في رسالة التأكيد الإلكترونية لإكمال عملية التسجيل.

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

9. سجِّل الدخول إلى البوابة المدمجة (الموضّحة أدناه).

تسجيل الدخول إلى البوابة المدمجة

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

يسجّل مستخدمو البوابة الدخول على النحو التالي:

1. انتقِل إلى البوابة.
2. انقروا على تسجيل الدخول. تظهر صفحة "تسجيل الدخول":
3. أدخِل عنوان البريد الإلكتروني وكلمة المرور.
4. انقروا على تسجيل الدخول.

تغيير كلمة المرور

باستخدام موفّر الهوية المضمّن، يمكن لمستخدمي البوابة تغيير كلمة المرور باتّباع الخطوات التالية:

1. انتقِل إلى البوابة.
2. انقروا على تسجيل الدخول.
3. انقر على إعادة ضبط كلمة المرور.
4. أدخِل عنوان البريد الإلكتروني للحساب الذي تريد إعادة ضبطه.

5. انقر على إرسال رابط إعادة ضبط كلمة المرور.

   يتم إرسال رابط إعادة ضبط كلمة المرور إلى البريد الإلكتروني.

6. انقر على الرابط في رسالة التأكيد الإلكترونية.

7. أدخِل كلمة المرور الجديدة وأكِّدها.

   يجب أن تتكوّن كلمات المرور من 8 أحرف على الأقل وأن تتضمّن نوعًا واحدًا على الأقل من كل مما يلي: رقم وحرف صغير وحرف كبير ورمز خاص.

8. انقر على إنشاء كلمة مرور جديدة.

تسجيل الدخول إلى البوابة باستخدام مصادقة SAML (إصدار تجريبي)

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

1. انتقِل إلى البوابة.
2. انقروا على تسجيل الدخول.

3. انقر على تسجيل الدخول باستخدام SAML.

   تتم إعادة توجيهك إلى موفِّر SAML.

4. أدخِل بيانات اعتماد موفِّر الهوية عبر SAML عندما يُطلب منك ذلك.

عرض مستندات مرجع واجهة برمجة التطبيقات

يمكن لمستخدمي البوابة الاطّلاع على مستندات مرجع واجهة برمجة التطبيقات التي نشرتها على البوابة، وذلك على النحو التالي:

1. انتقِل إلى البوابة.

2. انقر على واجهات برمجة التطبيقات في شريط التنقّل العلوي. يتم عرض صفحة واجهات برمجة التطبيقات. على سبيل المثال:
   
   

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

4. انقر على بطاقة واجهة برمجة تطبيقات لعرض مستندات مرجع واجهة برمجة التطبيقات. يتم عرض المستندات المرجعية الخاصة بواجهة برمجة التطبيقات.

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

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

تتيح فِرق المطوّرين لمستخدمي البوابة مشاركة مسؤولية أحد التطبيقات مع مستخدمين آخرين للبوابة. توضّح الأقسام التالية كيفية إنشاء فِرق المطوّرين وإدارتها.

لمحة عن أدوار فريق المطوّرين

يلخّص الجدول التالي الأدوار التي يمكن منحها لأعضاء فريق المطوّرين:

الدور	الوصف
مشرف التطبيق	أذونات القراءة فقط لأعضاء فريق المطوّرين وتفاصيل فريق المطوّرين امتيازات القراءة والكتابة للتطبيقات
المالك	امتيازات القراءة والكتابة الكاملة لأعضاء فريق المطوّرين وتفاصيل فريق المطوّرين والتطبيقات
مُشاهد	أذونات القراءة فقط لأعضاء فريق المطوّرين وتفاصيل فريق المطوّرين والتطبيقات

عرض صفحة "الفِرق"

تعرض صفحة "الفرق" فِرق المطوّرين التي أنت عضو فيها.

للوصول إلى صفحة "الفِرق"، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى البوابة.
2. اختَر الفِرق من القائمة المنسدلة لحساب المستخدم في البوابة.

يتم عرض صفحة "الفِرق" التي تتيح لك إجراء ما يلي:

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

إضافة فِرق المطوّرين

لإضافة فريق مطوّرين، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى البوابة.
2. اختَر الفِرق من القائمة المنسدلة لحساب المستخدم في البوابة.
3. انقر على + فريق جديد.
4. أدخِل اسمًا ووصفًا.

5. لإضافة عضو إلى فريق المطوّرين، انقر على + إضافة عضو آخر، وأدخِل عنوان البريد الإلكتروني لمستخدم البوابة، واختَر دور فريق المطوّرين.

   كرِّر هذه الخطوات لإضافة المزيد من الأعضاء.

6. لحذف أحد أعضاء فريق المطوّرين، انقر على بجانب عضو فريق المطوّرين الذي تريد حذفه.

7. انقر على إنشاء.

تعديل عضوية فريق المطوّرين وأدواره

لتعديل عضوية فريق المطوّرين وأدواره، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى البوابة.
2. اختَر الفِرق من القائمة المنسدلة لحساب المستخدم في البوابة.
3. انقر في صف فريق المطوّرين الذي تريد تعديله والذي أنت مالك له.

4. نفِّذ خطوة واحدة أو أكثر من الخطوات التالية:

   • عدِّل الاسم والوصف وجهة الاتصال الأساسية.
   • إضافة أعضاء إلى فريق المطوّرين أو إزالتهم
   • تعديل أدوار أعضاء فريق المطوّرين

5. انقر على حفظ.

إزالة نفسك من فريق مطوِّرين

لإزالة نفسك من فريق مطوّرين، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى البوابة.
2. اختَر الفِرق من القائمة المنسدلة لحساب المستخدم في البوابة.
3. انقر على صف فريق المطوّرين الذي تريد إزالة نفسك منه.
4. انقر على مغادرة الفريق.

حذف فريق مطوّرين

لحذف فريق مطوّرين، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى البوابة.
2. اختَر الفِرق من القائمة المنسدلة لحساب المستخدم في البوابة.
3. انقر على صف فريق المطوّرين الذي تريد حذفه.
4. انقر على .
5. انقر على تأكيد لتأكيد الحذف.

تسجيل التطبيقات

سجِّل تطبيقات المطوّرين وتطبيقات فريق المطوّرين، كما هو موضّح في الأقسام التالية.

تسجيل تطبيقات المطوّر

يمكن لمستخدمي البوابة تسجيل التطبيقات لاستخدام واجهات برمجة التطبيقات التي نشرتها، وذلك باتّباع الخطوات التالية:

1. اختَر التطبيقات من القائمة المنسدلة لحساب المستخدِم.
2. انقر على + تطبيق جديد لإنشاء تطبيق جديد.
3. أدخِل اسمًا ووصفًا للتطبيق في مربّع الحوار "تطبيق جديد".

4. اختَر مالك التطبيق من القائمة المنسدلة المالك.

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

5. في قسم "قائمة واجهات برمجة التطبيقات"، اختَر واجهة برمجة تطبيقات واحدة أو أكثر.

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

6. إذا اخترت واجهة برمجة تطبيقات في قسم "واجهات برمجة التطبيقات التي تتطلّب المصادقة"، أدخِل عنوان URL لردّ الاتصال.

   لمزيد من المعلومات، اطّلِع على مقالة لمحة عن عناوين URL الخاصة بعمليات ردّ الاتصال.

7. انقر على إنشاء.

تسجيل تطبيقات فريق المطوّرين

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

لمزيد من المعلومات حول كيفية:

• يضيف مستخدمو البوابة الفرق ويديرونها، كما هو موضّح في مقالة مشاركة المسؤولية عن تطبيق باستخدام فِرق المطوّرين (إصدار تجريبي).
• يمكن لموفّري واجهات برمجة التطبيقات عرض فِرق المطوّرين وإدارتها، كما هو موضّح في إدارة فِرق المطوّرين.

لتسجيل تطبيقات فريق المطوّرين، اتّبِع الخطوات التالية:

1. اختَر الفِرق من القائمة المنسدلة لحساب المستخدم.
2. انقر على صف فريق المطوّرين الذي تريد تسجيل تطبيق له.
3. انقر على + تطبيق جديد لإنشاء تطبيق جديد.
4. أدخِل اسمًا ووصفًا للتطبيق في مربّع الحوار "تطبيق جديد".

5. اختَر مالك التطبيق من القائمة المنسدلة المالك.

   يكون فريق المطوّرين هو مالك التطبيق تلقائيًا. ويمكنك اختيار فريق مطوّرين مختلف أو اختيار نفسك كمالك من القائمة المنسدلة إذا أردت ذلك.

6. في قسم "قائمة واجهات برمجة التطبيقات"، اختَر واجهة برمجة تطبيقات واحدة أو أكثر.

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

7. إذا اخترت واجهة برمجة تطبيقات في قسم "واجهات برمجة التطبيقات التي تتطلّب المصادقة"، أدخِل عنوان URL لردّ الاتصال.

   لمزيد من المعلومات، اطّلِع على مقالة لمحة عن عناوين URL الخاصة بعمليات ردّ الاتصال.

8. انقر على إنشاء.

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

بصفتك منتج واجهة برمجة تطبيقات، يمكنك نشر واجهات برمجة التطبيقات للسماح لمستخدمي البوابة باستخدام منتجات واجهة برمجة التطبيقات.

يدير مستخدمو البوابة واجهات برمجة التطبيقات التي تستخدمها تطبيقاتهم. تتم إضافة واجهات برمجة التطبيقات إلى صفحة تفاصيل التطبيق. بالنسبة إلى بعض واجهات برمجة التطبيقات، لا تتم الموافقة تلقائيًا. تشير الحالة في انتظار الموافقة إلى واجهة برمجة تطبيقات تم طلب الوصول إليها ولكن لم تتم الموافقة عليها بعد.

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

1. اختَر التطبيقات من القائمة المنسدلة لحساب المستخدِم.
2. انقر على التطبيق في القائمة.
3. في قسم "واجهات برمجة التطبيقات"، انقر على أو لتفعيل إمكانية الوصول إلى واجهة برمجة تطبيقات من التطبيق أو إيقافها، على التوالي.
4. بالنسبة إلى واجهة برمجة التطبيقات التي تتطلّب مصادقة، أضِف عنوان URL لبرنامج معالجة المكالمات أو عدِّله حسب الحاجة.

عرض مفتاح واجهة برمجة التطبيقات وكلمة المرور لتطبيق

يمكن لمستخدمي البوابة إدارة مفتاح واجهة برمجة التطبيقات لأحد التطبيقات من البوابة على النحو التالي:

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

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

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

يمكن لمستخدمي البوابة تغيير مفتاح واجهة برمجة التطبيقات لأحد التطبيقات من البوابة باتّباع الخطوات التالية:

1. اختَر التطبيقات من القائمة المنسدلة لحساب المستخدِم.
2. انقر على التطبيق في القائمة.
3. في قسم "مفاتيح واجهة برمجة التطبيقات"، انقر على إضافة مفتاح.
4. انقر على تأكيد في مربّع الحوار لتأكيد العملية.
5. يمكنك اختياريًا إبطال مفتاح واجهة برمجة التطبيقات القديم، كما هو موضّح أدناه.

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

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

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

1. اختَر التطبيقات من القائمة المنسدلة لحساب المستخدِم.
2. انقر على اسم التطبيق.
3. في قسم "مفاتيح واجهة برمجة التطبيقات"، انقر على في عمود "الإجراءات" المرتبط بمفتاح واجهة برمجة التطبيقات الذي تريد إبطاله.

4. انقر على تأكيد لتأكيد العملية.

   يتم تعديل حالة المفتاح إلى "تم إبطال الموافقة".

تعديل تفاصيل التطبيق

يمكن لمستخدمي البوابة تعديل تفاصيل التطبيق باتّباع الخطوات التالية:

1. اختَر التطبيقات من القائمة المنسدلة لحساب المستخدِم.
2. انقر على التطبيق في القائمة.
3. عدِّل حقلَي "الاسم" أو "الوصف" في علامة التبويب "تفاصيل التطبيق".
4. إدارة واجهات برمجة التطبيقات في أحد التطبيقات حسب الحاجة
5. انقر على حفظ.

حذف تطبيق

يمكن لمستخدمي البوابة حذف تطبيق منها باتّباع الخطوات التالية:

1. اختَر التطبيقات من القائمة المنسدلة لحساب المستخدِم.
2. انقر على التطبيق في القائمة.
3. انقر على حذف.
4. انقر على تأكيد لتأكيد العملية.

يتم حذف التطبيق وإزالته من قائمة "التطبيقات".