הגדרת כתובת ה-URL של הפורטל

‫Apigee מספקת לכם את פורטל Apigee Developer Services (או פשוט הפורטל), שבו תוכלו ליצור ולהשיק אתר מותאם אישית משלכם כדי לספק את כל השירותים האלה לקהילת המפתחים שלכם. לקוחות Edge יכולים ליצור פורטל מפתחים משלהם, בענן או באופן מקומי. מידע נוסף זמין במאמר מה זה פורטל למפתחים?

בממשק המשתמש החדש של Edge, הלחצן DevPortal מופיע בדף Publish > Portals (או Publish > Developers). כשלוחצים עליו, נפתח הפורטל שמשויך לארגון. כברירת מחדל, הלחצן הזה פותח את כתובת ה-URL הבאה:

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

כאשר orgname הוא שם הארגון.

אפשר להגדיר את כתובת ה-URL של פורטל למפתחים ברמת הארגון באמצעות מאפייני הארגון, או להגדיר תבנית של כתובת URL גלובלית חלופית בממשק המשתמש החדש של Edge.

הגדרת כתובת ה-URL של הפורטל לארגון

אתם יכולים להגדיר כתובת URL אחרת לפורטל עבור ארגון ספציפי, או להשבית את הלחצן לחלוטין, על ידי הגדרת המאפיינים הבאים בארגון:

• ‫features.devportalDisabled: מגדירים את הערך false (ברירת המחדל) כדי להפעיל את הכפתור, ואת הערך true כדי להשבית אותו.
• ‫features.devportalUrl: מוגדר לכתובת ה-URL של פורטל המפתחים של הארגון.

אתם מגדירים את המאפיינים האלה בנפרד לכל ארגון. כדי להגדיר את המאפיינים האלה, קודם צריך להשתמש בקריאה הבאה ל-API כדי לקבוע את הגדרות הנכס הנוכחיות בארגון:

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 לפורטל חלופי בממשק המשתמש החדש של Edge

אם לא מגדירים את features.devportalUrl בארגון, ממשק המשתמש החדש של Edge משתמש בתבנית ברירת המחדל הגלובלית שמוגדרת על ידי conf_uebe_dev_portal_template (שמוגדרת כברירת מחדל ל-http://live-{org}.devportal.apigee.com, כאשר {org} מוחלף בשם הארגון).

כדי לשנות את תבנית כתובת ה-URL הגלובלית לגיבוי בממשק המשתמש החדש של 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. מפעילים מחדש את ממשק המשתמש החדש של Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart