Impostazione dell'URL del portale

Apigee ti fornisce il portale dei servizi per sviluppatori Apigee (o semplicemente il portale) che puoi utilizzare per creare e lanciare il tuo sito web personalizzato per fornire tutti questi servizi alla tua community di sviluppo. I clienti di Edge possono creare il proprio portale per sviluppatori, nel cloud o on-premise. Per maggiori informazioni, consulta Che cos'è un portale per sviluppatori? per

La nuova UI di Edge mostra il pulsante DevPortal nella pagina Pubblica > Portali (o Pubblica > Sviluppatori) che, quando viene selezionato, apre il portale associato a un'organizzazione. Per impostazione predefinita, questo pulsante apre il seguente URL:

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

Dove orgname è il nome dell'organizzazione.

Puoi configurare l'URL del portale per sviluppatori a livello di organizzazione utilizzando le proprietà dell'organizzazione oppure configurare un modello di URL di riserva globale nella nuova UI di Edge.

Impostare l'URL del portale per un'organizzazione

Puoi impostare l'URL del portale su un URL diverso per un'organizzazione specifica o disattivare completamente il pulsante impostando le seguenti proprietà dell'organizzazione:

• features.devportalDisabled: imposta su false (valore predefinito) per attivare il pulsante e su true per disattivarlo.
• features.devportalUrl: imposta sull'URL del portale per sviluppatori dell' organizzazione.

Queste proprietà vengono impostate separatamente per ogni organizzazione. Per impostare queste proprietà, utilizza prima la seguente chiamata API per determinare le impostazioni delle proprietà correnti dell'organizzazione:

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

Questa chiamata restituisce un oggetto che descrive l'organizzazione nel 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"
}

Prendi nota di eventuali proprietà esistenti nell'area properties dell'oggetto. Quando imposti le proprietà dell'organizzazione, il valore in properties sovrascrive le proprietà correnti. Pertanto, se vuoi impostare features.devportalDisabled o features.devportalUrl nell'organizzazione, assicurati di copiare le proprietà esistenti quando le imposti.

Utilizza la seguente chiamata PUT per impostare le proprietà dell'organizzazione:

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

Nella chiamata PUT, devi specificare solo displayName, name, e properties. Tieni presente che questa chiamata include la foo proprietà impostata originariamente nell'organizzazione.

Impostare un modello di URL del portale di riserva globale nella nuova UI di Edge

Se features.devportalUrl non è impostato in un'organizzazione, la nuova UI di Edge utilizza il modello di riserva globale definito da conf_uebe_dev_portal_template (il cui valore predefinito è http://live-{org}.devportal.apigee.com, dove {org} viene sostituito con il nome dell'organizzazione).

Per modificare il modello di URL di riserva globale nella nuova UI di Edge:

1. Apri /opt/apigee/customer/application/management-ui.properties in un editor. Se il file non esiste, crealo:

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

2. Imposta conf_uebe_dev_portal_template utilizzando {org} come segnaposto per il nome dell'organizzazione:

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

3. Salva le modifiche e assicurati che il file sia di proprietà dell'utente apigee:

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

4. Riavvia la nuova UI di Edge:

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