4.15.07.00 – Versionshinweise für Apigee Edge for Private Cloud

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

Am Dienstag, dem 8. September 2015, haben wir eine wichtige Funktionsversion von Apigee Edge für die Private Cloud veröffentlicht.

Seit dem letzten vierteljährlichen Release von Edge for Private Cloud (4.15.04.00) wurden die folgenden Releases veröffentlicht und sind in diesem vierteljährlichen Release enthalten:

• Cloud: 15.04.15, 15.04.29, 15.05.27, 15.06.10 und 15.06.24
• Private Cloud: 4.15.04.01

Auf welche Edge-Versionen können Sie ein Upgrade durchführen? 4.15.07.00

Je nach aktueller Version von Edge haben Sie folgende Möglichkeiten:

• Direktes Upgrade auf 4.15.07.00
• schrittweises Upgrade, d. h. Sie müssen von Ihrer aktuellen Version auf eine andere Version von Edge und dann auf 4.15.07.00 upgraden.

Weitere Informationen finden Sie unter Auf welche Edge for Private Cloud-Versionen können Sie auf 4.15.07.00 upgraden?

Vor dem Upgrade von Version 4.15.01.x oder einer früheren Version

1. Prüfen Sie die Cassandra-SSTable-Version:
   1. Wechseln Sie zum Verzeichnis /<install-root>/apigee4/data/cassandra/data.
   2. Führen Sie den Befehl „find“ aus:
      > find . -name *-ic-*
      Wenn Sie Cassandra 1 .2 SSTable verwenden, sollten die Ergebnisse eine Reihe von.db-Dateien zurückgeben.
   3. Führen Sie diesen Suchbefehl aus:
      > find . -name *-hf-*
      Die Ergebnisse sollten leer sein, d. h. es gibt keine .db-Dateien im Format hf. Wenn Sie keine Dateien im hf-Format sehen, können Sie mit dem Upgrade auf 4.15.07.00 fortfahren.
      
      Das Format hf ist für SSTables von Cassandra 1.0 vorgesehen. Wenn Sie *.db-Dateien im Format hf haben, müssen Sie die SSTable wie im restlichen Teil dieser Anleitung beschrieben aktualisieren.
2. Wenn Sie *.db-Dateien im Format hf finden, führen Sie ein SSTable-Upgrade durch. Führen Sie dazu den folgenden Befehl auf jedem Cassandra-Knoten aus, bis Sie alle Cassandra-Knoten aktualisiert haben:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. Wiederholen Sie Schritt 1, um zu prüfen, ob alle *.db-Dateien im ic-Format für Cassandra 1.2 sind.
4. Wiederholen Sie die Schritte 1 bis 3 auf jedem Cassandra-Knoten in Ihrer Edge-Installation.
5. Führen Sie ein Upgrade auf Edge 4.15.07.00 durch.
6. Prüfen Sie nach dem Upgrade auf Version 4.15.07.00, ob alle *.db-Dateien auf die C* 2.0-Stable-Version umgestellt wurden:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   Dieser Befehl sollte eine Reihe von .db-Dateien zurückgeben, wenn Sie Cassandra 2.0 verwenden.

Neue Features und Verbesserungen

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt:

Installation und Upgrade

Ausgewählte Komponenten aktualisieren und deinstallieren

Mit den Scripts „apigee-upgrade.sh“ und „apigee-uninstall.sh“ können Sie jetzt die Edge-Komponenten auswählen, die Sie aktualisieren oder deinstallieren möchten. Bisher wurden alle Komponenten auf dem Knoten aktualisiert oder deinstalliert. (OPDK-1377, OPDK-1175)

Rollback des Upgrades

Wenn das Skript „apigee-upgrade.sh“ während eines Upgrades fehlschlägt, können Sie das Upgrade jetzt mit dem Skript „apigee-rollback.sh“ rückgängig machen. Nachdem Sie alle Probleme behoben haben, können Sie das Upgrade noch einmal versuchen. (OPDK-1275)

Gekürzte Optionen für Installationsscripts

Die Installationsscripts unterstützen nicht mehr die lange Form von Optionen wie „–help“. Es werden jetzt nur noch Optionen mit einem Buchstaben akzeptiert, z. B. „-h“. (OPDK-1356)

SmartDocs-Installation

Wenn Sie SmartDocs mit dem Script „setup-smartdocs.sh“ installieren, werden Sie aufgefordert, die Organisation, die Umgebung und den virtuellen Host einzugeben. So wird sichergestellt, dass SmartDocs am erwarteten Speicherort installiert wird. Bisher waren diese Werte im Script hartcodiert. (OPDK-1310)

update-cass-pwd-in-config.sh ohne Aufforderungen ausführen

Das Script „update-cass-pwd-in-config.sh“ kann ohne Aufforderung ausgeführt werden, wenn Sie die Umgebungsvariablen ENABLE_CASS_AUTH, CASS_USERNAME und CASS_PASSWORD festlegen. (OPDK-1309)

Edge-Plattform

Im Folgenden sind die neuen Funktionen der Edge-Plattform aufgeführt, die in dieser Version enthalten sind.

OpenJDK 1.7 wird von Edge Private Cloud unterstützt

Diese Version von Edge unterstützt Oracle JDK 1.7 und OpenJDK 7. Die Unterstützung für JDK 1.6 wurde entfernt. (OPDK-1187)

Betriebssystemunterstützung

Die Betriebssystemunterstützung von Apigee Edge for Private Cloud wurde um Red Hat Enterprise Linux 6.6 und 7.0 (64-Bit), CentOS 6.5, 6.6 und 7.0 (64-Bit) und Oracle Linux 6.5 erweitert.

Cassandra 2.0.15 in OPDK 15.07 enthalten

Mit dieser Version wird Cassandra 2.0.15 installiert. Wenn Sie ein Upgrade auf eine frühere Version ausführen, wird Ihre Cassandra-Version aktualisiert. (OPDK-1197)

SHA2-Unterstützung für das Hashing von OAuth-Tokens

Um OAuth-Tokens im Falle einer Datenbanksicherheitsverletzung besser zu schützen, unterstützt Edge neben SHA1 auch SHA2-Algorithmen zum Hashing von OAuth-Tokens. Mit den neuen Properties auf Organisationsebene können Sie das Hash-Verfahren für neue Tokens aktivieren und konfigurieren sowie die bisherige Hash-Technologie für alle Tokens beibehalten, die vor dieser neuen Funktion vorhanden waren. Bisher wurde in Edge for Private Cloud über das Attribut „hash.oauth.tokens.enabled“ in der Datei „keymanagement.properties“ (auf dem Verwaltungsserver und den Nachrichtenprozessoren) die automatische SHA1-Hash-Technologie für OAuth-Tokens aktiviert. Dieses Attribut wird nicht mehr unterstützt.

Wenn Sie zuvor die Property „hash.oauth.tokens.enabled“ verwendet haben, um die SHA1-Hash-Technologie zu aktivieren, werden die neuen Properties auf Organisationsebene automatisch vom Upgrade-Script für diese Version generiert. Führen Sie nach dem Upgrade als Systemadministrator eine GET-Anfrage mit dieser API aus: https://{host}:{port}/v1/o/{your_org}.

• Informationen zum Aktivieren des Token-Hashings in Ihrer Organisation mit den neuen Properties finden Sie im Abschnitt Zugriffstoken anfordern unter „Token in der Datenbank hashen“.
• Informationen zum Bulk-Hashing vorhandener Tokens finden Sie im Betriebshandbuch für Edge für Private Cloud. (APIRT-1389)

Flache Verzeichnisstruktur für Protokolldateien

Sie können Edge so konfigurieren, dass Protokolldateien in einer flachen Verzeichnisstruktur gespeichert werden. Legen Sie dazu in der Datei „message-logging.properties“ ein neues enable.flat.directory.structure-Attribut auf „wahr“ fest. Weitere Informationen finden Sie in der Richtlinie für Nachrichten-Logging. (APIRT-1394)

Leistung des Umgebungscaches

Für eine bessere Verwaltung und Nutzung des In-Memory-Caches wurde die Einstellung „Maximale Elemente im Arbeitsspeicher“ für Umgebungscache-Ressourcen eingestellt. Die Gesamtzahl der Elemente in allen Cache-Ressourcen (einschließlich des Standardcaches) hängt vom gesamten Arbeitsspeicher ab, der dem Cache zugewiesen ist. Standardmäßig beträgt der für das In-Memory-Caching für einen bestimmten Message Processor zugewiesene Arbeitsspeicher 40% des gesamten verfügbaren Arbeitsspeichers. Dieser Wert wird durch die Cache-Eigenschaftseinstellungen in der Datei „cache.properties“ des Message Processors bestimmt. Elemente werden nur dann aus dem In-Memory-Cache entfernt, wenn nicht genügend Cache-Speicher vorhanden ist oder die Elemente ablaufen.

Wenn Sie zum alten Verhalten zurückkehren und die Eigenschaft „Maximale Elemente im Arbeitsspeicher“ für die Cache-Verwaltung verwenden möchten, legen Sie die Eigenschaft overrideMaxElementsInCacheResource=false in der Datei „cache.properties“ fest. (APIRT-1140)

API-Dienste

Im Folgenden sind die neuen API-Dienstfunktionen aufgeführt, die in dieser Version enthalten sind.

Neuer Proxy-Editor als Standard

Der neue API-Proxy-Editor ist standardmäßig in der Verwaltungsoberfläche aktiviert. Der neue Editor bietet viele Verbesserungen der Nutzerfreundlichkeit, darunter umfassendere Ansichten von bedingten Flusen und Endpunkten auf der Übersichtsseite, die gesamte Konfiguration auf der Seite „Entwickeln“, ein intuitiveres Hinzufügen von bedingten Flusen, Endpunkten und Richtlinien, vollständigere XML-Ansichten anstelle kleiner Snippets sowie eine Suche, bei der Dateinamen und Text gecrawlt werden. (MGMT-2279)

Neue DeleteOAuthV2.0Info-Richtlinie

Mit der neuen Richtlinie „OAuth 2.0-Informationen löschen“ können Sie OAuth 2.0-Zugriffstokens und Autorisierungscodes löschen. Die Richtlinie ersetzt die Funktionen, die zuvor von der Verwaltungs-API bereitgestellt wurden. Weitere Informationen finden Sie unter DeleteOAuth v2-Informationsrichtlinie. (MGMT-2257)

Neue DeleteOAuthV1.0Info-Richtlinie

Mit der neuen Richtlinie „OAuth v1.0-Informationen löschen“ können Sie OAuth v1.0-Anfragetokens, Zugriffstokens und Verifier-Codes löschen. Die Richtlinie ersetzt die Funktionen, die zuvor von der Verwaltungs-API bereitgestellt wurden. Weitere Informationen finden Sie unter Informationsrichtlinie für OAuth V1 löschen. (APIRT-1351)

Richtlinie zur Zugriffssteuerung

Die Zugriffssteuerungsrichtlinie wurde erweitert, um eine detailliertere Auswertung von IP-Adressen für Zulassungs- und Sperrlisten zu ermöglichen, wenn IP-Adressen im X-FORWARDED-FOR-HTTP-Header enthalten sind.

Wenn die Prüfung mehrerer IP-Adressen im Header aktiviert ist (wenden Sie sich an den Support, um die Funktion „feature.enableMultipleXForwardCheckForACL“ festzulegen), können Sie mit dem neuen <ValidateBasedOn>-Element in der Richtlinie die erste, die letzte oder alle IP-Adressen im Header prüfen. Weitere Informationen finden Sie unter Richtlinie zur Zugriffssteuerung.

Neue Entitäten in der Access Entity-Richtlinie

Die Richtlinie für den Zugriff auf Entitäten gewährt Zugriff auf die folgenden neuen Entitäten: consumerkey-scopes, authorizationcode, requesttoken und verifier. Weitere Informationen finden Sie unter AccessEntity-Richtlinie.

Statistics Collector-Richtlinie: Automatische Umwandlung des Statistiknamens in Kleinbuchstaben

Wenn Sie eine benutzerdefinierte Analytics-Sammlung im API-Proxy-Editor erstellen (Seite „Entwickeln“ > „Tools“ > „Benutzerdefinierte Analytics-Sammlung“), muss die Collector-Variable (Statistik) „Name“ in Kleinbuchstaben geschrieben sein. Wenn Sie den Namen in Großbuchstaben eingeben, wandelt das Tool den Statistiknamen in der Statistics Collector-Richtlinie automatisch in Kleinbuchstaben um. (MGMT-740)

Klassische Trace-Funktion im API-Proxy-Editor entfernt

Die neueste Version der Trace-Funktion im API-Proxy-Editor ist nicht mehr als Betaversion verfügbar, sondern allgemein verfügbar. Der Zugriff auf die „klassische Trace“ über den Link „Auf die klassische Version von Trace zugreifen“ ist nicht mehr möglich.

Zugriff auf die Apigee-Community über das Hilfemenü der Verwaltungsoberfläche

Sie können über das Hilfemenü der Verwaltungsoberfläche auf die Apigee-Community zugreifen.

Fehlermeldungen in der Verwaltungsoberfläche

Die Fehlermeldungen in der Verwaltungsoberfläche wurden verbessert:

• Die Verwaltungsoberfläche, auf der alle Fehlermeldungen für die gesamte Anmeldesitzung gruppiert und angezeigt wurden, sofern Sie sie nicht geschlossen haben. Mit diesem Update werden die Fehlermeldungen automatisch gelöscht, wenn Sie die Seite verlassen, auf der sie aufgetreten sind. (MGMT-2254)
• In der Verwaltungsoberfläche werden doppelte Fehlermeldungen nicht mehr unterdrückt. (MGMT-2242)

Leistungs- und Fehlerverbesserungen der Benutzeroberfläche

Es wurden allgemeine Verbesserungen an verschiedenen Bereichen der Verwaltungsoberfläche vorgenommen, darunter an der Leistung der Seitenanzeige und der Bereinigung von Fehlermeldungen.

Rollen-Hyperlinks auf der Seite „Nutzer der Organisation“ in der Verwaltungsoberfläche

Auf der Seite „Nutzer der Organisation“ in der Verwaltungsoberfläche (Verwaltung > Nutzer der Organisation) sind Rollennamen jetzt mit Hyperlinks verknüpft, sodass Sie schnell zu den Seiten mit den Rollen gelangen. (MGMT-1055)

Neue Zielvariablen im Nachrichtenfluss

Neue Variablen in Nachrichtenflüssen liefern vollständigere URL-Informationen für Zielendpunkte und Zielserver:

• TargetEndpoint: request.url ersetzt target.basepath.with.query.
• TargetServer: loadbalancing.targetserver ersetzt targetserver.name. Außerdem wird target.basepath nur dann ausgefüllt, wenn das Element <Path> im Element „HTTPTargetConnection“ <LoadBalancer> des TargetEndpunkts verwendet wird.

Unterstützung für Server Name Indication (SNI)

Edge unterstützt die Verwendung von Server Name Indication in Richtung Süden (vom Nachrichtenprozessor zu Zielendpunkten). 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 über dieselbe IP-Adresse und denselben Port bereitgestellt werden, ohne dass alle diese Ziele dasselbe Zertifikat verwenden müssen.

Es ist keine Edge-spezifische Konfiguration erforderlich. Wenn Ihre Umgebung für southbound SNI konfiguriert ist (Edge-Cloud ist standardmäßig), wird es von Edge unterstützt.

Edge extrahiert automatisch den Hostnamen aus der Anfrage-URL und fügt ihn der SSL-Handshake-Anfrage hinzu. Wenn der Zielhost beispielsweise https://beispiel.de/request/path lautet, fügt Edge die Erweiterung server_name hinzu, wie unten dargestellt:

Weitere Informationen zu SNI finden Sie unter http://en.wikipedia.org/wiki/Server_Name_Indication.

„Signaturalgorithmus“ in den Details zu SSL-Zertifikaten

Den Details zu SSL-Zertifikaten wurde das neue Feld „Signaturalgorithmus“ hinzugefügt. Es ist in der Verwaltungsoberfläche (Verwaltung > SSL-Zertifikate) und in der Verwaltungs-API (Zertifikatsdetails aus einem Schlüsselspeicher oder Truststore abrufen) zu sehen. Das Feld enthält entweder „sha1WithRSAEncryption“ oder „sha256WithRSAEncryption“, je nachdem, welcher Hash-Algorithmus zum Generieren des Zertifikats verwendet wurde.

SSL-Zertifikate anzeigen, die bald ablaufen

Auf der Seite „SSL-Zertifikate“ in der Verwaltungsoberfläche (Verwaltung > SSL-Zertifikate) sehen Sie, wann SSL-Zertifikate innerhalb von 10, 15, 30 oder 90 Tagen ablaufen, je nachdem, was Sie im Drop-down-Feld „Neuer Ablauf“ ausgewählt haben.

Bedrohungsschutzfehlerkonfiguration

Standardmäßig löst Edge bei einem Fehler „HTTP 500 Internal Server Error Statuscode“ und bei einem Fehler „ExecutionFailed“ den Fehler einer JSON- oder XML Threat Protection-Richtlinie aus. Sie können dieses Fehlerverhalten mit einer neuen Property auf Organisationsebene ändern. Wenn Sie das Organisationsattribut features.isPolicyHttpStatusEnabled auf „true“ setzen, geschieht Folgendes:

• Anfrage: Wenn eine Bedrohungsschutzrichtlinie an einen Anfrageablauf angehängt wird, geben ungültige Nachrichten den Statuscode 400 zusammen mit einer entsprechenden Richtlinienfehlermeldung zurück.
• Antwort: Wenn eine Bedrohungsschutzrichtlinie an einen Antwortablauf angehängt wird, wird bei ungültigen Nachrichten weiterhin der Statuscode 500 zurückgegeben und eine der entsprechenden Richtlinienfehlermeldungen wird ausgegeben (statt nur „ExecutionFailed“).

Cloud-Kunden müssen sich an den Apigee-Support wenden, um die Organisationseigenschaft festzulegen. Diese Funktion wird Kunden der Edge Private Cloud mit der nächsten vierteljährlichen Private Cloud-Version zur Verfügung stehen.

Aktualisierte Schemas für Endpunkte, Proxys und andere Entitäten

Die Referenzschemata wurden für nicht richtlinienbezogene Entitäten wie TargetEndpoint, ProxyEndpoint, APIProxy und viele andere aktualisiert. Weitere Informationen finden Sie unter https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)

Entwicklerdienste

Im Folgenden sind die neuen Funktionen der Entwicklerdienste in dieser Version aufgeführt.

Allgemeine Verfügbarkeit von SmartDocs

SmartDocs ist nach dem Abschluss der Betaphase jetzt allgemein verfügbar. Zu den Updates und neuen Funktionen gehören:

• Unterstützung für Swagger 2.0, einschließlich Import per Datei oder URL und Unterstützung für benutzerdefinierte Sicherheitsobjekte.
• Verbesserungen am visuellen Design der Vorlagen, mit denen SmartDocs generiert werden.
• Verbesserungen der Nutzerfreundlichkeit und des Workflows im Entwicklerportal, verfügbar über das Menü „Inhalte“ > „SmartDocs“ in Drupal.
• Die Authentifizierungsmethode „Benutzerdefiniertes Token“ heißt jetzt „API-Schlüssel“.
• „Sicherheits“-Objekte für die Authentifizierung, die auf Ebene der Version definiert sind.
• Konfiguration der Clientauthentifizierung auf Vorlagenebene. Bei neuen Versionen werden keine vorkonfigurierten SmartDocs-Clientanmeldedaten mehr zurückgesetzt.

Weitere Funktionsbeschreibungen finden Sie in diesem Blogpost.

Eine SmartDocs-Dokumentation finden Sie unter APIs mit SmartDocs dokumentieren.

Name der Entwickler-App, der in der Verwaltungsoberfläche angezeigt wird

Entwickler-Apps in Edge haben sowohl einen internen Namen, der sich nicht ändert, als auch einen Anzeigenamen, den Sie ändern können. Auf der Seite „Entwickler-App“ in der Verwaltungsoberfläche (Veröffentlichen > Entwickler-Apps > App-Name) werden der interne Name der App und der Anzeigename angezeigt. So können Sie Apps für die Fehlerbehebung und API-Verwaltung leichter anhand ihrer internen Namen identifizieren.

Analytics-Dienste

Im Folgenden sind die neuen Funktionen der Analytics-Dienste in diesem Release aufgeführt.

Zeitlimit für aufbewahrte Daten

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.

Die klassische Version benutzerdefinierter Berichte wird aus der Verwaltungsoberfläche entfernt

Die optionale klassische Version der benutzerdefinierten Analyseberichte ist in der Verwaltungsoberfläche nicht mehr verfügbar.

Leistung des Widgets „Engagement von Entwicklern“

Das Trichter-Widget im Hauptanalysedashboard (Abschnitt „Engagement von Entwicklern“) wurde optimiert, um die Leistung zu verbessern.

Monetarisierung

Im Folgenden sind die neuen Monetarisierungsfunktionen in dieser Version aufgeführt.

E-Mail-Benachrichtigungen zu Preisplänen

Mit einem neuen E-Mail-Benachrichtigungstyp für Preispläne können Sie Entwickler benachrichtigen, wenn sie ein bestimmtes Transaktions- oder Dollarlimit in den von ihnen gekauften Preisplänen mit Volumenbeschränkung oder Paketpreis erreichen. Weitere Informationen finden Sie unter Benachrichtigungen mithilfe von Benachrichtigungsvorlagen einrichten.

Synchronisierung der Zeiträume für die wiederkehrende Gebühr und die Aggregationsbasis

In einem Preisplan waren möglicherweise zwei unterschiedliche Zeiträume in Kraft:

• Der Zeitraum für wiederkehrende Gebühren, der auf dem Tab „Gebühren“ eines Tarifpakets konfiguriert wurde und festlegte, wann Entwicklern eine wiederkehrende Gebühr in Rechnung gestellt wurde.
• Der auf der Preiskarte für Volumentarife oder Pakete definierte Aggregationszeitraum, anhand dessen festgelegt wird, wann die Nutzung von Paketen für Entwickler zurückgesetzt wird.

Diese beiden Zeiträume sind jetzt synchronisiert. Wenn in einem Preisplan sowohl eine wiederkehrende Gebühr als auch eine Preiskarte für die volumenabhängige Preisgestaltung oder ein Preispaket vorhanden ist, wird der Zeitraum der wiederkehrenden Gebühr für beide verwendet. Wenn beispielsweise eine wiederkehrende monatliche Gebühr besteht, werden auch Preislistenpakete monatlich zurückgesetzt (standardmäßig zu Beginn des Monats).

Wenn keine wiederkehrende Gebühr vorhanden ist, werden Sets basierend auf der auf der Preisliste definierten Aggregationsbasis zurückgesetzt. Wenn ein Entwickler beispielsweise am 19. des Monats mit der Verwendung einer Preisliste beginnt und die Aggregationsbasis „Monatlich“ ist, wird die Nutzung des Sets einen Monat nach dem 19. zurückgesetzt.

Die Aggregationsbasis wird eingestellt und in einer zukünftigen Version aus der Monetarisierung entfernt. Weitere Informationen finden Sie unter Details zum Preisplan angeben.

Benutzerdefinierte Attribute in Berichten zum zusammengefassten Umsatz

Mit Richtlinien zur Transaktionsaufzeichnung können Sie optional benutzerdefinierte Attributdaten aus Transaktionen erfassen. Diese benutzerdefinierten Transaktionsattribute können Sie jetzt in Zusammenfassungsberichte zu Umsätzen aufnehmen. Wenn Sie Ihrer Organisation die Eigenschaft „MINT.SUMMARY_CUSTOM_ATTRIBUTES“ hinzufügen, können Sie angeben, welche benutzerdefinierten Attribute den Datenbanktabellen für die Verwendung in Berichten hinzugefügt werden.

Apigee Edge for Private Cloud-Kunden können das Flag mit dem folgenden API-Aufruf und den Anmeldedaten des Systemadministrators festlegen.

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">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

Das Array der benutzerdefinierten Attribute im API-Aufruf ist URL-codiert.

SmartDocs-Upgrade

Wenn Sie SmartDocs bereits während der Betaphase verwendet haben, müssen Sie SmartDocs in Ihrem Entwicklerportal auf die neue Version aktualisieren, um die neuen Funktionen nutzen zu können.

Alle SmartDocs-Seiten, die bereits in Ihrem Entwicklerportal veröffentlicht wurden, funktionieren weiterhin. Sie müssen jedoch den Aktualisierungsprozess durchlaufen, bevor Sie Änderungen an vorhandenen oder neuen Seiten bearbeiten oder veröffentlichen können.

