تنظیم نشانی وب درگاه

‫Apigee دراختیارتان درگاه «خدمات توسعه‌دهنده Apigee» (یا به‌طور ساده، درگاه) قرار می‌دهد که می‌توانید از آن برای ساختن و راه‌اندازی وب‌سایت سفارشی‌سازی‌شده خودتان استفاده کنید تا همه این خدمات را به انجمن توسعه‌دهندگان خود ارائه دهید. مشتریان Edge می‌توانند درگاه توسعه‌دهندگان خودشان را در فضای ابری یا در محل ایجاد کنند. برای اطلاعات بیشتر، به درگاه توسعه‌دهندگان چیست؟ مراجعه کنید.

رابط کاربری New Edge دکمه DevPortal را در صفحه انتشار > پورتال‌ها (یا انتشار > توسعه‌دهندگان) نمایش می‌دهد که با کلیک کردن روی آن، پورتال مرتبط با سازمان باز می‌شود. به‌طور پیش‌فرض، آن دکمه نشانی وب زیر را باز می‌کند:

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

که orgname نام سازمان است.

می‌توانید نشانی وب درگاه توسعه‌دهندگان را در سطح سازمان بااستفاده از ویژگی‌های سازمان پیکربندی کنید، یا الگوی نشانی وب بازگشتی سراسری را در «واسط کاربر New Edge» پیکربندی کنید.

تنظیم نشانی وب درگاه برای سازمان

با تنظیم کردن ویژگی‌های زیر در سازمان، می‌توانید نشانی وب درگاه را روی نشانی وب دیگری برای سازمانی خاص تنظیم کنید یا دکمه را به‌طور کامل غیرفعال کنید:

• features.devportalDisabled: برای فعال کردن دکمه، روی false (پیش‌فرض) و برای غیرفعال کردن آن، روی true تنظیم کنید.
• ‫features.devportalUrl: روی نشانی وب درگاه توسعه‌دهندگان برای سازمان تنظیم شده است.

این دارایی‌ها را به‌صورت جداگانه برای هر سازمان تنظیم می‌کنید. برای تنظیم این ویژگی‌ها، ابتدا از فراخوانی 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 است که در ابتدا برای سازمان تنظیم شده بود.

تنظیم الگوی نشانی وب درگاه بازگشتی سراسری در «واسط کاربر Edge جدید»

اگر features.devportalUrl در سازمانی تنظیم نشده باشد، «رابط کاربری New Edge» از الگوی بازگشت سراسری تعریف‌شده توسط conf_uebe_dev_portal_template استفاده می‌کند (که به‌طور پیش‌فرض http://live-{org}.devportal.apigee.com است، که در آن {org} با نام سازمان جایگزین می‌شود).

برای تغییر دادن الگوی نشانی وب جایگزین سراسری در «میانای کاربری 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. بازراه‌اندازی واسط کاربر Edge جدید:

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