Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
Am Dienstag, dem 19. Mai 2015, wurde eine vierteljährliche Version von Apigee Edge für Private Cloud veröffentlicht.
Der frühere Produktname „Apigee Edge On-Premise“ oder „OPDK“ ist jetzt „Apigee Edge for Private Cloud“.
Wenn Sie Fragen haben, wenden Sie sich an den Apigee-Kundensupport.
Eine Liste aller Versionshinweise zu Apigee Edge finden Sie unter Apigee-Versionshinweise.
Neue Features und Verbesserungen
Im Folgenden sind die neuen Funktionen und Verbesserungen in dieser Version aufgeführt.
OpenLDAP – Installation und Upgrade
OpenLDAP ist jetzt der einzige LDAP-Server, der von Edge für neue und Upgrade-Installationen unterstützt wird.
API-Dienste
Im Folgenden finden Sie neue Funktionen und Verbesserungen in Edge API Services.
WebSockets
Edge unterstützt das WebSocket-Protokoll, um die Webkommunikation in Echtzeit zwischen einem Webclient und einem Server zu ermöglichen. Edge kann in der WebSocket-Kommunikation die Rolle eines Clients oder Servers übernehmen. Informationen zum Einrichten und Verwenden von WebSockets in Edge finden Sie im Leitfaden Apigee Edge for Private Cloud mithilfe von WebSockets.
Unterstützung durch einen externen Authentifizierungsanbieter für die API-Verwaltung
Edge lässt sich in Active Directory und andere externe Authentifizierungsanbieter/LDAP-Systeme einbinden, die Ihre API-Administratornutzer enthalten. Weitere Informationen finden Sie in der Anleitung Edge for Private Cloud External Authentication Configuration.
Co-Branding auf der Verwaltungsoberfläche
Sie können die Edge-Verwaltungs-UI mit Ihrem eigenen benutzerdefinierten Logo gemeinsam als Co-Branding verwenden, das neben dem Apigee-Logo angezeigt wird. Weitere Informationen finden Sie im Vorgangsleitfaden für Apigee Edge für Private Cloud unter „Benutzerdefiniertes Logo zum Apigee-UI-Menü hinzufügen“.
Node.js-Logs in Trace
Beim Debugging von Node.js-API-Proxys können Sie die Node.js-Logfunktion in der Trace-Ansicht des API-Proxy-Editors aktivieren. Legen Sie zum Aktivieren des Features apigee.feature.disableNodeJSLogs="false" in der Datei „apigee-base.conf“ oder „apigee-onprem.conf“ in der Installation fest. Weitere Informationen zu Node.js-Logs finden Sie unter Fehler bei Node.js-Proxys beheben.
Ablauf des Passworts
In Edge 4.15.01.x laufen Edge-Passwörter automatisch nach 30 Tagen ab. Das bedeutete, dass ein Nutzer ausgesperrt wurde, es sei denn, er änderte sein Passwort vor Ablauf. Dies hat jedoch auch dazu geführt, dass das Passwort des Systemadministrators abgelaufen ist, sodass der Systemadministrator aus Edge ausgeschlossen wurde.
Wenn Sie ein Upgrade auf 4.15.04.00 durchführen, ändert sich die Standardeinstellung, sodass Passwörter nicht ablaufen. Bei Bedarf können Sie mit dem Skript /opt/apigee4/bin/apigee-enable-pwlockout.sh dafür sorgen, dass Edge-Passwörter ablaufen. Weitere Informationen finden Sie im Betriebsleitfaden für Apigee Edge für Private Cloud.
Administratorzugriff auf bestimmte E-Mail-Domains beschränken
Sie können die Mitgliedschaft in den schreibgeschützten Rollen sysadmin oder sysadmin auf Nutzer in bestimmten E-Mail-Domains beschränken. Fügen Sie der Datei apigee4/conf/apigee/management-server/security.properties die zulässigen Domains hinzu, wie im Betriebsleitfaden für Apigee Edge for Private Cloud beschrieben, um dieses Feature zu aktivieren.
Fehlermeldungen der Verwaltungs-UI
Die Anzeige von Fehlermeldungen in der Verwaltungs-UI wurde neu gestaltet, um den Platz auf dem Bildschirm 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> – Die Fehlerursache. Beispiel: Token abgelaufen
Siehe http://apigee.com/docs/api-services/content/oauthv2-policy.
Produkterstellung
Wenn Sie ein neues Produkt erstellen, können Sie jetzt zusätzlich zum Anzeigenamen den Produktnamen angeben.
Siehe 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. Damit soll verdeutlicht werden, dass das Apigee-Konto dieses Nutzers aktiv bleibt, wenn Sie einen Nutzer aus einer Organisation entfernen.
Siehe http://apigee.com/docs/api-services/content/managing-organization-users.
Filteroptionen in der Verwaltungs-UI
Auf den Seiten für 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 zuvor gespeicherte Trace-Sitzungen anzeigen 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 sind. Die UI für das Offline-Trace-Tool ähnelt dem "Live"-Trace-Tool.
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 der Edge-Management-Benutzeroberfläche
Diese Version enthält eine Reihe kleiner Verbesserungen hinsichtlich Benutzerfreundlichkeit und Konsistenz in der Edge-Verwaltungs-UI.
Analysedienste
Im Folgenden finden Sie neue Funktionen und Verbesserungen in Edge Analytics Services.
Sechs Monate Daten verfügbar
Beim Generieren von Analyseberichten mit der Verwaltungs-UI oder -API sind standardmäßig keine Daten verfügbar, die älter als sechs Monate sind. Wenn Sie auf Daten zugreifen möchten, die älter als sechs Monate sind, wenden Sie sich an den Apigee-Support.
Variablen zu Analysen hinzugefügt
Die folgenden neuen Variablen werden an die Edge-Analyse übergeben, die in der AX-Phase des API-Proxy-Trace-Fensters sichtbar sind.
- apigee.edge.execution.is_target_error: Ermöglicht die Identifizierung, ob API-Fehler zielseitig Fehler (Wert "1") oder Nicht-Ziel-Fehler für fehlgeschlagene HTTP-Antworten (Wert "0") sind. Bei einer erfolgreichen HTTP-Antwort ist der Wert null.
-
apigee.edge.execution.is_policy_error - Gibt an, ob eine Richtlinie fehlgeschlagen (Wert "1") oder keine Richtlinie in einer fehlgeschlagenen 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. Wenn keine Richtlinie fehlgeschlagen ist, sind die Werte null.- apigee.edge.execution.fault_policy_name – Name der Richtlinie, die fehlgeschlagen ist.
- apigee.edge.execution.fault_flow_name - Der Name des Flusses in der Richtlinie, der fehlgeschlagen 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 Entitäten angezeigt. Jetzt greifen Sie auf die Diagramme zu, indem Sie oben auf jeder Seite den Tab Analytics auswählen.
- Diese Version umfasst wesentliche Arbeiten an diesen vorhandenen oder neuen Dashboards:
- Apigee-Dashboard (überarbeitet): Enthält drei Messwertdiagramme: Proxy-Traffic, Entwicklerinteraktion und Entwickler-Apps. Jedes Diagramm enthält eine Ansicht mit weiteren Details, mit der Sie die einzelnen Messwerte aufschlüsseln können. Siehe Apigee-Dashboard.
- Proxy-Leistung (neu): Zeigt API-Proxy-Traffic-Muster und -Verarbeitungszeiten an. Ersetzt das API-Proxy-Performance-Dashboard. Siehe API-Proxy-Leistung.
- Traffic Composition (Überarbeitet): Das Dashboard und die Inhalte wurden komplett überarbeitet. Misst den relativen Beitrag Ihrer wichtigsten APIs, Apps, Entwickler und Produkte zu Ihrem gesamten API-Programm. Siehe Traffic-Zusammensetzung.
- Fehleranalyse (überarbeitet): Vollständig überarbeitetes Design und Inhalt. Zeigt Fehlerraten für API-Proxys und Ziele. Siehe Dashboard zur Fehlercode-Analyse.
-
Diese bestehenden Dashboards wurden umbenannt:
- Endpunktleistung wurde in Zielleistung umbenannt: Zeigt Traffic-Muster und Leistungsmesswerte für API-Proxy-Back-End-Ziele an. Siehe Zielleistung.
- Partner Engagement wurde in Developer Engagement umbenannt: Zeigt dir an, welche deiner registrierten App-Entwickler den meisten API-Traffic generieren. Sie können für jeden Ihrer Entwickler herausfinden, wer den meisten API-Traffic und die meisten Fehler generiert. Siehe Entwicklerinteraktion.
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 hält die Abwärtskompatibilität mit Swagger 1.2 aufrecht. Die Unterstützung für Sicherheitsschemaobjekte 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 findest du im Abschnitt „Bekannte Probleme“.
Separate Handhabung von Unternehmen und Entwicklern
Unternehmen und Entwickler werden jetzt separat verwaltet, was mehr Flexibilität beim Hinzufügen mehrerer Unternehmen zu Entwicklern und mehreren Entwicklern zu Unternehmen ermöglicht. Die Verwaltungsoberfläche enthält jetzt separate Fenster für „Unternehmen“ und „Entwickler“, auf die über das Menü „Veröffentlichen“ zugegriffen werden kann.
Weitere Informationen finden Sie unter Unternehmen und Entwickler verwalten.
In Monetarisierungsberichten bleiben Unternehmen ein primärer Filter, obwohl das Filterlabel von „Entwickler“ zu „Unternehmen“ geändert wurde.
Fehlerkorrekturen
Folgende Fehler wurden in diesem Release behoben.
| Fehler-ID | Beschreibung |
|---|---|
| OPDK-954 | 4.15.01 Für das Cassandra-Schema kein Upgrade durchgeführt |
| MGMT-1986 | Fehler in der Benutzeroberfläche beim Hinzufügen eines Entwicklers |
| MGMT-1983 | Eine OAuth 2.0-Autorisierungscode-API gibt einen falschen Status zurück |
| MGMT-1962 | Fehler bei der Anmeldung in der Verwaltungs-UI mit einem starken Passwort Die Anmeldung in der UI mit bestimmten Sonderzeichen wie dem Prozentzeichen wird nicht mehr fehlschlagen. |
| MGMT-1894 | Der Ladevorgang der Entwickler-Spalte auf der Entwickler-Apps-Seite wird nicht abgeschlossen |
| MGMT-1872 | Benutzerdefinierte Berichte können nicht heruntergeladen werden |
| MGMT-1777 | Nutzer mit E-Mail-Adresse, die die TLD „.acn“ hat, kann nicht hinzugefügt werden |
| MGMT-1362 | Die E-Mail-Adresse „Passwort vergessen“ funktioniert nicht, wenn die E-Mail-Adresse „_“ enthält Das Problem mit dem Zurücksetzen des Passworts in Private Cloud mit E-Mail-Adressen, die einen Unterstrich enthalten, wurde behoben. |
| CORERT-613 | SSL-Handshake-Fehler aufgrund von "unerkannten_name" |
| APIRT-1346 | OAuth 2.0 – Hash-Wert wird in der Zugriffstoken-Antwort zurückgegeben, wenn hash.oauth.tokens.enabled wahr ist |
Diese Version enthält außerdem Fehlerbehebungen für die folgenden Versionen:
| Edge Cloud | Edge für Private Cloud |
|---|---|
Bekannte Probleme
In dieser Version gibt es die folgenden bekannten Probleme.
| Fehler-ID | Beschreibung |
|---|---|
| – |
Zwei Cassandra-Skripts, die das Installationsprogramm bei der Installation oder Aktualisierung der Monetarisierung verwendet, waren nicht im Release enthalten. Um dies zu umgehen, führen Sie nach der Cassandra-Installation die folgenden Befehle aus oder führen Sie ein Upgrade aus, um die Installation/das Upgrade für die Monetarisierung abzuschließen:
|
| CORERT-318 | API-Aufrufe mit großen Nutzlasten (100 KB) können manchmal hängen bleiben. Legen Sie den folgenden Attributwert in der Datei „router.properties“ fest, um dieses Problem zu umgehen:HTTPServer.streaming.buffer.limit=0 (die Standardeinstellung ist 10) |