Sie können SmartDocs zwar in Ihrem Entwicklerportal rendern und veröffentlichen, sie werden aber aus dem API-Modell generiert, das in den Edge API Management Services von Apigee gespeichert ist. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, werden in allen Ihren Pantheon-Umgebungen übernommen (ähnlich wie Entwickler in allen Pantheon-Umgebungen vorhanden sind).

Von der SmartDocs-Betaversion zur allgemeinen Verfügbarkeit wechseln

1. Aktualisieren und testen Sie den Release vom 27. Mai 2015 in Ihrer dev- oder test-Umgebung auf Pantheon.
2. Erstellen Sie ein neues Modell, um ein vorhandenes API-Modell zu ersetzen, das Sie verwendet haben.
   • Wenn Sie Swagger- oder WADL-Dokumente importiert haben, importieren Sie sie noch einmal in eine neue Version.
   • Wenn Sie Ihr API-Modell über das SmartDocs-Modul verwaltet haben, exportieren Sie es als SmartDocs JSON und importieren Sie es über einen Dateianhang in Ihr neues Modell.
3. Legen Sie die Sicherheitseigenschaften der Version Ihres Modells fest. Wählen Sie auf der Seite Inhalte > SmartDocs > Modell die Option Sicherheitseinstellungen aus.
   
4. Prüfen Sie auf der Seite „Modelleinstellungen“ (Inhalte > SmartDocs), ob eine vorkonfigurierte Authentifizierung vorhanden ist. Klicken Sie dazu in der Spalte „Vorgänge“ auf Einstellungen.
   
5. Aktualisieren Sie alle benutzerdefinierten Vorlagen, damit sie Version 6 der CSS- und JS-Assets verwenden. Berücksichtigen Sie dabei auch neue Objektnamen wie „authSchemes“ und „apiSchema“. Informationen zum Aktualisieren von SmartDocs-Vorlagen finden Sie unter APIs mit SmartDocs dokumentieren.
6. Rendern Sie die Modellversion noch einmal und veröffentlichen Sie sie.
7. Nachdem du die neue Dokumentation validiert hast, aktualisiere dein Produktionsportal auf den Release vom 27. Mai 2015.

Wenn Sie Edge Enterprise-Kunde sind und Fragen oder Bedenken zum Upgradeprozess haben, senden Sie bitte eine E-Mail an marsh@apigee.com und cnovak@apigee.com. Andernfalls können Sie sich an die Apigee-Community wenden.

Künftige Funktionsänderungen und -verbesserungen

In diesem Abschnitt erhalten Sie einen Überblick über die geplanten Änderungen und Verbesserungen an Funktionen:

Verhalten der ResponseCache-Richtlinie ändern

In einer zukünftigen Version (noch nicht festgelegt) ändert sich das Standardverhalten des Elements <ExcludeErrorResponse> der Response Cache-Richtlinie.

Aktuelles Verhalten:Das Element <ExcludeErrorResponse> in der ResponseCache-Richtlinie ist standardmäßig auf „false“ (falsch) festgelegt. Das bedeutet, dass Antworten mit jedem möglichen HTTP-Statuscode (einschließlich 3xx) standardmäßig gemäß der ResponseCache-Richtlinie im Cache gespeichert werden.

Zukünftiges Verhalten:Das Element <ExcludeErrorResponse> in der ResponseCache-Richtlinie hat standardmäßig den Wert „wahr“. Das bedeutet, dass standardmäßig nur Antworten mit den HTTP-Statuscodes 200 bis 205 im Cache gespeichert werden. Wenn Sie dieses Verhalten überschreiben und Antworten für alle Statuscodes im Cache speichern möchten, müssen Sie das Element <ExcludeErrorResponse> explizit auf „true“ setzen.

Aktuelle Problemumgehung : Wenn Sie in Private Cloud 4.15.07.00 und älteren Releases nur Antworten mit den Statuscodes 200 bis 205 im Cache speichern möchten, müssen Sie das Element <ExcludeErrorResponse> explizit auf „true“ setzen.

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben.

Bekannte Probleme

Diese Version weist die folgenden bekannten Probleme auf.

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
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 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart