الحصول على بيانات اعتماد العميل

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

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

ما هي بيانات اعتماد العميل؟

للمشاركة في أي مسار OAuth 2.0، يجب تسجيل جميع تطبيقات العميل في Apigee Edge (خادم التفويض). عند تسجيل تطبيقك، سيتم تخصيص مفتاحَين لك: رقم تعريف المستهلك وسر المستهلك. رقم تعريف المستهلك هو مفتاح علني ويجب ألا يتم نشر سر المستهلك مطلقًا. تسمح مفاتيح بيانات اعتماد العميل هذه لـ Apigee Edge بتحديد تطبيق العميل بشكل فريد.

الخطوات السريعة

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

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

    Edge

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

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

    Classic Edge (السحابة الإلكترونية الخاصة)

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

    1. سجِّل الدخول إلى http://ms-ip:9000، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة "خادم الإدارة".
    2. انقر على نشر > تطبيقات المطوّرين في شريط التنقّل العلوي.
  2. انقر على تطبيق الطقس لفتح صفحة النظرة العامة على "تطبيق الطقس". لاحِظ أنّ المطوّر المرتبط بالتطبيق هو Nicolai Tesla. تم توفير هذا التطبيق والمطوّر تلقائيًا عند إنشاء مؤسستك. يجب أن يكون لكل تطبيقات المطوّرين مطوّر مرتبط بها.
  3. في قسم المنتجات ، انقر على عرض بجانب منتج Premium Weather API لعرض قيمتَي "رقم تعريف المستهلك" و"سر المستهلك".
  4. انسخ هاتَين القيمتَين واحفظهما، لأنّك ستحتاج إلى استخدامهما لاحقًا لإجراء طلبات إلى واجهة برمجة التطبيقات للحصول على رموز الدخول.

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

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

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps \
-u email:password

يعرض هذا الطلب قائمة بالتطبيقات حسب رقم تعريف التطبيق.

[ "da496fae-2a04-4a5c-b2d0-709278a6f9db", "50e3e831-175b-4a05-8fb6-05a54701af6e" ]

يمكنك استرداد ملف تعريف التطبيق من خلال إجراء طلب GET بسيط على رقم تعريف التطبيق:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/{app_id} \
-u email:password

على سبيل المثال:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/da496fae-2a04-4a5c-b2d0-709278a6f9db \
-u email:password

يعرض طلب بيانات من واجهة برمجة التطبيقات ملف تعريف التطبيق الذي حدّدته. على سبيل المثال، يحتوي ملف تعريف تطبيق لـ weatherapp على تمثيل JSON التالي:

{
  "accessType" : "read",
  "apiProducts" : [ ],
  "appFamily" : "default",
  "appId" : "da496fae-2a04-4a5c-b2d0-70928a6f9db",
  "attributes" : [ ],
  "callbackUrl" : "http://weatherapp.com",
  "createdAt" : 1380290158713,
  "createdBy" : "noreply_admin@apigee.com",
  "credentials" : [ {
    "apiProducts" : [ {
      "apiproduct" : "PremiumWeatherAPI",
      "status" : "approved"
    } ],
    "attributes" : [ ],
    "consumerKey" : "bBGAQrXgivA9lKu7NMPyYpVKNhGar6K",
    "consumerSecret" : "hAr4Gn0gA9vyvI4",
    "expiresAt" : -1,
    "issuedAt" : 1380290161417,
    "scopes" : [ ],
    "status" : "approved"
  } ],
  "developerId" : "5w95xGkpnjzDBT4",
  "lastModifiedAt" : 1380290158713,
  "lastModifiedBy" : "noreply_admin@apigee.com",
  "name" : "weatherapp",
  "scopes" : [ ],
  "status" : "approved"
}

لاحِظ القيم لـ consumerKey وconsumerSecret.

نظرة متعمّقة

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