ضبط عنوان URL للبوابة

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

تعرِض واجهة مستخدم New Edge الزر بوابة المطوّرين في صفحة النشر > البوابات (أو النشر > المطوّرون)، وعند النقر عليه، يتم فتح البوابة المرتبطة بمؤسسة. يفتح هذا الزر تلقائيًا عنوان URL التالي:

http://live-orgname.devportal.apigee.com

حيث orgname هو اسم المؤسسة.

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

ضبط عنوان URL للبوابة لمؤسسة

يمكنك ضبط عنوان URL للبوابة على عنوان URL مختلف لمؤسسة معيّنة، أو إيقاف الزر تمامًا، من خلال ضبط الخصائص التالية في المؤسسة:

  • features.devportalDisabled: اضبطها على false (الإعداد التلقائي) لتفعيل الزر وعلى true لإيقافه.
  • features.devportalUrl: اضبطها على عنوان URL لبوابة مخصّصة للمطوّرين للمؤسسة.

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

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

يعرض هذا الطلب كائنًا يصف المؤسسة بالتنسيق التالي:

{
  "createdAt" : 1428676711119,
  "createdBy" : "me@my.com",
  "displayName" : "orgname",
  "environments" : [ "prod" ],
  "lastModifiedAt" : 1428692717222,
  "lastModifiedBy" : "me@my.com",
  "name" : "orgname",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"
    } ]
  },
  "type" : "paid"
}

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

استخدِم طلب PUT التالي لضبط الخصائص في المؤسسة:

curl -H "Content-Type:application/json" -u adminEmail:pword -X PUT \
  http://ms_IP:8080/v1/organizations/orgname \
  -d '{
    "displayName" : "orgname",
    "name" : "orgname",
    "properties" : {
      "property" : [
        {
          "name" : "foo",
          "value" : "bar"
        },
        {
          "name": "features.devportalUrl",
          "value": "http://dev-orgname.devportal.apigee.com/"
        },
        {
          "name": "features.devportalDisabled",
          "value": "false"
        }
      ]
    }
  }'

في طلب PUT، ما عليك سوى تحديد displayName، name، وproperties. يُرجى العِلم أنّ هذا الطلب يتضمّن السمة foo التي تم ضبطها في الأصل في المؤسسة.

ضبط نموذج عنوان URL احتياطي شامل للبوابة في واجهة مستخدم New Edge

إذا لم يتم ضبط features.devportalUrl في مؤسسة، تستخدِم واجهة مستخدم New Edge النموذج الاحتياطي الشامل الذي تحدّده conf_uebe_dev_portal_template (الذي يتم ضبطه تلقائيًا على http://live-{org}.devportal.apigee.com، حيث يتم استبدال {org} باسم المؤسسة).

لتغيير نموذج عنوان URL الاحتياطي الشامل في واجهة مستخدم New Edge:

  1. افتح الملف /opt/apigee/customer/application/management-ui.properties في أحد المحرّرات. إذا لم يكن الملف موجودًا، أنشِئه:
    vi /opt/apigee/customer/application/management-ui.properties
  2. اضبط conf_uebe_dev_portal_template باستخدام {org} كعنصر نائب لاسم المؤسسة:
    conf_uebe_dev_portal_template="https://portal.mycompany.com/{org}"
  3. احفظ التغييرات وتأكَّد من أنّ المستخدم apigee هو مالك الملف:
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  4. أعِد تشغيل واجهة مستخدم New Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart