Cómo configurar la URL del portal de servicios para desarrolladores

Edge para nube privada v. 4.16.05

Apigee te proporciona un portal de servicios para desarrolladores que puedes usar para compilar y lanzar tu propio sitio web personalizado y 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 IU de Edge muestra el botón DevPortal en la página Publicar > Desarrolladores que, cuando se hace clic, 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 esta URL como una diferente, por ejemplo, si tu portal tiene un registro DNS, o inhabilitar el botón por completo. Usa las siguientes propiedades de la organización para controlar el botón:

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

Estas propiedades se configuran 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 devuelve 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" : "organme",
  "properties" : {
    "property" : [{
      "name" : "foo",
      "value" : "bar"}]
  },
  "type" : "paid"
}

Toma nota de las propiedades existentes en el área properties del objeto. Cuando configuras propiedades en la organización, el valor de las propiedades 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 configures.

Usa la siguiente llamada PUT para establecer las 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 PUT, solo debes especificar displayName, name y properties. Ten en cuenta que esta llamada incluye la propiedad "foo" que se estableció originalmente en la organización.