Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
Am Dienstag, 19. Mai 2015, haben wir eine vierteljährliche Version von Apigee Edge for Private Cloud veröffentlicht.
Der bisherige Produktname „Apigee Edge On-premises“ oder „OPDK“ lautet jetzt „Apigee Edge for Private Cloud“.
Wenn Sie Fragen haben, wenden Sie sich an den Apigee Edge-Support.
Eine Liste aller Apigee Edge-Versionshinweise finden Sie unter Apigee-Versionshinweise.
Neue Features und Verbesserungen
Im Folgenden sind die neuen Features und Verbesserungen in diesem Release aufgeführt.
OpenLDAP – Installation und Upgrade
OpenLDAP ist jetzt der einzige LDAP-Server, der von Edge für neue Installationen und Upgrades unterstützt wird.
API-Dienste
Im Folgenden sind die neuen Features und Verbesserungen in den Edge API-Diensten aufgeführt.
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 – WebSockets verwenden.
Unterstützung für externe Authentifizierungsanbieter für die API-Verwaltung
Edge lässt sich in Active Directory und andere externe Authentifizierungsanbieter/LDAP-Systeme integrieren, die Ihre API-Administratoren enthalten. Weitere Informationen finden Sie im Leitfaden Edge for Private Cloud Externe Authentifizierung konfigurieren.
Co-Branding in der Verwaltungs-UI
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 „Benutzerdefiniertes Logo zum Apigee-UI-Menü hinzufügen“ .
Node.js-Logs in Trace
Beim Debuggen von Node.js-API-Proxys können Sie das Node.js-Log-Feature in der Trace-Ansicht des API-Proxy
Editors aktivieren. Setzen Sie dazu in der Datei „apigee-base.conf“ oder
„apigee-onpremise.conf“ Ihrer Installation
apigee.feature.disableNodeJSLogs="false". Weitere Informationen zum Node.js-Log 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 gesperrt wurde, wenn er sein Passwort nicht vor Ablauf geändert hatte. Dadurch lief jedoch auch das Passwort des Systemadministrators ab, sodass der Systemadministrator aus Edge gesperrt wurde.
Wenn Sie ein Upgrade auf 4.15.04.00 durchführen, ändert sich die Standardeinstellung so, dass Passwörter nicht ablaufen. Bei
Bedarf können Sie Edge-Passwörter mit dem
/opt/apigee4/bin/apigee-enable-pwlockout.sh Skript ablaufen lassen. Weitere Informationen finden Sie im
Apigee Edge for Private Cloud Operations Guide.
Systemadministratorzugriff auf bestimmte E‑Mail-Domains beschränken
Sie können die Mitgliedschaft in den Rollen „Systemadministrator“ oder „Systemadministrator (schreibgeschützt)“ auf Nutzer in bestimmten E‑Mail-Domains beschränken. Fügen Sie dazu die zulogee4/conf/apigee/management-server/security.properties“ hinzu, wie im Apigee Edge for Private Cloud Operations Guide beschrieben.
Fehlermeldungen in der Verwaltungs-UI
Die Anzeige von Fehlermeldungen in der Verwaltungs-UI 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 Expired
Weitere Informationen finden Sie unter http://apigee.com/docs/api-services/content/oauthv2-policy.
Produkt erstellen
Beim Erstellen eines neuen Produkts können Sie jetzt neben dem Anzeigenamen auch den Produktnamen angeben.
Weitere Informationen finden Sie unter http://apigee.com/docs/developer-services/content/creating-api-products.
UI zum Entfernen von Nutzern aus einer Organisation
Auf der Seite „Organisationsnutzer“ in der UI wurde die Schaltfläche „Löschen“ durch die Schaltfläche „Entfernen“ ersetzt. So wird verdeutlicht, dass das Apigee-Konto des 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 Verwaltungs-UI
Auf den Seiten „API-Proxys“, „Produkte“, „Entwickler“ und „Apps“ in der Verwaltungs-UI sind neue Filter optionen für die Suche verfügbar.
Offline-Trace-Tool
Mit dem Offline-Trace-Tool können Sie zuvor gespeicherte Trace-Sitzungen ansehen und analysieren. 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 ist. Die Benutzeroberfläche für das Offline-Trace-Tool ist ähnlich dem "Live"-Trace-Tool.
Weitere Informationen finden Sie unter Using the Offline Trace tool.
Nutzerrollen in den Nutzereinstellungen angezeigt
Auf der Seite „Nutzereinstellungen“ der Verwaltungs-UI (Nutzername > Nutzereinstellungen) werden jetzt die Rollen des Nutzers angezeigt.
Verbesserungen an der Edge-Verwaltungs-UI
Diese Version enthält eine Reihe kleiner Verbesserungen an der Benutzerfreundlichkeit und Konsistenz der Edge Verwaltungs-UI.
Analytics-Dienste
Im Folgenden sind die neuen Features und Verbesserungen in den Edge Analytics-Diensten aufgeführt.
Daten der letzten sechs Monate verfügbar
Wenn Sie mit der Verwaltungs-UI oder der API Analytics-Berichte 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 zu Analytics hinzugefügt
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 feststellen, ob API Fehler zielseitige Fehler (Wert "1") oder nicht zielseitige Fehler für nicht erfolgreiche HTTP-Antworten (Wert "0") sind. Bei einer erfolgreichen HTTP-Antwort ist der Wert „null“.
-
apigee.edge.execution.is_policy_error : Hiermit können Sie feststellen, ob eine Richtlinie
fehlgeschlagen ist (Wert „1“) oder keine Richtlinie in einer nicht erfolgreichen HTTP-Antwort fehlgeschlagen ist (Wert „0“). Bei einer erfolgreichen HTTP-Antwort ist der
Wert „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, die fehlgeschlagen ist (z. B. „PreFlow“, „PostFlow“ oder ein benutzerdefinierter Ablauf).
- apigee.edge.execution.fault_flow_state : Die Position, an der 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 bisher unten auf den Hauptseiten für diese Entitäten angezeigt. Jetzt können Sie auf die Diagramme zugreifen, indem Sie oben auf jeder Seite den Tab Analytics auswählen.
- Diese Version enthält wichtige Änderungen an diesen vorhandenen oder neuen Dashboards:
- Apigee-Dashboard (überarbeitet): Enthält drei Diagramme mit Messwerten: Proxy Traffic, Entwicklerbeteiligung und Entwickler-Apps. Jedes Diagramm bietet eine Ansicht mit weiteren Details , mit der Sie die einzelnen Messwerte genauer untersuchen können. Weitere Informationen finden Sie unter Apigee-Dashboard.
- Proxy-Leistung (neu): Zeigt API-Proxy-Trafficmuster und -Verarbeitungszeiten. Ersetzt das Dashboard für die 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 Top-APIs, Apps, Entwickler und Produkte zu Ihrem Gesamt-API-Programm. Weitere Informationen finden Sie unter Traffic-Zusammensetzung.
- Fehleranalyse (überarbeitet): Das Dashboard wurde komplett überarbeitet und enthält neue Inhalte. Zeigt Fehlerraten für API-Proxys und -Ziele. Weitere Informationen finden Sie unter Fehlercodeanalyse Dashboard.
-
Diese vorhandenen Dashboards wurden umbenannt:
- Endpunktleistung wurde in Leistung der Zielsysteme umbenannt: Zeigt Trafficmuster und Leistungsmesswerte für API-Proxy-Backend-Ziele. Weitere Informationen finden Sie unter Leistung der Zielsysteme.
- Partnerbeteiligung wurde in Entwickler beteiligung umbenannt: Zeigt, 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 Entwicklerbeteiligung.
Entwicklerdienste
Im Folgenden sind die neuen Features und Verbesserungen in den Edge-Entwicklerdiensten aufgeführt.
Swagger 2.0-Unterstützung für SmartDocs
SmartDocs unterstützt den Import von Swagger 2.0-Spezifikationsdokumenten und ist abwärts kompatibel mit Swagger 1.2. Die Unterstützung für Sicherheitsschemaobjekte und zentralisierte Schemas wird in einer späteren Version verfügbar sein.
Monetarisierung
Im Folgenden sind die neuen Features und Verbesserungen in der Edge-Monetarisierung aufgeführt. Weitere Informationen zur Monetarisierung finden Sie auch im Abschnitt „Bekannte Probleme“ .
Separate Verarbeitung von Unternehmen und Entwicklern
Unternehmen und Entwickler werden jetzt separat verarbeitet, was mehr Flexibilität beim Hinzufügen mehrerer Unternehmen zu Entwicklern und mehrerer Entwickler zu Unternehmen ermöglicht. Die Verwaltungs-UI bietet jetzt separate Fenster für „Unternehmen“ und „Entwickler“ (über das Menü „Veröffentlichen“ zugänglich).
Weitere Informationen finden Sie unter Unternehmen und Entwickler verwalten.
In Monetarisierungsberichten bleiben Unternehmen ein primärer Filter, obwohl die Filterbezeichnung von „Entwickler“ in „Unternehmen“ geändert wurde.
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 zum Abrufen eines OAuth 2.0-Autorisierungscodes gibt den falschen Status zurück |
| MGMT-1962 | Fehler beim Anmelden in der Verwaltungs-UI mit einem sicheren Passwort Die Anmeldung in der UI mit bestimmten Sonderzeichen wie 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 ein Problem beim Zurücksetzen des Passworts in der Private Cloud mit E‑Mail-Adressen, die einen Unterstrich enthalten. |
| CORERT-613 | SSL-Handshake-Fehler aufgrund von „unrecognized_name“ |
| APIRT-1346 | OAuth2.0 – Der Hashwert wird in der Zugriffstokenantwort zurückgegeben, wenn „hash.oauth.tokens.enabled“ auf „true“ gesetzt ist |
Diese Version enthält auch Fehlerkorrekturen 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-Skripts, die das Installationsprogramm bei der Installation oder dem Upgrade der Monetarisierung verwendet, waren nicht im Release enthalten. Um dieses Problem zu umgehen, führen Sie nach der Cassandra-Installation oder dem Upgrade die folgenden Befehle aus, um die Monetarisierungsinstallation oder das 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 Eigenschaftswert in der Datei „router.properties“ fest:HTTPServer.streaming.buffer.limit=0 (die Standardeinstellung ist 10) |