4.17.05 – Versionshinweise zu Edge für Private Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. info

Seit dem letzten Edge for Private Cloud-Feature-Release sind die folgenden Releases erfolgt und in diesem Feature-Release enthalten:

Unter Versionsnummerierung erfahren Sie, wie Sie herausfinden können, ob eine bestimmte Cloud-Version in Ihrer Version von Edge for Private Cloud enthalten ist.

Versionsübersicht

Diese Version enthält eine Reihe wichtiger Funktionen, mit denen Sie Ihre APIs besser steuern und schützen können, darunter:

• Freigegebene Abläufe unterstützen die Bereitstellung ohne Ausfallzeiten.
• Das Löschen von Monetarisierungsdaten für eine Organisation wird jetzt unterstützt.
• Weitere neue Funktionen werden unten beschrieben.

Im Bereich der Einstellung von Funktionen wurden Tresore eingestellt.

Im Rest dieses Themas finden Sie Details zu allen neuen Funktionen, Updates und Fehlerkorrekturen, die in der Version enthalten sind.

Einstellung und Außerbetriebnahme

Die folgenden Funktionen wurden in dieser Version eingestellt oder entfernt. Weitere Informationen finden Sie in der Richtlinie zur Einstellung von Edge.

Eingestellt: Pfade auf dem Tab „API-Proxy-Leistung“ hinzufügen

Bis zu diesem Release konnten Sie in der Verwaltungs-UI zu einem API-Proxy navigieren, den Tab „Leistung“ aufrufen und verschiedene Pfade für einen diagrammbasierten Vergleich auf dem Tab „Leistung“ des Proxys und im Dashboard „Geschäftsvorgänge“ erstellen. Diese Funktion wurde eingestellt und ist nicht mehr in der Benutzeroberfläche verfügbar. Eine Alternative zu dieser Funktion finden Sie im folgenden Apigee-Community-Artikel: Alternative to Business Transactions API. (EDGEUI-902)

Eingestellt: buildInfo-URL für das Entwicklerdienste-Portal

In früheren Versionen des Portals haben Sie die folgende URL in einem Browser geöffnet, um Ihre Portalversion zu ermitteln:

http://yourportal.com/buildInfo

In Version 4.17.05 wurde dieser Link entfernt. Um die Version zu ermitteln, öffnen Sie in Drupal den Menüeintrag Berichte > Statusbericht. Die Portalversion wird in der Tabelle in der Zeile Installationsprofil angezeigt.

Einstellung des sicheren Speichers (Vaults) in Apigee

Der sichere Apigee-Speicher, auch als „Vaults“ bezeichnet, wird eingestellt und ein Jahr nach dem auf der Seite Einstellung und Außerbetriebnahme angegebenen Datum der Einstellung außer Betrieb genommen. Vaults, die verschlüsselten Speicher von Schlüssel/Wert-Paaren bieten, werden mit der Management API erstellt und zur Laufzeit mit Funktionen im Node.js-Modul „apigee-access“ aufgerufen.

Verwenden Sie anstelle des sicheren Speichers verschlüsselte Schlüssel/Wert-Paar-Zuordnungen (Key Value Maps, KVMs), wie unter Mit Schlüssel/Wert-Paar-Zuordnungen arbeiten beschrieben. Verschlüsselte KVMs sind genauso sicher wie Tresore und bieten mehr Optionen für die Erstellung und den Abruf. (MGMT-3848)

Neue Features und Updates

Im Folgenden finden Sie die neuen Funktionen und Verbesserungen in dieser Version. Neben den folgenden Verbesserungen enthält diese Version auch zahlreiche Verbesserungen in Bezug auf Benutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.

Private Cloud

Neuer erforderlicher SMTP-Konfigurationsparameter für die Installation hinzugefügt

Sie müssen jetzt den Parameter SMTPMAILFROM in der Edge-Installationskonfigurationsdatei verwenden. Mit diesem Parameter wird die E‑Mail-Adresse angegeben, die verwendet wird, wenn Edge automatische E‑Mails sendet, z. B. wenn ein Nutzer das Zurücksetzen eines Passworts anfordert. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

(EDGEUI-1020)

Das von der Edge-UI für Edge API-Verwaltungsaufrufe verwendete Zeitlimit kann jetzt festgelegt werden.

Sie können jetzt die API-Zeitüberschreitungsdauer angeben, die von der Edge-Benutzeroberfläche verwendet wird, um zu steuern, wie lange die Benutzeroberfläche auf die Rückgabe eines API-Verwaltungsaufrufs wartet. Die folgenden Attribute definieren das Zeitlimit:

