URL des Portals festlegen

Apigee bietet Ihnen das Apigee Developer Services-Portal (oder einfach das Portal), mit dem Sie Ihre eigene angepasste Website erstellen und starten können, um Ihrer Entwickler-Community alle diese Dienste zur Verfügung zu stellen. Edge Kunden können ihr eigenes Entwicklerportal erstellen, entweder in der Cloud oder lokal. Weitere Informationen finden Sie unter Was ist ein Entwicklerportal? für weitere Informationen.

In der neuen Edge-Benutzeroberfläche wird die Schaltfläche DevPortal auf der Seite Veröffentlichen > Portale (oder Veröffentlichen > Entwickler) angezeigt. Wenn Sie darauf klicken, wird das mit einer Organisation verknüpfte Portal geöffnet. Standardmäßig wird mit dieser Schaltfläche die folgende URL geöffnet:

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

Dabei ist orgname der Name der Organisation.

Sie können die URL des Entwicklerportals auf Organisationsebene mithilfe von Organisationseigenschaften konfigurieren oder eine globale Fallback-URL-Vorlage in der neuen Edge-Benutzeroberfläche konfigurieren.

Portal-URL für eine Organisation festlegen

Sie können die Portal-URL für eine bestimmte Organisation auf eine andere URL festlegen oder die Schaltfläche vollständig deaktivieren, indem Sie die folgenden Eigenschaften für die Organisation festlegen:

• features.devportalDisabled: Legen Sie false (Standard) fest, um die Schaltfläche zu aktivieren, und true um sie zu deaktivieren.
• features.devportalUrl: Legen Sie die URL des Entwicklerportals für die Organisation fest.

Sie legen diese Eigenschaften für jede Organisation separat fest. Um diese Eigenschaften festzulegen, rufen Sie zuerst die aktuellen Einstellungen der Eigenschaften für die Organisation mit dem folgenden API-Aufruf ab:

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

Dieser Aufruf gibt ein Objekt zurück, das die Organisation in folgendem Format beschreibt:

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

Notieren Sie sich alle vorhandenen Eigenschaften im Bereich properties des Objekts. Wenn Sie Eigenschaften für die Organisation festlegen, werden alle aktuellen Eigenschaften durch den Wert in properties überschrieben. Wenn Sie also features.devportalDisabled oder features.devportalUrl in der Organisation festlegen möchten, kopieren Sie alle vorhandenen Eigenschaften wenn Sie sie festlegen.

Verwenden Sie den folgenden PUT-Aufruf, um Eigenschaften für die Organisation festzulegen:

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

Im PUT-Aufruf müssen Sie nur displayName, name, und properties angeben. Dieser Aufruf enthält die foo Eigenschaft, die ursprünglich für die Organisation festgelegt wurde.

Globale Fallback-Portal-URL-Vorlage in der neuen Edge-Benutzeroberfläche festlegen

Wenn features.devportalUrl für eine Organisation nicht festgelegt ist, verwendet die neue Edge-Benutzeroberfläche die globale Fallback-Vorlage, die durch conf_uebe_dev_portal_template definiert wird (standardmäßig http://live-{org}.devportal.apigee.com, wobei {org} durch den Namen der Organisation ersetzt wird).

So ändern Sie die globale Fallback-URL-Vorlage in der neuen Edge-Benutzeroberfläche:

1. Öffnen Sie /opt/apigee/customer/application/management-ui.properties in einem Editor. Wenn die Datei nicht vorhanden ist, erstellen Sie sie:

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

2. Legen Sie conf_uebe_dev_portal_template fest und verwenden Sie {org} als Platzhalter für den Namen der Organisation:

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

3. Speichern Sie die Änderungen und prüfen Sie, ob die Datei dem Nutzer apigee gehört:

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

4. Starten Sie die neue Edge-Benutzeroberfläche neu:

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