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

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

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

مقدمة

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

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

عادةً ما يسجِّل مطوّرو التطبيقات استخدام منتجات واجهة برمجة التطبيقات باستخدام بوابة المطوّرين. يمكنك الاطّلاع على خطوات إنشاء البوابة ونشر منتجات واجهة برمجة التطبيقات في مقالة إنشاء البوابة.

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

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

استكشاف صفحة "التطبيقات"

انتقِل إلى صفحة "التطبيقات" واستكشِفها كما هو موضّح أدناه.

Edge

للوصول إلى صفحة "التطبيقات" باستخدام واجهة مستخدم Edge:

  1. سجِّل الدخول إلى apigee.com/edge.
  2. انقر على النشر > التطبيقات في شريط التنقّل الأيمن.

يتم عرض صفحة "التطبيقات".

كما هو موضّح في الشكل، تتيح لك صفحة "التطبيقات" إجراء ما يلي:

Classic Edge (سحابة خاصة)

للوصول إلى صفحة "التطبيقات" باستخدام واجهة مستخدم Edge الكلاسيكية:

  1. سجِّل الدخول إلى http://ms-ip:9000، حيث يكون ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة "خادم الإدارة".
  2. اختَر النشر > تطبيقات المطوّرين في شريط التنقّل العلوي.

تظهر صفحة "تطبيقات المطوّرين".

تسجيل تطبيق

يمكن تسجيل تطبيق باستخدام إحدى الطريقتَين التاليتَين:

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

تتم إضافة التطبيقات المسجّلة إلى:

لتسجيل تطبيق في Edge:

  1. افتح صفحة "التطبيقات".
  2. انقر على + تطبيق.
  3. حدِّد تفاصيل التطبيق:
    الحقل الوصف مطلوب؟
    الاسم اسم التطبيق. لا يمكنك تغيير الاسم بعد إنشاء التطبيق. يُستخدَم هذا الاسم في طلبات البيانات من واجهة برمجة التطبيقات لإدارة. نعم
    الاسم المعروض اسم العرض للتطبيق الذي يظهر في واجهة مستخدم إدارة Edge وبوابة المطوّرين. لا
    الشركة/المطوّر

    ملاحظة: لا تتوافق حلول Apigee الهجينة مع تطبيقات الشركة، وبالتالي لا ينطبق هذا الحقل.

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

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

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

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

لعرض التطبيقات المسجّلة لمطوّر معيّن، استخدِم إحدى الطريقتَين التاليتَين:

عرض تطبيق وتعديله

لعرض تطبيق وتعديله:

  1. افتح صفحة "التطبيقات".
  2. انقر على صف التطبيق الذي تريد عرضه وتعديله.
    تظهر تفاصيل التطبيق.
  3. لتعديل تطبيق، انقر على تعديل.
  4. نفِّذ مهمة واحدة أو أكثر من المهام التالية:
  5. انقر على حفظ.

إدارة بيانات الاعتماد

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

كما هو موضّح في الشكل السابق، يمكنك في قسم "بيانات الاعتماد" تنفيذ المهام التالية باستخدام واجهة المستخدم:

لاستخدام واجهة برمجة التطبيقات لإدارة بيانات الاعتماد، اطّلِع على الأقسام التالية:

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

للاطّلاع على مفتاح واجهة برمجة التطبيقات والمفتاح السري:

  1. افتح صفحة "التطبيقات".
  2. انقر على صف التطبيق الذي تريد عرض مفتاح واجهة برمجة التطبيقات وسرّه.
  3. في قسم "بيانات الاعتماد"، انقر على عرض بجانب مفتاح واجهة برمجة التطبيقات أو مفتاح المرور الذي تريد الاطّلاع عليه.

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

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

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

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

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

  1. افتح صفحة "التطبيقات".
  2. انقر على صف التطبيق الذي تريد عرضه وتعديله.
  3. انقر على تعديل.
  4. نفِّذ إحدى المهام التالية:
    • للموافقة على مفتاح واجهة برمجة تطبيقات أو إبطاله لجميع منتجات واجهة برمجة التطبيقات المرتبطة بمفتاح واجهة برمجة التطبيقات، اختَر موافَق عليه أو مُلغى في حقل الحالة الخاص بمفتاح واجهة برمجة التطبيقات.
    • للموافقة على مفتاح واجهة برمجة تطبيقات أو إبطاله لمنتج واجهة برمجة تطبيقات معيّن، اختَر موافَق عليه أو مُلغى في عمود "الحالة" لمنتج واجهة برمجة التطبيقات.
  5. انقر على حفظ.

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

يمكنك إدارة منتجات واجهة برمجة التطبيقات في تطبيقك من خلال تنفيذ المهام التالية:

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

لإضافة منتج واجهة برمجة التطبيقات إلى تطبيق:

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

إزالة منتج واجهة برمجة التطبيقات من تطبيق

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

  1. افتح صفحة "التطبيقات".
  2. انقر على صف التطبيق الذي تريد عرضه وتعديله.
  3. انقر على تعديل.
  4. انقر على بجانب منتج واجهة برمجة التطبيقات.
  5. انقر على حفظ.

يمكنك إعادة إضافة منتج تمت إزالته.

إنشاء بيانات اعتماد جديدة

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

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

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

الموافقة على تطبيق أو إبطال موافقتك عليه

.

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

إذا كان التطبيق مسجَّلاً في مؤسسات أخرى، عليك إبطاله في كل من تلك المؤسسات. قد يستغرق الأمر بضع دقائق حتى تتعرّف جميع معالجات الرسائل على التغييرات.

للموافقة على تطبيق أو إبطاله، اتّبِع الخطوات التالية:

  1. افتح صفحة "التطبيقات".
  2. انقر على صف التطبيق الذي تريد عرضه وتعديله.
  3. انقر على تعديل.
  4. اختَر موافقة أو إبطال في حقل حالة التطبيق للموافقة على التطبيق أو إبطال الموافقة عليه، على التوالي.
  5. انقر على حفظ.

حذف تطبيق

عند حذف تطبيق، تصبح جميع مفاتيح العميل المرتبطة بالتطبيقات غير صالحة. يؤدي استخدام مفتاح غير صالح في طلب إلى تعذُّر تنفيذه.

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

لحذف تطبيق:

  1. افتح صفحة "التطبيقات".
  2. ضع المؤشر في صف التطبيق الذي تريد حذفه.
  3. انقر على في عمود الإجراءات.

ملاحظة: باستخدام Apigee Edge for Public Cloud، يتم حذف تطبيق المطوّر والعناصر المرتبطة به بشكل غير متزامن. يتم حذف تطبيق المطوِّر على الفور، ولكن قد يستغرق حذف الموارد المرتبطة به، مثل مفاتيح التطبيق أو الرموز المميّزة للوصول، من بضع ثوانٍ إلى بضع دقائق تلقائيًا.

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

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

راجِع أيضًا استيراد مفاتيح العملاء والأسرار الحالية.