• Mit conf_apigee_apigee.feature.apitimeout wird die Zeit in Sekunden festgelegt, die die Benutzeroberfläche auf die Rückgabe eines Aufrufs an das Backend wartet, unabhängig von der Aktivität. Wenn der Aufruf nicht innerhalb dieses Zeitraums abgeschlossen wird, gibt die Benutzeroberfläche einen Zeitüberschreitungsfehler aus. Der Standardwert beträgt 180 Sekunden (3 Minuten).
• Mit conf_apigee_play.ws.timeout.idle wird festgelegt, wie lange die Benutzeroberfläche in Millisekunden auf Aktivität auf dem Server wartet. Er kann auf denselben Wert wie conf_apigee_apigee_apitimeout oder auf einen niedrigeren Wert festgelegt werden. Wenn Sie einen größeren Wert festlegen, hat das keine Auswirkungen. Der Standardwert ist 180.000 Millisekunden (3 Minuten).
• Mit conf_apigee_play.ws.timeout.connection wird festgelegt, wie lange die Benutzeroberfläche auf den Aufbau einer Verbindung wartet. Er kann auf denselben Wert wie conf_apigee_apigee_apitimeout oder auf einen niedrigeren Wert festgelegt werden. Wenn Sie einen größeren Wert festlegen, hat das keine Auswirkungen. Der Standardwert ist 120.000 Millisekunden (2 Minuten).

Weitere Informationen finden Sie unter Timeout für Edge API-Verwaltungsaufrufe über die Edge-Benutzeroberfläche festlegen.

(EDGEUI-816)

Wiederholungs-Timeout für Message Processor zu Routern hinzugefügt

Es wurde ein Zeitlimit hinzugefügt, damit Router keine Anfragen an Message Processors mehr wiederholen und stattdessen eine Fehlermeldung zurückgeben.

Weitere Informationen finden Sie unter Router so konfigurieren, dass Verbindungen zu einem Message Processor noch einmal versucht werden.

(APIRT-2912)

Verfahren zum Ändern des Standard-Systemadministrators hinzugefügt

Es ist jetzt eine Anleitung zum Ändern des Standard-Systemadministrators verfügbar.

Weitere Informationen finden Sie unter Nutzer, Rollen und Berechtigungen verwalten.

(DOS-4895)

Dokumentation zum Trennen von Edge-Installationsaufgaben zwischen Root- und Nicht-Root-Nutzern hinzugefügt

In der neuen Dokumentation werden die Schritte zum Trennen von Edge-Installationsaufgaben zwischen Root- und Nicht-Root-Nutzern beschrieben.

Weitere Informationen finden Sie unter Edge-Installation – Übersicht.

(DOS-4573)

Property zum Festlegen des Hostnamens für Links in generierten E‑Mails hinzugefügt

Edge sendet automatisch E‑Mails als Reaktion auf bestimmte Ereignisse, z. B. wenn ein Nutzer einer Organisation hinzugefügt wird. Viele dieser E‑Mails enthalten einen Link. Wenn beispielsweise ein neuer Nutzer einer Organisation hinzugefügt wird, sendet die Edge-Benutzeroberfläche dem Nutzer eine E-Mail mit einer Anmelde-URL im folgenden Format:

https://domain/login

Die Domain wird automatisch von Edge ermittelt und ist in der Regel für die Organisation korrekt. Wenn die Edge-UI jedoch hinter einem Load-Balancer steht, kann es sein, dass der automatisch generierte Domainname falsch ist. In diesem Fall können Sie mit der Eigenschaft conf_apigee_apigee.emails.hosturl den Domainnamen-Teil der generierten URL explizit festlegen.

Weitere Informationen finden Sie unter Hostnamen für Links in generierten E‑Mails festlegen.

(EDGEUI-1044)

Basis-URL für einen API-Proxy in der Edge-Benutzeroberfläche festlegen

In der Edge-Benutzeroberfläche wird die URL eines API-Proxys basierend auf den Einstellungen im virtuellen Host angezeigt, in dem der Proxy bereitgestellt wird. Diese Anzeige kann die Router-Portnummer des virtuellen Hosts enthalten.

In den meisten Fällen ist die in der Edge-Benutzeroberfläche angezeigte URL die richtige URL für externe Anfragen an den Proxy. Bei einigen Konfigurationen ist die angezeigte URL jedoch nicht korrekt. Beispielsweise kann eine der folgenden Konfigurationen dazu führen, dass die angezeigte URL nicht der tatsächlichen URL entspricht, die für externe Anfragen an den Proxy verwendet wird:

• SSL-Terminierung an einem Load Balancer
• Die Portzuordnung erfolgt zwischen einem Load Balancer und Apigee-Routern.
• Ein Load Balancer, der mit dem Umschreiben von Pfaden konfiguriert wurde

In Edge for Private Cloud 4.17.05 und höher wird ein Attribut für den virtuellen Host namens <BaseUrl> unterstützt, mit dem Sie die in der Edge-Benutzeroberfläche angezeigte URL überschreiben können. Hier ist ein Beispiel für das virtuelle Hostobjekt mit dem neuen Attribut <BaseURL>. In diesem Beispiel wird der Wert http://myCo.com in der Edge-Benutzeroberfläche angezeigt:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Wenn <BaseUrl> nicht festgelegt ist (Standardeinstellung), wird die von der Edge-Benutzeroberfläche gerenderte Standard-URL als „http://DNS_name_or_IP:9005/“ angezeigt, während die tatsächliche Einrichtung des Host-Alias „http://myCo.com“ lautet.

