Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. 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-Premises“ oder „OPDK“ lautet jetzt „Apigee Edge for Private Cloud“.
Wenn Sie Fragen haben, wenden Sie sich an den Apigee-Kundensupport.
Eine Liste aller Apigee Edge-Versionshinweisen finden Sie unter Apigee-Versionshinweisen.
Neue Features und Verbesserungen
Im Folgenden sind die neuen Funktionen 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 Funktionen und Verbesserungen in Edge API Services aufgeführt.
WebSockets
Um die Echtzeit-Webkommunikation zwischen einem Webclient und einem Server zu ermöglichen, unterstützt Edge das WebSocket-Protokoll. Edge kann bei 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 Using WebSockets (Apigee Edge für Private Cloud mit WebSockets verwenden).
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 API-Administratoren enthalten. Weitere Informationen finden Sie im Leitfaden Externe Authentifizierung für Edge für Private Cloud konfigurieren.
Co-Branding in der Verwaltungsoberfläche
Sie können die Edge-Verwaltungsoberfläche mit Ihrem eigenen benutzerdefinierten Logo versehen, das neben dem Apigee-Logo angezeigt wird. Weitere Informationen finden Sie im Betriebshandbuch für Apigee Edge for Private Cloud im Abschnitt „Dem Apigee-UI-Menü ein benutzerdefiniertes Logo hinzufügen“.
Node.js-Protokolle in Trace
Wenn Sie Node.js API-Proxys debuggen, können Sie die Node.js-Protokollfunktion in der Trace-Ansicht des API-Proxy-Editors aktivieren. Wenn Sie die Funktion aktivieren möchten, legen Sie in der Datei „apigee-base.conf“ oder „apigee-onpremise.conf“ in Ihrer Installation den Wert apigee.feature.disableNodeJSLogs="false" fest. Weitere Informationen zum Node.js-Protokoll finden Sie unter Debugging und Fehlerbehebung bei Node.js-Proxys.
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, es sei denn, er änderte sein Passwort vor Ablauf. Dadurch ist jedoch auch das Passwort des Systemadministrators abgelaufen, sodass er nicht mehr auf Edge zugreifen konnte.
Wenn Sie ein Upgrade auf 4.15.04.00 durchführen, ändert sich der Standardwert so, dass Passwörter nicht ablaufen. Bei Bedarf können Sie Edge-Passwörter mit dem /opt/apigee4/bin/apigee-enable-pwlockout.sh-Script so konfigurieren, dass sie ablaufen. Weitere Informationen finden Sie im Leitfaden für die Verwaltung von Apigee Edge for Private Cloud.
Zugriff von Systemadministratoren auf bestimmte E-Mail-Domains beschränken
Sie können die Mitgliedschaft in den Rollen „sysadmin“ oder „sysadmin read-only“ auf Nutzer in bestimmten E-Mail-Domains beschränken. Wenn Sie diese Funktion aktivieren möchten, fügen Sie die zulässigen Domains der Datei „apigee4/conf/apigee/management-server/security.properties“ hinzu, wie im Leitfaden für die Verwaltung von Apigee Edge für Private Clouds beschrieben.
Fehlermeldungen in der Verwaltungsoberfläche
Die Darstellung von Fehlermeldungen in 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: Wird auf „true“ gesetzt, wenn die Richtlinie nicht erfüllt wurde.
- 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
Beim Erstellen eines neuen Produkts können Sie jetzt zusätzlich zum Anzeigenamen 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 „Nutzer der Organisation“ 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 zuvor gespeicherte Sitzungen aufrufen 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 Benutzeroberfläche für das Offline Trace-Tool ähnelt dem „Live“ Trace-Tool.
Weitere Informationen finden Sie unter Offline-Trace-Tool verwenden.
Nutzerrollen, die in den Nutzereinstellungen angezeigt werden
Auf der Seite „Nutzereinstellungen“ der Verwaltungsoberfläche (Nutzername > Nutzereinstellungen) werden jetzt die Rollen des Nutzers angezeigt.
Verbesserungen der Edge-Verwaltungsoberfläche
Diese Version enthält einige kleinere Verbesserungen der Nutzerfreundlichkeit und Konsistenz der Edge-Verwaltungsoberfläche.
Analytics-Dienste
Im Folgenden sind die neuen Funktionen und Verbesserungen in Edge Analytics Services aufgeführt.
Daten für sechs Monate verfügbar
Wenn Sie Analyseberichte mit der Verwaltungsoberfläche oder API generieren, 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-Support.
Den Analysen hinzugefügte Variablen
Die folgenden neuen Variablen werden an Edge-Analysen übergeben und sind im Fenster „API-Proxy-Trace“ in der AX-Phase zu sehen.
- apigee.edge.execution.is_target_error: Hiermit können Sie feststellen, ob es sich bei API-Fehlern um zielseitige Fehler (Wert „1“) oder nicht zielseitige Fehler für fehlgeschlagene HTTP-Antworten (Wert „0“) handelt. Bei einer erfolgreichen HTTP-Antwort ist der Wert null.
-
apigee.edge.execution.is_policy_error: Gibt an, ob eine Richtlinie fehlgeschlagen ist (Wert „1“) oder ob bei einer fehlgeschlagenen 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 fehlgeschlagenen Richtlinie.
- apigee.edge.execution.fault_flow_name: Der Name des Ablaufs 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. Bisher wurden sie unten auf den Hauptseiten dieser Entitäten angezeigt. Jetzt rufen Sie die Diagramme auf, 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, Entwicklerinteraktionen und Entwickler-Apps. Jedes Diagramm enthält die Ansicht „Weitere Details“, mit der Sie die einzelnen Messwerte aufschlüsseln können. Weitere Informationen finden Sie im Apigee-Dashboard.
- Proxy-Leistung (neu): Hier sehen Sie API-Proxy-Trafficmuster und Verarbeitungszeiten. Ersetzt das Dashboard für die API-Proxy-Leistung. Weitere Informationen finden Sie unter API-Proxy-Leistung.
- Zugriffsquellen (überarbeitet): Das Dashboard wurde komplett überarbeitet. 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): vollständig überarbeitetes Erscheinungsbild und überarbeitete Inhalte Hier sehen Sie die Fehlerraten für API-Proxys und -Ziele. Weitere Informationen finden Sie im Dashboard zur Fehlercodeanalyse.
-
Die folgenden Dashboards wurden umbenannt:
- Endpunktleistung in Leistung der Zielsysteme umbenannt: Zeigt Trafficmuster und Leistungsmesswerte für API-Proxy-Backend-Ziele an. Weitere Informationen finden Sie unter Leistung der Zielsysteme.
- Partner Engagement wurde in Developer 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 sind die neuen Funktionen und Verbesserungen in Edge Developer Services aufgeführt.
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 Sicherheitsschemaobjekte und zentralisierte Schemas wird in einer späteren Version verfügbar sein.
Monetarisierung
Im Folgenden sind die neuen Funktionen und Verbesserungen bei der Edge-Monetarisierung aufgeführt. Weitere Informationen zur Monetarisierung finden Sie im Abschnitt „Bekannte Probleme“.
Separate Behandlung von Unternehmen und Entwicklern
Unternehmen und Entwickler werden jetzt getrennt voneinander behandelt. So können Entwicklern und Unternehmen mehrere Unternehmen bzw. Entwickler hinzugefügt werden. Die Verwaltungsoberfläche 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 Berichten zur Monetarisierung sind Unternehmen weiterhin 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 zum Abrufen eines OAuth 2.0-Autorisierungscodes gibt den falschen Status zurück |
| MGMT-1962 | Fehler bei der Anmeldung in der Verwaltungs-UI mit einem starken Passwort Die Anmeldung in der Benutzeroberfläche 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 | E-Mail zum Zurücksetzen des Passworts funktioniert nicht, wenn die E-Mail-Adresse das Zeichen „_“ enthält Problem beim Zurücksetzen des Passworts in der Private Cloud mit E-Mail-Adressen, die einen Unterstrich enthalten, behoben. |
| CORERT-613 | SSL-Handshake-Fehler aufgrund von „unrecognized_name“ |
| APIRT-1346 | OAuth2.0 – Der gehashte Wert wird in der Antwort des Zugriffstokens zurückgegeben, wenn „hash.oauth.tokens.enabled“ auf „wahr“ festgelegt ist. |
Diese Version enthält außerdem Fehlerkorrekturen aus den folgenden Releases:
| 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 dem Upgrade der Monetarisierung verwendet, wurden nicht in die Version aufgenommen. Führen Sie nach der Cassandra-Installation oder dem Cassandra-Upgrade die folgenden Befehle aus, um die Monetarisierungsinstallation bzw. das Monetarisierungsupgrade abzuschließen:
|
| CORERT-318 | API-Aufrufe mit großen Nutzlasten (mehrere hundert KB) können manchmal hängen. Zur Umgehung dieses Problems legen Sie in der Datei „router.properties“ den folgenden Attributwert fest:HTTPServer.streaming.buffer.limit=0 (die Standardeinstellung ist 10). |