포털 URL 설정

Apigee는 개발 커뮤니티에 이러한 모든 서비스를 제공하기 위해 맞춤설정된 웹사이트를 빌드하고 실행하는 데 사용할 수 있는 Apigee 개발자 서비스 포털 (또는 간단히 포털)을 제공합니다. Edge 고객은 클라우드 또는 온프레미스에서 자체 개발자 포털을 만들 수 있습니다. 자세한 내용은 개발자 포털이란 무엇인가요?를 참고하세요.

새 Edge UI는 DevPortal 버튼을 게시 > 포털 (또는 게시 > 개발자) 페이지에 표시합니다. 이 버튼을 클릭하면 조직과 연결된 포털이 열립니다. 기본적으로 이 버튼은 다음 URL을 엽니다.

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

여기서 orgname은 조직의 이름입니다.

조직 속성을 사용하여 조직 수준에서 개발자 포털 URL을 구성하거나 새 Edge UI에서 전역 대체 URL 템플릿을 구성할 수 있습니다.

조직의 포털 URL 설정

조직에서 다음 속성을 설정하여 특정 조직의 포털 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 속성이 포함되어 있습니다.

새 Edge UI에서 전역 대체 포털 URL 템플릿 설정

조직에 features.devportalUrl이 설정되어 있지 않으면 새 Edge UI는 conf_uebe_dev_portal_template에 의해 정의된 전역 대체 템플릿을 사용합니다 (기본값은 http://live-{org}.devportal.apigee.com이며, 여기서 {org}는 조직 이름으로 대체됨).

새 Edge UI에서 전역 대체 URL 템플릿을 변경하려면 다음 단계를 따르세요.

  1. 편집기에서 /opt/apigee/customer/application/management-ui.properties를 엽니다. 파일이 없으면 만듭니다. 
    vi /opt/apigee/customer/application/management-ui.properties
  2. 조직 이름의 자리표시자로 {org}를 사용하여 conf_uebe_dev_portal_template을 설정합니다. 
    conf_uebe_dev_portal_template="https://portal.mycompany.com/{org}"
  3. 변경사항을 저장하고 파일의 소유자가 apigee 사용자인지 확인합니다. 
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  4. 새 Edge UI를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart