Configura la URL del portal

Apigee te proporciona el portal de Apigee Developer Services (o simplemente, el portal) que puedes usar para crear y lanzar tu propio sitio web personalizado para proporcionar todos estos servicios a tu comunidad de desarrollo. Los clientes de Edge pueden crear su propio portal para desarrolladores, ya sea en la nube o de forma local. Consulta ¿Qué es un portal para desarrolladores? para obtener más información.

La nueva IU de Edge muestra el botón DevPortal en la página Publicar > Portales (o Publicar > Desarrolladores) que, cuando se hace clic en él, abre el portal asociado con una organización. De forma predeterminada, ese botón abre la siguiente URL:

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

En el que orgname es el nombre de la organización.

Puedes configurar la URL del portal para desarrolladores a nivel de la organización con las propiedades de la organización o configurar una plantilla de URL de respaldo global en la nueva IU de Edge.

Establece la URL del portal para una organización

Puedes establecer la URL del portal en una URL diferente para una organización específica o inhabilitar el botón por completo. Para ello, establece las siguientes propiedades en la organización:

• features.devportalDisabled: Establece el valor en false (predeterminado) para habilitar el botón y en true para inhabilitarlo.
• features.devportalUrl: Establece la URL del portal para desarrolladores de la organización.

Estas propiedades se establecen por separado para cada organización. Para establecer estas propiedades, primero usa la siguiente llamada a la API para determinar la configuración actual de las propiedades en la organización:

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

Esta llamada muestra un objeto que describe la organización de la siguiente manera:

{
  "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"
}

Ten en cuenta las propiedades existentes en el área properties del objeto. Cuando estableces propiedades en la organización, el valor en properties reemplaza cualquier propiedad actual. Por lo tanto, si deseas establecer features.devportalDisabled o features.devportalUrl en la organización, asegúrate de copiar las propiedades existentes cuando las establezcas.

Usa la siguiente llamada a PUT para establecer propiedades en la organización:

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"
        }
      ]
    }
  }'

En la llamada a PUT, solo debes especificar displayName, name y properties. Ten en cuenta que esta llamada incluye la foo propiedad que se estableció originalmente en la organización.

Establece una plantilla de URL alternativa global del portal en la nueva IU de Edge

Si features.devportalUrl no está establecida en una organización, la nueva IU de Edge usa la plantilla alternativa global definida por conf_uebe_dev_portal_template (que, de forma predeterminada, es http://live-{org}.devportal.apigee.com, en la que {org} se reemplaza por el nombre de la organización).

Para cambiar la plantilla de URL de respaldo global en la nueva IU de Edge, haz lo siguiente:

1. Abre /opt/apigee/customer/application/management-ui.properties en un editor. Si el archivo no existe, créalo:

   vi /opt/apigee/customer/application/management-ui.properties

2. Establece conf_uebe_dev_portal_template con {org} como marcador de posición para el nombre de la organización:

   conf_uebe_dev_portal_template="https://portal.mycompany.com/{org}"

3. Guarda los cambios y asegúrate de que el archivo sea propiedad del usuario apigee:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties

4. Reinicia la nueva IU de Edge:

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