Sie können die Basis-URL auch beim Erstellen einer Organisation mit dem apigee-provision-Dienstprogramm über die Eigenschaft VHOST_BASEURL festlegen.

Weitere Informationen finden Sie unter TLS-Zugriff auf eine API für die Private Cloud konfigurieren.

(EDGEUI-5008)

Dokumentation zum Aktivieren des Debug-Loggings hinzugefügt

Es wurde eine Dokumentation hinzugefügt, in der beschrieben wird, wie das Debugging-Logging für Edge-Komponenten aktiviert/deaktiviert wird.

Weitere Informationen finden Sie unter Debug-Logging aktivieren.

(APIRT-4018)

Neues Installationsprogramm und neue Befehlssyntax für das apigee-analytics-collector-Dienstprogramm

Alle Edge for Private Cloud-Kunden müssen Apigee Statistiken zum API-Proxy-Traffic über die Betaversion des Befehlszeilentools apigee-analytics-collector senden. Mit diesem Dienstprogramm wird der Bericht zum API-Aufrufvolumen an Apigee zurückgesendet.

Dieser Release von Edge enthält neue Installationsanleitungen und Befehlssyntax für das Dienstprogramm apigee-analytics-collector. In diesem Release wird das apigee-analytics-collector-Dienstprogramm nicht mehr über npm, sondern über apigee-service installiert und über apigee-service anstelle eines eigenständigen Befehls aufgerufen.

Weitere Informationen finden Sie unter API-Traffic-Daten in Apigee hochladen – Betaversion.

Neues Standardinstallationsverzeichnis nach dem Update des Developer Services-Portals von Nginx/Postgres aus einer neuen 4.17.01-Installation

Nach der Aktualisierung einer neuen Installation von 4.17.01, die Nginx/Postgres verwendet, hat sich das Stammverzeichnis geändert von:

/opt/apigee/apigee-drupal

in

/opt/apigee/apigee-drupal/wwwroot

API-Dienste

Strengere Eingabevalidierung für Rechtssubjekte

Für alle Entitäten der Apigee Edge-Organisation wird eine strengere Eingabevalidierung erzwungen. Zulässige Zeichen sind in der Regel Buchstaben (alle Fälle), Ziffern und Unterstriche.

Betroffene Einheiten:

• Organisationen
• Umgebungen
• API-Proxys
• API-Proxy-Überarbeitungen
• Richtliniennamen im API-Proxy
• Konfigurations-IDs für Debug-Trace-Masken
• Ressourcennamen (Java-Callout, XSL, alle Ressourcen)
• Schlüsselspeicher
• CRLstores
• Ressourcenreferenzen
• Zielserver

(MGMT-3840)

Bereitstellung freigegebener Abläufe ohne Ausfallzeiten

Wenn Sie Shared Flows bereitstellen und dafür sorgen möchten, dass während der Bereitstellung wenig oder kein eingehender Traffic abgelehnt wird, können Sie jetzt eine API zur Verwaltung der Bereitstellung ohne Ausfallzeit verwenden. Der Vorgang ist fast identisch mit der Bereitstellung von API-Proxys ohne Ausfallzeiten mit der Management API. Der einzige Unterschied ist die Management-API-Ressource.

Mit dem folgenden Aufruf wird die im URI angegebene Version des freigegebenen Ablaufs bereitgestellt und dann die zuvor bereitgestellte Version zurückgezogen (der Abfrageparameter override=true ermöglicht dies):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monetarisierung

Monetarisierungsdaten für eine Organisation löschen

In den folgenden Fällen kann es sinnvoll sein, Monetarisierungsdaten für Ihre Organisation zu löschen:

• Löschen Sie Ihre Organisation. In diesem Fall müssen Sie die Monetarisierungsdaten löschen, bevor Sie die Organisation löschen können.
• Löschen Sie die Monetarisierungsdaten aus einer Testorganisation, die Sie wiederverwenden möchten. In diesem Fall müssen Sie die Apigee Edge-Daten synchronisieren, nachdem Sie die Monetarisierungsdaten gelöscht haben.

Weitere Informationen finden Sie unter Monetarisierungsdaten aus Ihrer Organisation löschen. (DEVRT-2581)

API zum Aktivieren der Monetarisierung für eine Organisation hinzugefügt

Sie können jetzt eine API verwenden, um die Monetarisierung für eine Organisation zu aktivieren.

Weitere Informationen finden Sie unter Monetarisierung für eine Organisation aktivieren.

(DEVRT-2383)

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben. Diese Liste ist hauptsächlich für Nutzer gedacht, die prüfen möchten, ob ihre Support-Tickets erfolgreich bearbeitet wurden. Sie enthält keine detaillierten Informationen für allgemeine Nutzer.

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (Monetarisierung)

Cloud 17.03.13.01 (Monetarisierung)

Cloud 17.03.13 (API-Verwaltung)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (API-Laufzeit)

Cloud 17.02.13 (API-Verwaltung)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (API-Verwaltung)

Cloud 17.01.16 (Monetarisierung)