Como configurar o URL do portal

A Apigee oferece o portal de serviços para desenvolvedores da Apigee (ou simplesmente o portal), que pode ser usado para criar e lançar seu próprio site personalizado para oferecer 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 que é um portal do desenvolvedor? para mais informações.

A nova interface do Edge mostra o DevPortal botão na página Publicar > Portais{//1} (ou 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.

É possível configurar o URL do portal do desenvolvedor no nível da organização usando as propriedades dela ou configurar um modelo de URL alternativo global na nova interface do Edge.

Definir o URL do portal para uma organização

É possível definir o URL do portal para um URL diferente de uma organização específica ou desativar o botão completamente definindo as seguintes propriedades na organizaçã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 da organização.

Essas propriedades são definidas 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" : "orgname",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"
    } ]
  },
  "type" : "paid"
}

Anote as propriedades atuais na área properties do objeto. Quando você define propriedades na organização, o valor em properties substitui as propriedades atuais. Portanto, se você quiser definir features.devportalDisabled ou features.devportalUrl na organização, copie as propriedades atuais ao defini-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. Essa chamada inclui a foo propriedade que foi definida originalmente na organização.

Definir um modelo de URL de portal de fallback global na nova interface do Edge

Se features.devportalUrl não estiver definido em uma organização, a nova interface do Edge vai usar o modelo de fallback global definido por conf_uebe_dev_portal_template, que é http://live-{org}.devportal.apigee.com por padrão. Nele, {org} é substituído pelo nome da organização.

Para mudar o modelo de URL de fallback global na nova interface do Edge:

1. Abra /opt/apigee/customer/application/management-ui.properties em um editor. Se o arquivo não existir, crie-o:

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

2. Defina conf_uebe_dev_portal_template usando {org} como o marcador de posição para o nome da organização:

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

3. Salve as alterações e verifique se o arquivo pertence ao usuário apigee:

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

4. Reinicie a nova interface do Edge:

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