Como configurar o URL do portal dos Serviços do desenvolvedor

Edge para nuvem privada v. 4.16.09

A Apigee oferece um portal de serviços para desenvolvedores que pode ser usado para criar e lançar seu próprio site personalizado e fornecer todos esses serviços à sua comunidade de desenvolvimento. Os clientes do Edge podem criar o próprio portal do desenvolvedor na nuvem ou no local. Consulte o artigo O que é um portal para desenvolvedores? para mais informações.

A interface do Edge exibe o botão DevPortal na página Publicar > Desenvolvedores que, quando clicado, abre o portal associado a uma organização. Por padrão, esse botão abre o seguinte URL:

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

em que {orgname} é o nome da organização.

Você pode definir esse URL como um URL diferente, por exemplo, se o portal tiver um registro DNS, ou desativar o botão completamente. Use as seguintes propriedades da organização para controlar o botão:

• features.devportalDisabled: defina como "false" (padrão) para ativar o botão e como "true" para desativá-lo.
• features.devportalUrl: defina como o URL do portal do desenvolvedor.

Defina essas propriedades separadamente para cada organização. Para definir essas propriedades, primeiro use a seguinte chamada de API para determinar as configurações de propriedade atuais na organização:

curl -H "Content-Type:application/json" \
-u adminEmail:pword -X GET \
http://<ms-IP>:8080/v1/organizations/{orgname}

Essa chamada retorna um objeto que descreve a organização no formato:

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

Observe as propriedades existentes na área properties do objeto. Quando você define propriedades na organização, o valor nas propriedades substitui as propriedades atuais. Portanto, se você quiser definir features.devportalDisabled ou features.devportalUrl na organização, copie todas as propriedades existentes ao configurá-las.

Use a seguinte chamada PUT para definir propriedades na organização:

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

Na chamada PUT, você só precisa especificar displayName, name e properties. Observe que essa chamada inclui a propriedade "foo" que foi originalmente definida na organização.