Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. info
Am Dienstag, dem 19. Mai 2015, haben wir eine vierteljährliche Version von Apigee Edge for Private Cloud veröffentlicht.
Der frühere Produktname „Apigee Edge On-Premise“ oder „OPDK“ lautet jetzt „Apigee Edge for Private Cloud“.
Wenn Sie Fragen haben, wenden Sie sich an den Apigee Edge-Support.
Eine Liste aller Versionshinweise zu Apigee Edge finden Sie unter Versionshinweise zu Apigee.
Neue Features und Verbesserungen
Im Folgenden finden Sie die neuen Funktionen und Verbesserungen in dieser Version.
OpenLDAP – Installation und Upgrade
OpenLDAP ist jetzt der einzige LDAP-Server, der von Edge für Neuinstallationen und Upgrades unterstützt wird.
API-Dienste
Im Folgenden finden Sie neue Funktionen und Verbesserungen in Edge API Services.
WebSockets
Um die Echtzeit-Webkommunikation zwischen einem Webclient und einem Server zu ermöglichen, unterstützt Edge das WebSocket-Protokoll. Edge kann in der WebSocket-Kommunikation entweder als Client oder als Server fungieren. Informationen zum Einrichten und Verwenden von WebSockets in Edge finden Sie im Leitfaden Apigee Edge for Private Cloud Using WebSockets.
Unterstützung externer Authentifizierungsanbieter für die API-Verwaltung
Edge lässt sich in Active Directory und andere externe Authentifizierungsanbieter/LDAP-Systeme einbinden, die Ihre administrativen API-Nutzer enthalten. Weitere Informationen finden Sie im Leitfaden Externe Authentifizierung für Edge for Private Cloud konfigurieren.
Co-Branding in der Verwaltungsoberfläche
Sie können die Edge-Verwaltungs-UI mit Ihrem eigenen benutzerdefinierten Logo versehen, das neben dem Apigee-Logo angezeigt wird. Weitere Informationen finden Sie im Apigee Edge for Private Cloud Operations Guide unter „Adding a custom logo to the Apigee UI menu“.
Node.js-Logs in Trace
Beim Debuggen von Node.js-API-Proxys können Sie die Node.js-Logfunktion in der Trace-Ansicht des API-Proxy-Editors aktivieren. Um die Funktion zu aktivieren, legen Sie apigee.feature.disableNodeJSLogs="false" in der Datei „apigee-base.conf“ oder „apigee-onpremise.conf“ in Ihrer Installation fest. Weitere Informationen zu Node.js-Logs finden Sie unter Node.js-Proxys debuggen und Fehler beheben.
Ablauf des Passworts
In Edge 4.15.01.x liefen Edge-Passwörter nach 30 Tagen automatisch ab. Das bedeutete, dass ein Nutzer ausgesperrt wurde, wenn er sein Passwort nicht vor dem Ablaufdatum geändert hat. Dadurch ist jedoch auch das Passwort des Systemadministrators abgelaufen, sodass er keinen Zugriff mehr auf Edge hatte.
Wenn Sie ein Upgrade auf Version 4.15.04.00 durchführen, ändert sich die Standardeinstellung so, dass Passwörter nicht ablaufen. Bei Bedarf können Sie mit dem Skript /opt/apigee4/bin/apigee-enable-pwlockout.sh festlegen, dass Edge-Passwörter ablaufen. Weitere Informationen finden Sie im Apigee Edge for Private Cloud Operations Guide.
Sysadmin-Zugriff auf bestimmte E-Mail-Domains beschränken
Sie können die Mitgliedschaft in den Rollen „Systemadministrator“ oder „Schreibgeschützter Systemadministrator“ auf Nutzer in bestimmten E-Mail-Domains beschränken. Um diese Funktion zu aktivieren, fügen Sie die zulässigen Domains der Datei apigee4/conf/apigee/management-server/security.properties hinzu, wie im Apigee Edge for Private Cloud Operations Guide beschrieben.
Fehlermeldungen in der Management-UI
Die Anzeige von Fehlermeldungen auf der Verwaltungsoberfläche wurde neu gestaltet, um den Bildschirmplatz effizienter zu nutzen.
Neue OAuthV2-Fehlervariablen
Diese neuen fehlerbezogenen Variablen werden von der OAuthV2-Richtlinie festgelegt:
- oauthV2.<policy-name>.failed: Auf „true“ gesetzt, wenn die Richtlinie fehlgeschlagen ist.
- oauthv2.<policy_name>.<fault_name>: Der Name des Fehlers. Beispiel: invalid_request
- oauthv2.<policy_name>.<fault_cause>: Der Grund für den Fehler. Beispiel: Token abgelaufen
Weitere Informationen finden Sie unter http://apigee.com/docs/api-services/content/oauthv2-policy.
Produkterstellung
Wenn Sie ein neues Produkt erstellen, können Sie jetzt zusätzlich zum Anzeigenamen auch den Produktnamen angeben.
Weitere Informationen finden Sie unter http://apigee.com/docs/developer-services/content/creating-api-products.
Benutzeroberfläche zum Entfernen von Nutzern aus einer Organisation
Auf der Seite „Organisationsnutzer“ in der Benutzeroberfläche wurde die Schaltfläche „Löschen“ durch die Schaltfläche „Entfernen“ ersetzt. So soll verdeutlicht werden, dass das Apigee-Konto eines Nutzers aktiv bleibt, wenn Sie ihn aus einer Organisation entfernen.
Weitere Informationen finden Sie unter http://apigee.com/docs/api-services/content/managing-organization-users.
Filteroptionen in der Verwaltungsoberfläche
Auf den Seiten „API-Proxys“, „Produkte“, „Entwickler“ und „Apps“ in der Verwaltungsoberfläche sind neue Filteroptionen für die Suche verfügbar.
Offline-Trace-Tool
Mit dem Offline-Trace-Tool können Sie Trace-Sitzungen aufrufen und analysieren, die zuvor gespeichert wurden. Eine gespeicherte Trace-Sitzung ist im Wesentlichen eine „Aufzeichnung“ einer Trace-Sitzung und kann in Fällen nützlich sein, in denen eine Fehlerbehebung und weitere Analyse erforderlich sind. Die Benutzeroberfläche für das Offline-Trace-Tool ähnelt der des „Live“-Trace-Tools.
Weitere Informationen finden Sie unter Offline Trace-Tool verwenden.
In den Nutzereinstellungen angezeigte Nutzerrollen
Auf der Seite „Nutzereinstellungen“ der Verwaltungsoberfläche (Nutzername > „Nutzereinstellungen“) werden jetzt die Rollen des Nutzers angezeigt.
Verbesserungen an der Benutzeroberfläche für die Edge-Verwaltung
Diese Version enthält eine Reihe kleiner Verbesserungen der Nutzerfreundlichkeit und Konsistenz in der Edge-Verwaltungsoberfläche.
Analytics-Dienste
Im Folgenden finden Sie neue Funktionen und Verbesserungen in Edge Analytics Services.
Daten für sechs Monate verfügbar
Wenn Sie Analysenberichte über die Verwaltungs-UI oder die API erstellen, ist der Zugriff auf Daten, die älter als sechs Monate ab dem aktuellen Datum sind, nicht standardmäßig möglich. Wenn Sie auf Daten zugreifen möchten, die älter als sechs Monate sind, wenden Sie sich an den Apigee Edge-Support.
Variablen, die der Analyse hinzugefügt wurden
Die folgenden neuen Variablen werden an Edge Analytics übergeben und sind in der AX-Phase des API-Proxy-Trace-Fensters sichtbar.
- apigee.edge.execution.is_target_error: Hiermit können Sie ermitteln, ob API-Fehler zielseitige Fehler (Wert „1“) oder Nicht-Ziel-Fehler für nicht erfolgreiche HTTP-Antworten (Wert „0“) sind. Der Wert ist für eine erfolgreiche HTTP-Antwort „null“.
-
apigee.edge.execution.is_policy_error: Hiermit können Sie ermitteln, ob eine Richtlinie fehlgeschlagen ist (Wert „1“) oder ob bei einer nicht erfolgreichen HTTP-Antwort keine Richtlinie fehlgeschlagen ist (Wert „0“). Der Wert ist für eine erfolgreiche HTTP-Antwort „null“.
Die folgenden zugehörigen Variablen enthalten Details zur Richtlinie, die zuerst fehlgeschlagen ist. Die Werte sind null, wenn keine Richtlinie fehlgeschlagen ist.- apigee.edge.execution.fault_policy_name: Der Name der Richtlinie, die fehlgeschlagen ist.
- apigee.edge.execution.fault_flow_name: Der Name des Ablaufs in der Richtlinie, bei der ein Fehler aufgetreten ist (z. B. PreFlow, PostFlow oder ein benutzerdefinierter Ablauf).
- apigee.edge.execution.fault_flow_state: Der Ort, an dem die Richtlinie im Ablauf angehängt wurde. Mögliche Werte: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Dashboards
- Die Leistungsdiagramme für APIs, Entwickler, Produkte und Entwickler-Apps wurden verschoben. Sie wurden früher unten auf den Hauptseiten für diese Rechtssubjekte angezeigt. Sie können jetzt auf die Diagramme zugreifen, indem Sie oben auf jeder Seite den Tab Analytics auswählen.
- Diese Version enthält wichtige Änderungen an den folgenden vorhandenen oder neuen Dashboards:
- Apigee-Dashboard (überarbeitet): Enthält drei Messwertdiagramme: Proxy-Traffic, Entwicklerinteraktion und Entwickler-Apps. Für jedes Diagramm gibt es eine Ansicht mit weiteren Details, in der Sie die einzelnen Messwerte aufschlüsseln können. Weitere Informationen finden Sie unter Apigee-Dashboard.
- Proxy-Leistung (Neu): Hier sehen Sie API-Proxy-Trafficmuster und ‑Verarbeitungszeiten. Ersetzt das Dashboard „API-Proxy-Leistung“. Weitere Informationen finden Sie unter API-Proxy-Leistung.
- Traffic-Zusammensetzung (überarbeitet): Das Dashboard wurde komplett überarbeitet und enthält neue Inhalte. Misst den relativen Beitrag Ihrer wichtigsten APIs, Apps, Entwickler und Produkte zu Ihrem gesamten API-Programm. Weitere Informationen
- Fehleranalyse (überarbeitet): Das Erscheinungsbild und die Inhalte wurden vollständig überarbeitet. Zeigt Fehlerraten für API-Proxys und Ziele an. Weitere Informationen finden Sie im Fehlercodeanalyse-Dashboard.
-
Die folgenden vorhandenen Dashboards wurden umbenannt:
- Endpunktleistung wurde in Leistung der Zielsysteme umbenannt: Hier werden Trafficmuster und Leistungsmesswerte für API-Proxy-Backend-Ziele angezeigt. Weitere Informationen finden Sie unter Leistung der Zielsysteme.
- Partner-Engagement wurde in Entwickler-Engagement umbenannt: Hier sehen Sie, welche Ihrer registrierten App-Entwickler den meisten API-Traffic generieren. Für jeden Ihrer Entwickler können Sie herausfinden, wer den meisten API-Traffic und die meisten Fehler generiert. Weitere Informationen finden Sie unter Entwicklerengagement.
Entwicklerdienste
Im Folgenden finden Sie neue Funktionen und Verbesserungen in Edge Developer Services.
Swagger 2.0-Unterstützung für SmartDocs
SmartDocs unterstützt den Import von Swagger 2.0-Spezifikationsdokumenten und ist abwärtskompatibel mit Swagger 1.2. Die Unterstützung für Sicherheitsschema-Objekte und zentralisierte Schemas wird in einer späteren Version verfügbar sein.
Monetarisierung
Im Folgenden finden Sie neue Funktionen und Verbesserungen bei der Edge-Monetarisierung. Weitere Informationen zur Monetarisierung finden Sie auch im Abschnitt „Bekannte Probleme“.
Separate Behandlung von Unternehmen und Entwicklern
Unternehmen und Entwickler werden jetzt separat behandelt. So können Entwicklern mehrere Unternehmen und Unternehmen mehrere Entwickler zugewiesen werden. In der Verwaltungsoberfläche gibt es jetzt separate Fenster für „Unternehmen“ und „Entwickler“ (über das Menü „Veröffentlichen“).
In Berichten zur Monetarisierung bleiben Unternehmen ein primärer Filter. Das Filterlabel wurde jedoch von „Entwickler“ zu „Unternehmen“ geändert.
Fehlerkorrekturen
Folgende Fehler wurden in diesem Release behoben.
| Problem-ID | Beschreibung |
|---|---|
| OPDK-954 | 4.15.01 Cassandra-Schema wird nicht aktualisiert |
| MGMT-1986 | UI-Fehler beim Hinzufügen eines Entwicklers |
| MGMT-1983 | Die API „OAuth 2.0-Autorisierungscode abrufen“ gibt den falschen Status zurück |
| MGMT-1962 | Fehler beim Anmelden in der Verwaltungsoberfläche mit einem starken Passwort Die Anmeldung in der Benutzeroberfläche mit bestimmten Sonderzeichen, z. B. dem Prozentzeichen, schlägt nicht mehr fehl. |
| MGMT-1894 | Die Seite „Entwickler-Apps“ wird für die Spalte „Entwickler“ nie vollständig geladen. |
| MGMT-1872 | Benutzerdefinierte Berichte können nicht heruntergeladen werden |
| MGMT-1777 | Nutzer mit einer E‑Mail-Adresse mit der TLD „.acn“ kann nicht hinzugefügt werden |
| MGMT-1362 | Die E‑Mail „Passwort vergessen“ funktioniert nicht, wenn die E‑Mail-Adresse „_“ enthält. Behebt das Problem beim Zurücksetzen des Passworts in der Private Cloud mit E‑Mail-Adressen, die einen Unterstrich enthalten. |
| CORERT-613 | Fehler beim SSL-Handshake aufgrund von „unrecognized_name“ |
| APIRT-1346 | OAuth2.0 – Gehashter Wert wird in der Antwort des Zugriffstokens zurückgegeben, wenn „hash.oauth.tokens.enabled“ auf „true“ gesetzt ist |
Diese Version enthält auch Fehlerbehebungen aus den folgenden Versionen:
| Edge Cloud | Edge for Private Cloud |
|---|---|
Bekannte Probleme
Diese Version weist die folgenden bekannten Probleme auf.
| Problem-ID | Beschreibung |
|---|---|
| – |
Zwei Cassandra-Scripts, die das Installationsprogramm bei der Installation oder Aktualisierung von Monetization verwendet, waren nicht im Release enthalten. Führen Sie nach der Cassandra-Installation oder dem Cassandra-Upgrade die folgenden Befehle aus, um die Monetarisierungsinstallation bzw. das Monetarisierungs-Upgrade abzuschließen:
|
| CORERT-318 | API-Aufrufe mit großen Nutzlasten (Hunderte von KB) können manchmal hängen bleiben. Um dieses Problem zu umgehen, legen Sie den folgenden Attributwert in der Datei „router.properties“ fest:HTTPServer.streaming.buffer.limit=0 (die Standardeinstellung ist 10) |