4.15.04.00 – Versionshinweise zu Apigee Edge for Private Cloud

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:

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
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)