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

Edge para nube privada v. 4.17.05

Apigee te proporciona un portal de servicios para desarrolladores que puedes usar a fin de compilar y lanzar tu propio sitio web personalizado y, así, proporcionar todos estos servicios a tu comunidad de desarrollo. Los clientes de Edge pueden crear sus propios portales para desarrolladores, ya sea en la nube o de forma local. Consulta ¿Qué es un portal para desarrolladores? a fin de obtener más información.

En la IU de Edge, se muestra el botón DevPortal en la página Publish > Developers 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 establecer esta URL en una URL 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: establécelo en false (predeterminado) para habilitar el botón y en verdadero para inhabilitarlo.
  • features.devportalUrl: Se establece en la URL del portal para desarrolladores.

Debes configurar estas propiedades por separado para cada organización. Para establecer estas propiedades, primero usa la siguiente llamada a la API a fin de 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 forma:

{
  "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 las propiedades en la organización, el valor de las propiedades reemplaza cualquier propiedad actual. Por lo tanto, si deseas configurar features.devportalDisabled o features.devportalUrl en la organización, asegúrate de copiar las propiedades existentes cuando las establezcas.

Usa la siguiente llamada PUT para configurar 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 tienes que especificar displayName, name y properties. Ten en cuenta que esta llamada incluye la propiedad “foo” que se configuró originalmente en la organización.