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 Feature-Release von Edge for Private Cloud wurden die folgenden Releases veröffentlicht, die in diesem Feature-Release enthalten sind:

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.
• Die Funktion zum 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 im Release 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: Hinzufügen von Pfaden auf dem Tab „API-Proxy-Leistung“

Bisher 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 Developer Services-Portal

In früheren Versionen des Portals haben Sie die folgende URL in einem Browser geöffnet, um die 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 Datum der Einstellung, das auf der Seite Einstellung und Außerbetriebnahme angegeben ist, 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-Zuordnungen (Key Value Maps, KVMs), wie unter Mit Schlüssel/Wert-Zuordnungen arbeiten beschrieben. Verschlüsselte KVMs sind genauso sicher wie Vaults und bieten mehr Optionen für das Erstellen und Abrufen. (MGMT-3848)

Neue Features und Updates

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt. Zusätzlich zu den folgenden Verbesserungen enthält diese Version auch mehrere 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-Timeout-Dauer 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 Eigenschaften 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 in diesem Zeitraum nicht abgeschlossen ist, 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 kleineren Wert festgelegt werden. Das Festlegen eines höheren Werts hat keine Auswirkungen. Der Standardwert beträgt 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 kleineren Wert festgelegt werden. Das Festlegen eines höheren Werts hat 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)

Zeitlimit für Wiederholungsversuche des Message Processor für Router hinzugefügt

Es wurde ein Zeitlimit hinzugefügt, damit Router keine Anfragen an Message Processors mehr wiederholen und 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 Dokumentation zum Ändern des standardmäßigen 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)

Eigenschaft 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-UI 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-Benutzeroberfläche jedoch hinter einem Load-Balancer liegt, 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)

Festlegen der Basis-URL, die in der Edge-Benutzeroberfläche für einen API-Proxy angezeigt wird

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

In den meisten Fällen ist die in der Edge-UI 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 erfolgt an einem Load-Balancer
• Portzuordnung zwischen einem Load-Balancer und Apigee-Routern
• Ein Load-Balancer, der mit Pfad-Rewriting konfiguriert ist

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 Objekt des virtuellen Hosts 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 ist.

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 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 Dienstprogramm „apigee-analytics-collector“

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 jetzt mit apigee-service anstelle von npm installiert und das apigee-analytics-collector-Dienstprogramm wird über apigee-service anstelle eines eigenständigen Befehls aufgerufen.

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

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

Nach der Aktualisierung einer Neuinstallation 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 Entitäten

Die Eingabevalidierung wurde für alle Entitäten der Apigee Edge-Organisation verschärft. Zulässige Zeichen sind in der Regel Buchstaben (alle Fälle), Ziffern und Unterstriche.

Betroffene Entitäten:

• 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 freigegebene Abläufe 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 Ausfallzeiten verwenden. Das Verfahren 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 (durch den Abfrageparameter override=true) entfernt:

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 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 zum Löschen von Monetarisierungsdaten aus Ihrer Organisation (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-Management)

Cloud 17.01.16 (Monetarisierung)