<ph type="x-smartling-placeholder"></ph>
Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur
Apigee X-Dokumentation. Weitere Informationen
Am Dienstag, den 8. September 2015 haben wir eine wichtige Funktionsversion von Apigee Edge for Private veröffentlicht. Cloud
<ph type="x-smartling-placeholder">Seit dem vorherigen vierteljährlichen Release von Edge for Private Cloud (4.15.04.00) wurden die folgenden Es gibt verschiedene Versionen, die in dieser vierteljährlichen Version enthalten sind:
Auf welche Edge-Versionen können Sie ein Upgrade vornehmen? 4.15.07.00
Abhängig von Ihrer aktuellen Version von Edge haben Sie folgende Möglichkeiten:
- Direktes Upgrade auf 4.15.07.00
- Stufenweises Upgrade, d. h. Sie müssen ein Upgrade von Ihrer aktuellen Version auf eine andere durchführen. und dann ein Upgrade auf 4.15.07.00 ausführen.
Weitere Informationen finden Sie unter Welche Edge for Private Cloud-Versionen können Sie aktualisieren? 4.15.07.00.
Vor dem Upgrade von Version 4.15.01.x oder einer früheren Version
- Prüfen Sie die Cassandra-SSTable-Version:
<ph type="x-smartling-placeholder">
- </ph>
- Ändern Sie das Verzeichnis zu /<install-root>/apigee4/data/cassandra/data.
- Führen Sie einen „Find“-Befehl aus:
> suchen . -name *-ic-*
Wenn Sie Cassandra 1 .2 SSTable ausführen, sollten die Ergebnisse eine Reihe von.db-Dateien zurückgeben. - Führen Sie den folgenden Suchbefehl aus:
> suchen . -name *-hf-*
Das Ergebnis sollte leer sein, d. h., es gibt keine DB-Dateien im hf-Format. Wenn Sie im Ordner hf-Format verwenden, abgeschlossen ist und ein Upgrade auf 4.15.07.00 ausführen kann.
Das hf-Format gilt für Cassandra 1.0 SSTables Bei *.db-Dateien im hf-Format müssen Sie aktualisieren Sie die SSTable wie im weiteren Verlauf dieses Verfahrens beschrieben.
- Wenn *.db-Dateien im hf-Format vorhanden sind, führen Sie ein Upgrade von SSTable aus
indem Sie den folgenden Befehl auf jedem Cassandra-Knoten ausführen, bis Sie ein Upgrade aller Cassandra-Knoten durchgeführt haben.
Knoten:
> /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradestables -A - Wiederholen Sie Schritt 1, um zu überprüfen, ob alle *.db-Dateien im ic-Format für Cassandra 1.2 vorliegen. Version.
- Wiederholen Sie die Schritte 1 bis 3 auf jedem Cassandra-Knoten in Ihrer Edge-Installation.
- Führen Sie ein Upgrade auf Edge 4.15.07.00 aus.
- Überprüfen Sie nach dem Upgrade auf Version 4.15.07.00 die *.db-Dateien, um sicherzustellen, dass sie alle aktualisiert wurden.
zur stabilen Version C* 2.0:
> cd /<install-root>/apigee4/data/cassandra/data
> suchen . -name *-jb-*
Wenn Sie Cassandra 2 .0 ausführen, sollte dieser Befehl eine Reihe von.db-Dateien zurückgeben.
Neue Features und Verbesserungen
Im Folgenden sind die neuen Funktionen und Verbesserungen in dieser Version aufgeführt.
Installation und Upgrade
Selektives Upgrade und Deinstallation von Komponenten
Mit den Skripts apigee-upgrade.sh und apigee-uninstall.sh können Sie jetzt die Edge-Komponenten auswählen. um ein Upgrade durchzuführen oder zu deinstallieren. Bisher wurden alle Komponenten auf dem Knoten aktualisiert oder deinstalliert. (OPDK-1377, OPDK-1175)
Rollback für Upgrade durchführen
Wenn die apigee-upgrade.sh während eines Upgrades fehlschlägt, können Sie jetzt die apigee-rollback.sh verwenden. Skript für ein Rollback des Upgrades. Nachdem Sie alle Probleme mit dem Upgrade behoben haben, können Sie es noch einmal versuchen. (OPDK-1275)
Gekürzte Optionen des Installationsprogramms für Script
Die Installationsskripts haben nicht mehr die lange Form von Optionen wie --help. Jetzt gibt es nur noch können Sie Optionen mit nur einem Buchstaben verwenden, z. B. -h. (OPDK-1356)
SmartDocs-Installation
Wenn Sie SmartDocs mit dem Skript „setup-smartdocs.sh“ installieren, werden Sie aufgefordert, die Organisation, Umgebung und virtuellem Host aus. Dadurch wird sichergestellt, dass SmartDocs erwarteter Standort. Bisher wurden diese Werte im Skript hartcodiert. (OPDK-1310)
update-cass-pwd-in-config.sh ohne Eingabeaufforderungen ausführen
Das Skript update-cass-pwd-in-config.sh kann ohne Aufforderungen ausgeführt werden, wenn Sie die Methode ENABLE_CASS_AUTH, CASS_USERNAME und CASS_PASSWORD. (OPDK-1309)
Edge-Plattform
Im Folgenden sind die neuen Edge-Plattformfunktionen in dieser Version aufgeführt.
OpenJDK 1.7 wird von Edge Private Cloud unterstützt
Diese Version von Edge unterstützt Oracle JDK 1.7 und OpenJDK 7 und hat die Unterstützung für JDK 1.6 entfernt. (OPDK-1187)
Betriebssystemunterstützung
Apigee Edge for Private Cloud hat die Betriebssystemunterstützung um Red Hat erweitert. Enterprise Linux 6.6 und 7.0 (64-Bit), CentOS 6.5, 6.6 und 7.0 (64-Bit) und Oracle Linux 6.5
Cassandra 2.0.15 in OPDK 15.07 enthalten
Dieser Release installiert Cassandra 2.0.15. Wenn Sie ein Upgrade auf eine frühere Version durchführen, Version von Cassandra aktualisiert wird. (OPDK-1197)
SHA2-Unterstützung für OAuth-Token-Hashing
Um OAuth-Tokens im Falle einer Datenbanksicherheit besser zu schützen, unterstützt Edge SHA2 Algorithmen zum Hashen von OAuth-Tokens (zusätzlich zu SHA1). Mit neuer Ebene Properties haben, können Sie das Hashing für neue Tokens aktivieren und konfigurieren und die alte Hash-Technologie beibehalten. für alle Tokens, die bereits vor dieser neuen Funktion vorhanden waren. Bisher war in Edge für Private Cloud ein mit dem Namen "hash.oauth.tokens.enabled" in der Datei "keymanagement.properties" (auf Ihrer Verwaltungsserver und Nachrichtenprozessoren) das automatische SHA1-Hashing von OAuth-Tokens aktiviert haben. Dieses wurde eingestellt.
Wenn Sie zuvor die Eigenschaft hash.oauth.tokens.enabled verwendet haben, um die SHA1-Hash-Technologie zu aktivieren, wird der Upgradeskript für diese Version generiert die neuen Eigenschaften auf Organisationsebene automatisch für Sie. Bis Führen Sie nach dem Upgrade eine GET-Anfrage als Systemadministrator mit dieser API aus: https://{host}:{port}/v1/o/{your_org}.
- Informationen zum Aktivieren der Token-Hash-Technologie in Ihrer Organisation mit den neuen Attributen finden Sie unter „Hash-Tokens in der Datenbank“ im Feld Zugriffstokens anfordern .
- Informationen zum Bulk-Hashing vorhandener Tokens finden Sie unter Edge for Private Cloud Bedienungsanleitung. (APIRT-1389)
Einfache Verzeichnisstruktur für Protokolldateien
Sie können Edge so konfigurieren, dass Protokolldateien in einer flachen Verzeichnisstruktur gespeichert werden, indem Sie eine neue
Property enable.flat.directory.structure
in message-logging.properties auf „true“
-Datei. Weitere Informationen finden Sie unter Nachrichten-Logging-Richtlinie.
(APIRT-1394)
Leistung des Umgebungscaches
Für eine bessere Verwaltung und Auslastung des speicherinternen Caches sollte die Einstellung „Maximale Anzahl von Elementen im Arbeitsspeicher“ Einstellungen für Ressourcen im Umgebungscache wurden eingestellt. Die gesamten Elemente in dass alle Cache-Ressourcen (einschließlich des Standardcaches) vom Gesamtarbeitsspeicher Cache gespeichert werden. Standardmäßig der Gesamtarbeitsspeicher, der für das In-Memory-Caching auf einem bestimmten Nachrichtenprozessor zugewiesen ist 40% des insgesamt verfügbaren Arbeitsspeichers aus. Dies wird durch die Cache-Property-Einstellungen in Ihrer Mitteilung bestimmt. Prozessor-Cache.properties-Datei. Elemente werden nur dann aus dem Cache im Arbeitsspeicher entfernt, wenn nicht genügend Cache-Speicher oder die Elemente ablaufen.
Um zum alten Verhalten der Einstellung "Maximale Anzahl von Elementen im Arbeitsspeicher" zurückzukehren Property für
für die Cache-Verwaltung das Attribut overrideMaxElementsInCacheResource=false
in der
cache.properties-Datei verwenden. (APIRT-1140)
API-Dienste
Nachfolgend sind die neuen Funktionen der API-Dienste in dieser Version aufgeführt.
Neuer Proxy-Editor als Standard
Der neue API-Proxy-Editor ist standardmäßig in der Verwaltungsoberfläche aktiviert. Der neue Editor enthält Usability-Tests, darunter umfassendere Ansichten von bedingten Abläufen Endpunkte auf der Übersichtsseite, die gesamte Konfiguration auf der Seite „Develop“, intuitiveres Hinzufügen von bedingte Datenflüsse, Endpunkte und Richtlinien, umfassendere XML-Ansichten anstelle von kleinen Snippets, eine Suche, die Dateinamen und Text crawlt, und vieles mehr. (MGMT-2279)
Neue Inforichtlinie zum Löschen von OAuth 2.0
Die neue Meldung „Informationen zu OAuth v2.0 löschen“ können Sie OAuth v2-Zugriffstokens und Autorisierungen löschen. Codes. Die Richtlinie ersetzt die Funktionen, die zuvor von der Verwaltungs-API bereitgestellt wurden. Weitere Informationen erhalten Sie unter Löschen OAuthV2-Informationen-Richtlinie (MGMT-2257)
Neue Inforichtlinie zum Löschen von OAuth 1.0
Die neue Meldung „Informationen zu OAuth v1.0 löschen“ können Sie OAuth v1.0-Anfragetokens, Zugriffsrechte Tokens und Verifizierungscodes. Die Richtlinie ersetzt die bisherigen Funktionen der Management API Weitere Informationen finden Sie unter OAuth V1 Info-Richtlinie löschen. (APIRT-1351)
Zugriffssteuerungsrichtlinie
Die Zugriffssteuerungsrichtlinie wurde erweitert, um eine detailliertere Auswertung von IP-Adressen zu ermöglichen
für die Zulassungs- und Sperrliste, wenn IP-Adressen im
HTTP-Header „X-FORWARDED-FOR
“
Wenn die Prüfung mehrerer IP-Adressen für den Header aktiviert ist (wenden Sie sich an den Support, um die
feature.enableMultipleXForwardCheckForACL)
mit dem neuen <ValidateBasedOn>
-Element in der Richtlinie
die erste, die letzte oder alle IP-Adressen im Header. Weitere Informationen finden Sie unter Zugriffssteuerungsrichtlinie.
Neue Entitäten in der Access Entity-Richtlinie
Die Richtlinie für Zugriffsentitäten bietet Zugriff auf die folgenden neuen Entitäten: consumerkey-scopes, Autorisierungscode, Anfragetoken und Verifier. Weitere Informationen finden Sie unter Zugriffsentitätsrichtlinie.
Statistics Collector-Richtlinie: automatische Konvertierung von Statistiknamen in Kleinbuchstaben
Beim Erstellen einer benutzerdefinierten Analysesammlung im API-Proxy-Editor (Seite Entwickeln > Tools) > Benutzerdefinierte Analytics-Sammlung), die Collector-Variable (Statistik) „Name“ muss aus Kleinbuchstaben bestehen. Wird der Name in Großbuchstaben eingegeben, wandelt das Tool den Namen der Statistik automatisch um. in der Statistics Collector-Richtlinie in Kleinbuchstaben umwandeln. (MGMT-740)
Entfernen des klassischen Trace im API-Proxy-Editor
Die neueste Version der Trace-Funktion im API-Proxy-Editor wurde von der Betaversion auf allgemeine Verfügbarkeit. Zugriff auf „klassischen Trace“ mit der Option „Auf die klassische Version von Trace zugreifen“ Link ist nicht mehr verfügbar.
Zugriff auf die Apigee-Community über das Hilfemenü der Verwaltungsbenutzeroberfläche
Sie können über das Hilfemenü der Verwaltungsbenutzeroberfläche auf die Apigee-Community zugreifen.
Fehlermeldungen in der Verwaltungsoberfläche
Im Folgenden finden Sie Verbesserungen an Fehlermeldungen in der Verwaltungsoberfläche:
- Die Verwaltungsoberfläche, mit der alle Fehlermeldungen gruppiert und angezeigt werden, wenn Sie sie nicht geschlossen haben. Mit diesem Update werden die Fehlermeldungen gelöscht wenn Sie die entsprechende Seite verlassen. (MGMT-2254)
- In der Verwaltungsbenutzeroberfläche werden doppelte Fehlermeldungen nicht mehr unterdrückt. (MGMT-2242)
Leistung der Benutzeroberfläche und Fehleroptimierungen
Verschiedene Bereiche der Verwaltungsbenutzeroberfläche wurden allgemein verbessert, einschließlich der Seitenanzeige. und die Bereinigung der Fehlermeldungen.
Rollen-Hyperlinks auf der Seite „Organisationsnutzer“ in der Verwaltungsoberfläche
Auf der Seite „Nutzer der Organisation“ in der Verwaltungsoberfläche (Verwaltung > Nutzer der Organisation) die Rolle sind jetzt mit einem Hyperlink versehen, sodass Sie schnell zu den Seiten mit den Rollen navigieren können. (MGMT-1055)
Neue Zielvariablen im Nachrichtenfluss
Neue Variablen in Nachrichtenflüssen bieten umfassendere URL-Informationen für Zielendpunkte und Zielserver:
-
TargetEndpoint:
request.url
ersetzttarget.basepath.with.query
. -
Zielserver:
loadbalancing.targetserver
ersetzttargetserver.name
. Außerdem wirdtarget.basepath
nur gefüllt, wenn Das<Path>
-Element wird im TargetEndpoint-Element HTTPTargetConnection-Element<LoadBalancer>
Unterstützung für SNI (Server Name Indication)
Edge unterstützt die Verwendung von Server Name Indication in Richtung Süden (vom Nachrichtenprozessor zum Ziel). Endpunkten). Wenn Sie SNI verwenden möchten, wenden Sie sich an den Apigee-Support.
Java 1.7 ist erforderlich.
Mit SNI, einer Erweiterung von TLS/SSL, können mehrere HTTPS-Ziele vom selben IP-Adresse und Port, ohne dass alle diese Ziele dasselbe Zertifikat verwenden müssen.
Es ist keine Edge-spezifische Konfiguration erforderlich. Wenn Ihre Umgebung für Süden konfiguriert ist SNI (standardmäßig Edge Cloud) unterstützt Edge es.
Edge extrahiert automatisch den Hostname aus der Anfrage-URL und der SSL-Handshake-Anfrage hinzu. Wenn der Zielhost beispielsweise https://example.com/request/path ist, gilt: Edge fügt die Erweiterung server_name wie gezeigt hinzu unten:
Weitere Informationen zu SNI finden Sie unter http://en.wikipedia.org/wiki/Server_Name_Indication.
„Signaturalgorithmus“ in den Details der SSL-Zertifikate
Ein neuer Signaturalgorithmus wurde den SSL-Zertifikatdetails hinzugefügt, das in der Verwaltungs-UI (Verwaltung > SSL-Zertifikate) und die Verwaltungs-API (Get Zertifikatdetails aus einem Schlüsselspeicher oder Truststore). Im Feld wird entweder „sha1WithRSAEncryption“ oder „sha256WithRSAEncryption“ verwenden, je nachdem, welchen Hash-Algorithmus Zertifikat.
SSL-Zertifikate, die bald ablaufen, werden angezeigt
Auf der Seite „SSL-Zertifikate“ in der Verwaltungsoberfläche (Verwaltung > SSL-Zertifikate) wird angezeigt, SSL-Zertifikate laufen innerhalb von 10, 15, 30 oder 90 Tagen ab, je nachdem, was Sie in den neuen Dropdown-Feld für den Ablauf.
Bedrohungsschutzfehlerkonfiguration
Standardmäßig gibt Edge den Statuscode „HTTP 500 Internal Server Error“ und den Fehler ExecutionFailed aus
Fehler, wenn eine Nachricht die JSON- oder XML Threat Protection-Richtlinie nicht überschreitet. Sie können dieses Fehlerverhalten mit einer neuen Property auf Organisationsebene ändern. Beim Festlegen der Organisation
Eigenschaft features.isPolicyHttpStatusEnabled
auf "true" setzen,
zu folgendem Verhalten:
- Anfrage: Wenn eine Anfrage zum Schutz vor Bedrohungen angehängt ist, werden ungültige Nachrichten einen 400-Statuscode zusammen mit einer entsprechenden Richtlinienfehlermeldung zurückgeben.
- Antwort: Mit einer Bedrohungsschutzrichtlinie, die an einen Antwortfluss angehängt ist, werden ungültige Nachrichten weiterhin einen 500-Statuscode zurückgeben, und eine der entsprechenden Richtlinienfehlermeldungen wird ausgegeben. (und nicht nur „ExecutionFailed“).
Cloud-Kunden müssen sich an den Apigee-Support wenden, um die Organisationseigenschaft festzulegen. Dieses Feature wird für Edge Private Cloud-Kunden verfügbar sein im nächsten Vierteljährlicher Release der privaten Cloud.
Aktualisierte Schemas für Endpunkte, Proxys und andere Entitäten
Referenzschemas wurden für Nicht-Richtlinienentitäten wie TargetEndpoint aktualisiert. ProxyEndpoint, APIProxy und viele andere. Siehe https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)
Entwicklerdienste
Im Folgenden sind die neuen Funktionen der Entwicklerdienste aufgeführt, die in dieser Version enthalten sind.
Allgemeine Verfügbarkeit von SmartDocs
SmartDocs hat seine Beta-Phase abgeschlossen und ist nun allgemein verfügbar. Updates und neue Funktionen umfassen:
- Unterstützung für Swagger 2.0, einschließlich Import per Datei oder URL, einschließlich Unterstützung für benutzerdefinierte Sicherheitsobjekte.
- Visuelle Designverbesserungen in den Vorlagen, die SmartDocs generieren.
- Verbesserung der Nutzerfreundlichkeit und des Workflows im Entwicklerportal, verfügbar über die Inhalte > SmartDocs-Menü in Drupal.
- Ein bisher als „benutzerdefiniertes Token“ bezeichnetes Token Authentifizierung heißt jetzt „API-Schlüssel“.
- Authentifizierung „Sicherheit“ -Objekte, die auf Revisionsebene definiert wurden.
- Konfiguration der Clientauthentifizierung auf Vorlagenebene. Neue Überarbeitungen werden nicht mehr zurückgesetzt Alle vorkonfigurierten Anmeldedaten des SmartDocs-Clients
Weitere Funktionsbeschreibungen finden Sie in diesem Blog. Blogpost.
Die SmartDocs-Dokumentation finden Sie unter Verwenden von SmartDocs zur Dokumentation APIs
Name der Entwickler-App, der auf der Verwaltungsoberfläche angezeigt wird
Entwickler-Apps in Edge haben sowohl einen internen Namen, der sich nicht ändert, als auch einen Anzeigenamen, der die Sie ändern können. Auf der Seite einer Entwickler-App in der Verwaltungsoberfläche („Veröffentlichen“ > „Entwickler-Apps“ > App-Name), der interne "Name" der App wird zusammen mit dem „Anzeigenamen“ angezeigt, um Apps für die Fehlerbehebung und API-Verwaltung visuell anhand ihrer internen Namen zu identifizieren.
Analysedienste
Im Folgenden sind die neuen Analytics Services-Funktionen in dieser Version aufgeführt.
Zeitlimit für beibehaltene Daten
Beim Generieren von Analyseberichten mit der Verwaltungs-UI oder der API: Daten, die älter als sechs Monate sind ab dem aktuellen Datum ist standardmäßig nicht verfügbar. Wenn Sie auf Daten zugreifen möchten, die älter als sechs Monate, wenden Sie sich an den Apigee-Support.
Klassische Version benutzerdefinierter Berichte wird aus der Verwaltungsoberfläche entfernt
Die optionale klassische Version der benutzerdefinierten Analyseberichte ist nicht mehr verfügbar in der auf der Benutzeroberfläche.
Leistung des Widgets für Entwicklerinteraktionen
Das Trichter-Widget im Haupt-Analytics-Dashboard (Bereich „Entwicklerinteraktion“) wurde verbessert. um eine bessere Leistung zu erzielen.
Monetarisierung
Im Folgenden sind die neuen Monetarisierungsfunktionen in dieser Version aufgeführt.
E-Mail-Benachrichtigungen zu Preisplänen
Mit dem neuen Preisplan-E-Mail-Benachrichtigungstyp können Sie Entwickler benachrichtigen, wenn sie eine bestimmte Transaktions- oder Dollarlimit in den erworbenen Tarifen für Volume-Band- oder Pakettarife festgelegt werden. Für Weitere Informationen mithilfe von Benachrichtigungsvorlagen.
Synchronisierung wiederkehrender Gebühren und Basiszeiträume für Zusammenfassungen
In einem Preisplan gab es möglicherweise zwei verschiedene Zeiträume:
- Wiederkehrender Gebührenzeitraum, der auf dem Tab „Gebühren“ eines Preisplans konfiguriert wird und den Zeitpunkt wurde eine wiederkehrende Gebühr in Rechnung gestellt.
- Basiszeitraum für die Aggregation, der in der Preisliste für Volumen- oder Pakettarife definiert ist, bestimmt, wann die Verwendung des Sets für Entwickler zurückgesetzt wurde.
Diese beiden Zeiträume sind jetzt synchronisiert. Wenn sowohl eine wiederkehrende Gebühr ungleich null als auch ein Band mit Volumen oder Paket-Preisliste in einem Preisplan vorhanden ist, wird der Zeitraum für wiederkehrende Gebühren für beide verwendet. Beispiel: Bei einer monatlichen wiederkehrenden Gebühr werden Preislistenpakete ebenfalls monatlich zurückgesetzt (standardmäßig auf zu Beginn des Monats).
Falls keine wiederkehrende Gebühr vorhanden ist, werden Sets basierend auf der Aggregationsgrundlage zurückgesetzt, die im Preisliste. Beispiel: Ein Entwickler beginnt am 19. des Monats, eine Preisliste zu verwenden und der Die Aggregationsgrundlage ist jeden Monat. Anschließend wird die Bundle-Nutzung einen Monat nach dem 19. zurückgesetzt.
Die Aggregationsgrundlage wird eingestellt und demnächst aus der Monetarisierung entfernt Veröffentlichung. Weitere Informationen finden Sie unter Preislistenplan angeben Details.
Benutzerdefinierte Attribute in zusammenfassenden Umsatzberichten
Mit Richtlinien für Transaktionsaufzeichnungen können Sie optional Daten zu benutzerdefinierten Attributen aus Transaktionen und können diese benutzerdefinierten Transaktionsattribute jetzt in die Umsatzübersicht aufnehmen. Berichte. Wenn Sie Ihrer Organisation eine Property vom Typ MINT.SUMMARY_CUSTOM_ATTRIBUTES hinzufügen, können Sie geben an, welche benutzerdefinierten Attribute zu den Datenbanktabellen zur Verwendung in Berichten hinzugefügt werden.
Kunden von Apigee Edge für Private Cloud können das Flag mit dem folgenden API-Aufruf festlegen und Anmeldedaten des Systemadministrators
curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \ "<Organization type="trial" name="MyOrganization"> <Properties> <Property name="features.isMonetizationEnabled">true</Property> <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">["my_attribute_1","my_attribute_2"]</Property> <Property name="features.topLevelDevelopersAreCompanies">false</Property> </Properties> </Organization>"
Beachten Sie, dass das Array der benutzerdefinierten Attribute im API-Aufruf URL-codiert ist.
SmartDocs-Upgradeprozess
Wenn Sie SmartDocs bereits während der Betaphase verwendet haben, werden neue Funktionen in der Version mit allgemeiner Verfügbarkeit müssen Sie ein Upgrade für SmartDocs in Ihrem Entwickler durchführen,
Alle bereits in Ihrem Entwicklerportal veröffentlichten SmartDocs-Seiten werden weiterhin aber Sie müssen den Aktualisierungsprozess befolgen, bevor Sie Änderungen an vorhandenen bearbeiten oder veröffentlichen. oder neue Seiten zu generieren.
Beachten Sie, dass Sie zwar SmartDocs in Ihrem Entwicklerportal rendern und veröffentlichen können, SmartDocs werden aus dem API-Modell in der Edge API-Verwaltung von Apigee generiert. Dienste. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, sind im gesamten Pantheon gleich Umgebungen (ähnlich wie Entwickler in verschiedenen Pantheon-Umgebungen).
So führen Sie ein Upgrade von der SmartDocs-Betaversion auf die allgemeine Verfügbarkeit aus:
- Aktualisieren und testen Sie die Version 15.05.27 in Ihre dev- oder test-Umgebungen Pantheon.
- Erstellen Sie ein neues Modell, um ein vorhandenes API-Modell zu ersetzen, das Sie bisher verwendet haben.
- Wenn Sie bereits Swagger- oder WADL-Dokumente importiert haben, importieren Sie sie noch einmal in ein neues Überarbeitung.
- Wenn Sie Ihr API-Modell über das SmartDocs-Modul verwaltet haben, exportieren Sie es als SmartDocs-JSON erstellen und mithilfe eines Dateianhangs in Ihr neues Modell importieren.
- Legen Sie die Sicherheitsattribute der Überarbeitung Ihres Modells fest. Klicken Sie auf der Seite Inhalte >
SmartDocs > Modell die Option Sicherheitseinstellungen aus.
- Prüfen Sie auf der Seite mit den Modelleinstellungen (Inhalt >
SmartDocs, indem Sie im Menü „Vorgänge“ auf Einstellungen klicken
Spalte.
- Aktualisieren Sie alle benutzerdefinierten Vorlagen, um Version 6 der CSS- und JS-Assets zu verwenden, und nehmen Sie entsprechende Änderungen vor. alle neuen Objektnamen, z. B. authSchemes und apiSchema. Informationen zum Aktualisieren von SmartDocs erhalten Sie unter Verwenden von SmartDocs zur Dokumentation von APIs
- Rendern und veröffentlichen Sie die Modellversion noch einmal.
- Nachdem Sie die neue Dokumentation überprüft haben, Ihr Produktionsportal auf die Version 15.05.27.
Wenn Sie Edge Enterprise-Kunde sind und Fragen oder Bedenken zum Upgrade haben senden Sie bitte eine E-Mail an marsh@apigee.com und cnovak@apigee.com. Andernfalls verwenden Sie in der Apigee-Community, Antwort.
Zukünftige Funktionsänderungen und Verbesserungen
In diesem Abschnitt erhalten Sie eine Vorschau auf erwartete zukünftige Funktionsänderungen und Verbesserungen:
Ändern zu Verhalten der Antwort-Cache-Richtlinie
Für eine zukünftige Version (noch nicht festgelegt) gilt das Standardverhalten des <ExcludeErrorResponse> der Antwort-Cache-Richtlinie ändert.
Aktuelles Verhalten: Das Element <AusschließenErrorResponse> in der Die Cache-Richtlinie für Antworten ist standardmäßig auf „false“ gesetzt. Das bedeutet, dass Antworten standardmäßig Mögliche HTTP-Statuscodes (einschließlich 3xx) werden von der Antwort-Cache-Richtlinie im Cache gespeichert.
Zukünftiges Verhalten:Das Element <AusschließenErrorResponse> in der Die Standardeinstellung für die Antwort-Cache-Richtlinie ist „true“. Das bedeutet, dass standardmäßig nur Antworten mit HTTP Die Statuscodes 200 bis 205 werden im Cache gespeichert. Um dieses Verhalten zu überschreiben und Antworten für alle Statuscodes müssen Sie das Element <AusschließenErrorResponse> bis wahr ist.
Aktuelle Problemumgehung : Für Private Cloud 4.15.07.00 und ältere Releases, wenn nur Antworten mit den Statuscodes 200 bis 205 im Cache speichern möchten, müssen Sie den Parameter Element <AusschließenErrorResponse> auf true gesetzt.
Fehlerkorrekturen
Folgende Fehler wurden in diesem Release behoben.
Problem-ID | Beschreibung |
---|---|
OPDK-1521 | Problem bei der Passwortverschlüsselung |
OPDK-1201 | UI-Daten können nicht wiederhergestellt werden |
OPDK-1112 | Benutzerdefinierte LDAP-Passwortrichtlinie wird nicht auf den Apigee-Administrator angewendet Nutzer |
OPDK-1097 | Keyspace-Ausnahme während des OPDK-Upgrades |
OPDK-1068 | Möglichkeit, das Administratorpasswort zu ändern, wenn es während der Installation fehlschlägt |
OPDK-1053 | Zookeeper wird als Root ausgeführt |
OPDK-967 | Wenn OpenLDAP mit set-autostart.sh und all-status.sh automatisch gestartet wird meldet es als inaktiv |
OPDK-905 | Smartdocs prod bereits in der Gruppe axgroup001 registriert |
OPDK-899 | Fehler beim Onboarding |
OPDK-847 | Ein Nutzer, der während des Onboardings erstellt wurde, erhält keine E-Mail zum Zurücksetzen Passwort |
OPDK-817 | init.d-Skripts geben einen Fehler aus |
OPDK-815 | Für das Skript „ax-purge.sh“ müssen Stichprobentabellen dauerhaft gelöscht werden |
MGMT-2246 | Die Seite zum Erstellen eines benutzerdefinierten Berichts wird in der Verwaltung nicht richtig angezeigt Benutzeroberfläche |
MGMT-2235 | Bei ablaufenden SSL-Zertifikaten kann das relative Ablaufdatum verwirrend sein
gerundet Bei ablaufenden SSL-Zertifikaten wird das relative Ablaufdatum immer in Tagen angezeigt. statt auf Monate aufgerundet zu werden, wenn das Zertifikat nach 90 Tagen oder weniger. |
MGMT-2193 | Rotierendes Ladesymbol beim Bearbeiten einer API |
MGMT-2173 | Die Trace UI lässt keine rechtsgültigen URLs zu Über die Trace-UI können Sie jetzt Anfragen mit Abfrageparameterwerten senden, die verschachtelte Suchparametern. |
MGMT-2162 | Problem bei der JavaScript-Kompilierung |
MGMT-2124 | Die Berechtigungen der Rolle „Kunden“ werden zurückgesetzt, wenn die Berechtigungen im Benutzeroberfläche |
MGMT-2114 | Ungültige Syslog-IP-Adresse in der MessageLogging-Richtlinie sollte während der Bereitstellung |
MGMT-2067 | Trace: Wenn die API-Proxy-Version in zwei Umgebungen bereitgestellt wurde, wählen Sie Überarbeitung und nicht ordnungsgemäß funktioniert. |
MGMT-2061 | „Passwort vergessen“ sollte E-Mails nur an registrierte Nutzer senden Die Schaltfläche „Passwort vergessen?“ auf der Anmeldeseite der Verwaltungsbenutzeroberfläche E-Mails nur an registrierte Apigee-Nutzer |
MGMT-2048 | Nutzer mit benutzerdefinierter Rolle, die Bereitstellungsberechtigungen auf eine Umgebung beschränkt, kann bereitstellen in anderen |
MGMT-2041 | FaultRules-Element aus der Standardvorlage für Anhänge entfernen Das FaultRules-Element, das nicht in Richtlinien oder API-Proxy-Schritten verwendet wird, wird nicht mehr automatisch hinzugefügt, wenn Sie API-Proxys erstellen oder Richtlinien hinzufügen. |
MGMT-2034 | Abruf von WSDL gibt Fehler zurück: "Fetch WSDL Error: Error processing" (WSDL-Abruffehler: Fehler bei der Verarbeitung) WSDL“ |
MGMT-1986 | Benutzeroberflächenfehler beim Hinzufügen des Entwicklers |
MGMT-1983 | Wenn Sie eine OAuth 2.0-Autorisierungscode-API abrufen, wird der falsche Status zurückgegeben |
MGMT-1962 | Fehler beim Anmelden in der Verwaltungsoberfläche mit einem starken Passwort Die Anmeldung bei der Benutzeroberfläche mit bestimmten Sonderzeichen wie dem Prozentzeichen wird nicht mehr schlägt fehl. |
MGMT-1947 | Nicht intuitive Rollen in der Verwaltungsoberfläche Wenn ein Nutzer nicht berechtigt ist, eine Richtlinie zur Transaktionsaufzeichnung zu erstellen oder zu bearbeiten, Schaltflächen zum Erstellen und Bearbeiten einer Richtlinie zur Transaktionsaufzeichnung sind jetzt deaktiviert. |
MGMT-1899 | Ressourcenpfade werden nach dem Speichern der Produkteinstellungen gelöscht Beim Bearbeiten eines API-Produkts können die Ressourcenpfade des Produkts gelöscht werden, falls der Nutzer auf die Schaltfläche „Speichern“ doppelgeklickt. Dieses Problem wurde behoben. |
MGMT-1894 | Die Seite „Apps“ wird für den Entwickler nie vollständig geladen Spalte |
MGMT-1882 | Neuer API-Proxy von WSDL zeigt nur Details zum letzten Parameter an |
MGMT-1878 | Wenn in einer Umgebung mehrere Versionen bereitgestellt werden, zeigt Trace nur eine der folgenden |
MGMT-1872 | Benutzerdefinierte Berichte können nicht heruntergeladen werden |
MGMT-1863 | Node.js-Logs in der Verwaltungs-UI nicht sichtbar |
MGMT-1843 | API-Proxy lässt sich nicht öffnen |
MGMT-1833 | Sysadmin-Nutzer sollte nicht die Möglichkeit haben, das Passwort in der Benutzeroberfläche für OPDK |
MGMT-1825 | Fehler beim Cross-Site-Scripting (XSS) |
MGMT-1824 | WSDL-Fehler beim Importieren einer WSDL-Datei mit der Erweiterung „.xml“ abrufen |
MGMT-1812 | TargetEndpoint-Validierung während des Imports hinzufügen Ähnlich wie bei ProxyEndpoint wird der TargetEndpoint auf das richtige Schema geprüft und Ausdrücke, die während des API-Proxy-Imports in den Bedingungen verwendet werden. |
MGMT-1804 | Die Node.js API sendet in einigen Fällen ungültige JSON-Daten Auf dem Bildschirm mit den Node.js-Logs werden unformatierte Protokolle angezeigt, wenn die JSON-Daten ungültig waren Zeichen. In dieser Version wurde das Problem behoben und die Benutzeroberfläche zeigt jetzt ein gut formatiertes node.js an. Logs. |
MGMT-1802 | URL zum Zurücksetzen des Passworts #118 Wenn sich die Verwaltungsoberfläche hinter einem SSL-Terminierungsserver befindet, ist die Verwaltungsoberfläche jetzt korrekt generiert eine E-Mail zum Zurücksetzen des Passworts, die einen Link zu einer HTTPS-URL statt einer HTTP-URL enthält. |
MGMT-1799 | UI-Sicherheitslücke, Sendeanfrage in Trace |
MGMT-1777 | Nutzer mit einer E-Mail-Adresse mit der TLD „.acn“ können nicht hinzugefügt werden |
MGMT-1735 | Branding "Fehler beim Abrufen von W" Wir haben die Unterstützung für benutzerdefiniertes Branding in Edge OPDK mit sofortiger Wirkung entfernt. Während wir dass die wenigen Kunden, die das Tool genutzt haben, davon enttäuscht sind. die die Edge-Funktionen rund um die API-Verwaltung direkt verbessert. |
MGMT-1569 | Problem beim Anhängen des API-Proxys an das vorhandene API-Produkt Problem behoben, durch das ein API-Proxy in der Verwaltungsbenutzeroberfläche an ein API-Produkt angehängt wurde, wenn der API-Proxy Ressource für „/“ Pfad. |
MGMT-1563 | Die Schaltfläche „Senden“ in Trace bleibt deaktiviert, wenn ein Fehler auftritt |
MGMT-1362 | Die E-Mail-Adresse „Passwort vergessen“ funktioniert nicht, wenn die E-Mail-Adresse Folgendes enthält:
'_' Das Problem beim Zurücksetzen des Passworts in OPDK mit E-Mail-Adressen, die einen Unterstrich enthalten, wurde behoben. |
MGMT-1345 | Der Import von WSDL mit mehreren Namespaces führt zu einem falschen Build-SOAP. Schritt |
MGMT-1193 | Durch das Speichern des Proxys als neue Überarbeitung wird die Routingregel unerwartet geändert |
MGMT-1061 | SmartDocs: Beschreibung des Parameters für den Textkörper in der Swagger-Definition wird nicht angezeigt in der Benutzeroberfläche von Dokumenten |
MGMT-800 | Ressource mit dem Namen „default“ wird erstellt beschädigte Benutzeroberfläche |
MGMT-787 | Problem mit der Benutzerfreundlichkeit der Benutzeroberfläche Wenn Sie auf der Verwaltungsoberfläche auf "+ API-Proxy" klicken und das Dialogfeld "Neuer API-Proxy" angezeigt wird, können Sie die Esc-Taste drücken, um das Dialogfeld zu schließen. |
MGMT-619 | Paginierung auf der UI-Seite des API-Proxys aktivieren |
MGMT-602 | API-Proxy-Entwicklungsansicht: Fügen Sie eine Antwort-Cache-Richtlinie hinzu, wenn der Endpunkt keine PreFlow/PostFlow verursacht Fehler. |
MGMT-460 | Die Umbenennung der Richtlinie führt zu fehlerhaften entfernt |
DEVRT-1644 | Suche nach Benachrichtigungen anhand des Namens, wodurch die falsche E-Mail gesendet wird |
DEVRT-1583 | Benutzeroberfläche der Monetarisierung zeigt "Zukunft" Logo für einen aktuellen Tarif |
DEVRT-1546 | Abolimits funktionieren nicht |
DEVRT-1511 | Fehler „mint.resourceDoesNotExist“ für einen vorhandenen Entwickler |
CORERT-639 | TCPSysLogSocket muss asynchron sein |
CORERT-613 | SSL-Handshake-Fehler aufgrund von „ununknown_name“ |
AXAPP-1728 | Monetarisierungsvariablen in Analytics ignorieren |
AXAPP-1708 | Die Analytics API scheint unterschiedliche Zahlen für dieselbe Statistik zu liefern je nachdem, wie ich frage |
AXAPP-1707 | Leistung der kostenlosen Pod-Analyse verbessern |
AXAPP-1690 | „Ungültiger API-Fehler“ zu benutzerdefinierten Berichten |
AXAPP-1533 | „Analytics Geomap“ gibt den Fehler „Ungültiger API-Aufruf“ aus |
AXAPP-1493 | Falsche Cache-Leistungsstatistiken |
APIRT-1436 | Tool/Script zum Hashen nicht gehashter Tokens erstellen |
APIRT-1425 | continueOnError Attribut, wenn auf "true" festgelegt hat keine Auswirkungen in JavaCallout Richtlinie |
APIRT-1346 | OAuth2.0: Ein gehashter Wert wird in der Zugriffstoken-Antwort zurückgegeben, wenn hash.oauth.tokens.enabled ist „true“ |
APIRT-1206 | "target_ip" wird 503 Sekunden lang nicht in der Faktentabelle aufgezeichnet. 504-Fehler |
APIRT-1170 | Fehlende Ressourcendatei hat dazu geführt, dass MP eine Umgebung nicht laden konnte |
APIRT-1148 | GET der Variablen {message.version} in ResponseFlow, für ein Node.js-Ziel wirft NPE |
APIRT-1054 | Das Nachrichten-Logging schlägt fehl, wenn versucht wird, die Protokollierung in einem anderen Verzeichnis als Standardeinstellung |
APIRT-387 | Organisationsservice als „anderen“ im Geschmack machen auf MP |
APIRT-67 | Die Richtlinie „OAuth GenerateAccessToken“ legt die Variable „oauthV2.failed“ nicht fest richtig |
APIRT-52 | Benutzerdefinierte Berichte: Der Antwortstatuscode ist für viele APIs null |
Bekannte Probleme
In dieser Version sind die folgenden bekannten Probleme aufgetreten.
Problem-ID | Beschreibung |
---|---|
OPDK-1586 |
Das API BaaS-Portal startet nicht, wenn IPV6-Unterstützung nicht aktiviert ist
|
OPDK-1785 |
Monetarisierungskomponente auf aktualisiertem Edge installieren
Umgebung
Die Problemumgehung besteht darin, die richtige Monetarisierungsversion in der Datei „apigee-env.sh“ festzulegen.
bevor Sie versuchen, die Monetarisierung zu installieren. So erhältst du die Monetarisierungsversion in Version 4.15.07
(nachdem Sie bereits ein Upgrade auf Edge 4.15.07 durchgeführt haben):
> source /{install-dir}/apigee4/bin/apigee-env.sh > VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`
Standardmäßig hat install-dir den Wert „/opt“.
Der Wert von VER aus dem obigen Beispiel muss in apigee-env.sh festgelegt werden:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
Wenn Sie die Monetarisierung ohne die oben genannten Schritte installiert haben,
schlägt die Installation fehl und es liegt wahrscheinlich ein toter Symlink im Freigabeverzeichnis vor. Du brauchst
um diesen Symlink zu entfernen:
> rm /install-dir/apigee4/share/monetization
Nachdem du den Symlink entfernt hast, gehe wie oben beschrieben vor, um die Monetarisierungsversion festzulegen.
und wiederholen Sie dann die Installation der Monetarisierung.
|
OPDK-1857 |
Hartcodierte Python 2.6-Version in bin/qpid-stat.sh und
bin/qpid-config.sh Unter CentOS und RedHat 7.0: mehrere Skripts in bin/qpid-stat.sh und bin/qpid-config.sh sind hartcodiert für die Verwendung von Python Version 2.6. Sie können dieses Problem umgehen, indem Sie die Zeile ändern, mit der PYTHONPATH nach qpid-stat.sh und qpid-config.sh im Verzeichnis „apigee4/bin“.
Um die Python-Version auf Ihrem System zu ermitteln, überprüfen Sie die Python-Version in der Verzeichnis /opt/apigee4/share/apache-qpid/lib. Das Verzeichnis ist höchstwahrscheinlich python2.7. Anschließend müssen Sie die PYTHONPATH-Einstellungen in qpid-stat.sh und qpid-config.sh mit in den richtigen Pfad. Beispiel:
|
DEVRT-1574 | Inkonsistenter Kontostand und Nutzung für Entwickler mit mehreren aktiven Anteilen
Abos In der Monetarisierung: Wenn ein Entwickler mehr als einen Tarif mit pro API-Aufruf nutzt berechnet, kann die Nutzung des Guthabens manchmal inkonsistent sein. |
APIBAAS-1647 | Nach der Anmeldung als Sys Admin gibt die BaaS-Benutzeroberfläche die Fehlermeldung „Fehler beim Abrufen der Rollen“ aus.
Nachricht Diese Fehlermeldung wird bei der ersten Anmeldung im System durch den Systemadministrator angezeigt, nachdem Upgrade von 4.15.01 auf 4.15.07. Sie können diese Nachricht ignorieren. |
DEVRT-1834 |
Upgrade für Monetarisierung auf Version 4.15.07 Das Skript apigee-upgrade.sh gibt am Ende die folgende Meldung aus, in der Sie aufgefordert werden, ein weiteres Skript ausführen: ************************************** In order to complete the monetization upgrade please run: sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/ 365-create-notification-condition.sh ************************************** Sie können diese Nachricht ignorieren. Dieses Skript ist nicht erforderlich und kann nicht ausgeführt werden. |
DEVRT-1951 |
Neuinstallation der Monetarisierung ohne Benachrichtigungskonfigurationen
Bei einer Neuinstallation von Apigee Edge for Private Cloud Version 4.15.07.00 wird der
die folgenden Konfigurationen für Monetarisierungsbenachrichtigungen fehlen. Diese entsprechen
auf der Seite „Verwaltung“ > Seite „Benachrichtigungen“ auf der Verwaltungsoberfläche
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
So können Sie dieses Problem umgehen: Sie benötigen die IP-Adresse Ihres
Cassandra-Instanz. Sie finden sie in der
<installation-root>/apigee4/conf/cassandra/cassandra.yaml oder
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
DEVRT-1952 |
Monetarisierungs-Upgrade von Version 4.14.07.00 – fehlende Benachrichtigung
Konfigurationen
Bei einem Upgrade von Apigee Edge für Private Cloud von Version 4.14.07.00 auf 4.15.07.00 wird der
fehlen die folgenden Konfigurationen für Monetarisierungsbenachrichtigungen.
nicht richtig funktionieren.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
So können Sie dieses Problem umgehen: Sie benötigen die IP-Adresse Ihres
Cassandra-Instanz. Sie finden sie in der
<installation-root>/apigee4/conf/cassandra/cassandra.yaml oder
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
OPDK-1878 | Der Pod-Name kann nicht bei der Installation mehrerer Rechenzentren festgelegt werden In der Edge-Installationsanleitung wird angegeben, dass die Pod-Namen als "gateway-1" festgelegt werden sollen und "gateway-2" in der Installationsdateien im Hintergrund für die Installation in mehreren Rechenzentren. Durch Umbenennen des Pods verhindert, dass die Router und Message Processor ordnungsgemäß registriert werden und zugänglich zu machen. Dieses Problem verhindert auch, dass das Skript setup-org.sh Suchen Sie verfügbare Message Processor. Sie können das Problem umgehen, indem Sie den Pod-Namen mithilfe der Eigenschaft MP_POD auf „gateway“ setzen. in der Installationsdatei für beide Rechenzentren im Hintergrund. |
OPDK-1886 |
Der Knoten kann nicht auf lokale IP-Adressen wie 192.168.x.y zugreifen.
connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32
Starten Sie dann die Message Processor-Knoten neu:
<install_dir>/apigge4/bin/apigee-service message-processor restart
|
OPDK-1958 | Beim Upgrade benötigen alle Knoten bei der Verwaltung Zugriff auf Port 8080
Server Zur Laufzeit benötigen die folgenden Komponenten Zugriff auf Port 8080 auf dem Verwaltungsserver: Router, Message Processor, UI, Postgres und Qpid. Beim Upgrade werden jedoch alle Knoten erfordern Zugriff auf Port 8080 auf dem Management Server, einschließlich Cassandra und Zookeeper Knoten. |
OPDK-1962 | SSL für die Edge API muss nach dem Upgrade neu konfiguriert werden Wenn Sie die Edge-API vor dem Upgrade auf 4.15.07.00 für die Verwendung von SSL konfiguriert haben, SSL nach dem Upgrade neu konfigurieren müssen. Im Edge-Betriebshandbuch finden Sie die um SSL für die Edge API zu konfigurieren. |