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-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 Funktionen und Verbesserungen in diesem Release aufgeführt.
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 die neuen 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 WebSocket-Kommunikationen entweder die Rolle des Clients oder des Servers übernehmen. Informationen zum Einrichten und Verwenden von WebSockets in Edge finden Sie im Leitfaden Apigee Edge for Private Cloud Using WebSockets.
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 Externe Authentifizierung für Edge for Private Cloud 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 „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“ 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 bedeutet, dass ein Nutzer ausgesperrt wurde, wenn er sein Passwort nicht vor dem Ablauf geändert hat. Dadurch lief jedoch auch das Passwort des Systemadministrators ab, sodass der Systemadministrator nicht mehr auf Edge zugreifen konnte.
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 /opt/apigee4/bin/apigee-enable-pwlockout.sh-Skript 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. 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 Apigee Edge for Private Cloud Operations Guide beschrieben.
Fehlermeldungen in der Management-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 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. Damit 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 Verwaltungs-UI
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 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 sind. Die Benutzeroberfläche 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 Verwaltungs-UI (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 die neuen 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: Mit dieser Variablen können Sie ermitteln, ob API-Fehler zielseitige Fehler (Wert „1“) oder Nicht-Ziel-Fehler für fehlgeschlagene HTTP-Antworten (Wert „0“) sind. Der Wert ist für eine erfolgreiche HTTP-Antwort „null“.
-
apigee.edge.execution.is_policy_error: Mit dieser Variablen können Sie ermitteln, ob eine Richtlinie fehlgeschlagen ist (Wert „1“) oder ob in 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
- 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 Analysen auswählen.
- Diese Version enthält wichtige Änderungen an den folgenden vorhandenen oder neuen Dashboards:
- Apigee-Dashboard (überarbeitet): Enthält drei Messwertdiagramme: Proxy-Traffic, Entwickler-Engagement und Entwickler-Apps. Für jedes Diagramm ist eine Ansicht mit weiteren Details verfügbar, in der Sie die einzelnen Messwerte aufschlüsseln können. Weitere Informationen finden Sie unter Apigee-Dashboard.
- Proxy-Leistung (Neu): Hier werden API-Proxy-Trafficmuster und ‑Verarbeitungszeiten angezeigt. Ersetzt das Dashboard für die API-Proxy-Leistung. Weitere Informationen finden Sie unter API-Proxy-Leistung.
- Traffic Composition (überarbeitet): Das Dashboard wurde komplett überarbeitet und hat ein neues Design und 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 Erscheinungsbild und die Inhalte wurden vollständig überarbeitet. Hier werden Fehlerraten für API-Proxys und -Ziele angezeigt. Weitere Informationen finden Sie im Fehlercodeanalyse-Dashboard.
-
Die 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 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 finden Sie die neuen Funktionen und Verbesserungen in Edge Developer Services.
Unterstützung von Swagger 2.0 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 die neuen Funktionen und Verbesserungen bei der Edge-Monetarisierung. Weitere Informationen zur Monetarisierung finden Sie auch im Abschnitt „Bekannte Probleme“.
Separate Bearbeitung von Unternehmen und Entwicklern
Unternehmen und Entwickler werden jetzt separat behandelt. So können Entwicklern mehrere Unternehmen und Unternehmen mehrere Entwickler zugewiesen werden. Die Verwaltungs-UI bietet jetzt separate Fenster für „Unternehmen“ und „Entwickler“ (über das Menü „Veröffentlichen“).
Weitere Informationen finden Sie unter Unternehmen und Entwickler verwalten.
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 | Description |
|---|---|
| OPDK-954 | 4.15.01 Cassandra-Schema wird nicht aktualisiert |
| MGMT-1986 | UI-Fehler beim Hinzufügen eines Entwicklers |
| MGMT-1983 | API zum Abrufen eines OAuth 2.0-Autorisierungscodes gibt falschen Status zurück |
| MGMT-1962 | Fehler beim Anmelden 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“ können nicht hinzugefügt werden |
| MGMT-1362 | 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 Fehlerkorrekturen aus den folgenden Versionen:
| Edge Cloud | Edge for Private Cloud |
|---|---|
Bekannte Probleme
Dieser Release weist die folgenden bekannten Probleme auf.
| Problem-ID | Beschreibung |
|---|---|
| – |
Zwei Cassandra-Scripts, die das Installationsprogramm bei der Installation oder dem Upgrade der Monetarisierung verwendet, waren nicht im Release enthalten. Führen Sie nach der Cassandra-Installation oder dem Upgrade die folgenden Befehle aus, um die Monetarisierungsinstallation bzw. das Monetarisierungsupgrade 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) |