4.52.00.03 – Versionshinweise zu Edge für Private Cloud

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

Am 25. Oktober 2023 haben wir eine neue Version von Apigee Edge for Private Cloud veröffentlicht.

Hinweis:Diese Version wird bis zum 25. Oktober 2024 unterstützt.

Aktualisierungsvorgang

In diesem Abschnitt wird beschrieben, wie Sie dieses Release installieren, wenn Sie ein Update vom vorherigen Release von Edge for Private Cloud durchführen. Wenn Sie ein Update von einer früheren Version ausführen müssen, lesen Sie den Abschnitt Mehrere Patchversionen anwenden.

Wenn Sie dieses Release aktualisieren, werden die Komponenten in der folgenden Liste von RPMs aktualisiert:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

Sie können die aktuell installierten RPM-Versionen prüfen, um festzustellen, ob sie aktualisiert werden müssen, indem Sie Folgendes eingeben:

apigee-all version

Führen Sie die folgenden Schritte auf den Edge-Knoten aus, um Ihre Installation zu aktualisieren:

  1. Auf allen Edge-Knoten:

    1. Yum-Repositories bereinigen:
      sudo yum clean all
    2. Laden Sie die neueste Edge 4.52.00-Datei bootstrap_4.52.00.sh in /tmp/bootstrap_4.52.00.sh herunter:
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Installieren Sie das Edge 4.52.00-apigee-service-Dienstprogramm und die Abhängigkeiten:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      Dabei sind uName und pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, sie einzugeben.

    4. Führen Sie das Skript „apigee-service.sh“ mit dem Befehl source aus:
      source /etc/profile.d/apigee-service.sh
  2. Führen Sie auf allen Edge-Knoten das update.sh-Skript für den Edge-Prozess aus:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. Führen Sie das update.sh-Skript für SSO auf allen Knoten aus:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. Führen Sie auf allen UI-Knoten das update.sh-Skript für die Benutzeroberfläche aus:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. Wenn Sie die neue Edge-Benutzeroberfläche verwenden, führen Sie den folgenden Befehl aus:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

Behobene Sicherheitsprobleme

Im Folgenden finden Sie eine Liste bekannter Sicherheitsprobleme, die in diesem Release behoben wurden. Installieren Sie die aktuelle Version von Edge for Private Cloud, um diese Probleme zu vermeiden.
Problem-ID Beschreibung
279065506 In der Weiterleitungs-URL für OAuth2 wurde die Entropie des Statusparameters verbessert, um ihn unvorhersehbar zu machen und so die Sicherheitslücke „Cross-Site Request Forgery“ (CSRF) zu vermeiden.“
279065586 In den Header wurden Content Security Policies eingefügt, um Websites vor clientseitigen Angriffen zu schützen.

Änderungen an der unterstützten Software

Unterstützung für die folgenden Softwareversionen wurde hinzugefügt:

  • Red Hat Enterprise Linux (Intel 64-Bit): Version 8.8
  • Oracle Linux (Intel 64-Bit): Versionen 7.9, 8.7 und 8.8
  • Rocky Linux 8
  • Tomcat 9.0.82

Eine vollständige Liste der unterstützten Software finden Sie unter Von Edge for Private Cloud unterstützte Software.

Einstellung und Außerbetriebnahme

In dieser Version gibt es keine neuen Einstellungen, die eingestellt werden.

Neue Funktionen

Diese Version enthält die folgenden neuen Funktionen:

Maximale Anzahl von Zeichen für Organisations- und Umgebungsnamen festlegen

Mit dieser Version können Sie die maximale Anzahl von Zeichen für die Namen von Organisationen und Umgebungen beim Erstellen einer neuen Organisation oder Umgebung begrenzen. Der Standardwert für die maximale Anzahl an Zeichen ist 255. Wenn Sie ein niedrigeres Maximum festlegen möchten, legen Sie die folgenden Attribute in der entsprechenden Attributdatei fest:

  • Legen Sie in der Organisationsattributdatei org.name.max.length fest.
  • Legen Sie in der Organisationsattributdatei env.name.max.length fest.

Wenn eine dieser Eigenschaften auf einen Wert kleiner als 0 oder größer als 255 festgelegt ist, verwendet das System einen Maximalwert von 1 bzw. 255.

Ablauf von Zugriffstokens festlegen

Mit dieser Version können Sie das Ablaufdatum von Zugriffstokens festlegen, indem Sie die Property conf_keymanagement_oauth_access_token_expiry_time_in_millis auf die gewünschte Ablaufzeit in Millisekunden setzen. Diese Funktion ist standardmäßig deaktiviert. Um die Funktion zu aktivieren, setzen Sie conf_keymanagement_oauth_access_token_is_apply_limit im Message Processor auf true.

Mit dieser Funktion haben Apigee-Administratoren mehr Kontrolle über den Ablauf von Zugriffstokens, die in Apigee erstellt wurden.

Fehlerkorrekturen

In diesem Abschnitt sind die Fehler in Private Cloud aufgeführt, die in diesem Release behoben wurden.

Problem-ID Beschreibung
290242749

Wenn die Variable ServiceCallout.response in DataMasking verwendet wurde, waren Richtlinien im Trace nicht sichtbar.

Dieses Problem wurde behoben.
260397807

Ein Problem in E‑Mail-Vorlagen hat verhindert, dass Multibyte-Zeichen in E‑Mails gesendet werden.

Dieses Problem wurde behoben.
234544436

In der neuen Edge-Benutzeroberfläche ist ein Problem aufgetreten, bei dem das linke Menü verschwunden ist, wenn die Organisation gewechselt wurde.

Dieses Problem wurde behoben.
293268203

Analytics-Abhängigkeiten wurden auf Verwaltungsserverknoten nicht automatisch aktualisiert.

Dieses Problem wurde behoben.
261616264

Bootstrap-Prüfung hinzugefügt, um sicherzustellen, dass PostgreSQL während des Upgrades nicht entfernt oder gelöscht wird.

279065586

In der Weiterleitungs-URL für OAuth2 wurde die Entropie des Statusparameters verbessert, um ihn unvorhersehbar zu machen und so die Sicherheitslücke „Cross-Site Request Forgery“ (CSRF) zu vermeiden.

283310836

Die Fehlermeldung beim Parsen großer XML-Dateien wurde verbessert.

245936798

Ein Problem mit Organisations- und Umgebungsnamen führte dazu, dass Postgresql-<code<create< code="" dir="ltr" translate="no"> Abfragen fehlschlugen.</code<create<>

Dieses Problem wurde durch eine verbesserte Verarbeitung von Konflikten bei Postgres-Indexnamen für lange Organisations- und Umgebungsnamen behoben.
293733533

Die Spring-Drittanbieterbibliothek in Edge Gateway-Komponenten wurde von Version 5.3.20 auf Version 5.3.27 aktualisiert.

294363158

Aufgrund einer Regression wurden in den Drop-down-Menüs der Analyse- und Überwachungsseiten der Edge-Benutzeroberfläche einige zusätzliche Dimensionen angezeigt.

Dieses Problem wurde behoben.
297889765

Von apigee-mirror generierte Artefakte haben jetzt den richtigen Inhaber.

294989027

Verbesserte Leistung bestimmter Statistik-APIs

Bekannte Probleme

Eine vollständige Liste der bekannten Probleme finden Sie unter Bekannte Probleme mit Edge for Private Cloud.

Mehrere Patchversionen anwenden

In diesem Abschnitt wird beschrieben, wie Sie mehrere Patchversionen anwenden, wenn Sie ein Upgrade von einer Version von Edge for Private Cloud durchführen, die älter als die vorherige Patchversion ist.

Jedes Patch-Release enthält Updates für bestimmte Komponenten von Edge for Private Cloud, z. B. edge-management-server. Wenn Sie mehrere Patchversionen anwenden möchten, müssen Sie jede Edge-Komponente aktualisieren, die in einem Patch-Release enthalten war, das später als Ihre derzeit installierte Version veröffentlicht wurde. Sie finden diese Komponenten, indem Sie sich die Versionshinweise zu Edge for Private Cloud für alle Versionen nach Ihrer aktuellen Version ansehen und die Liste der RPMs für diese Releases prüfen. Unter Apigee-Versionshinweise finden Sie Links zu allen Versionshinweisen zu Edge for Private Cloud.

Hinweis:Sie müssen jede Komponente nur einmal aktualisieren, indem Sie das RPM für die neueste Version der Komponente installieren, die in den Patch-Releases enthalten ist. Folgen Sie der Anleitung in den Versionshinweisen für diese Version, um die Komponente zu aktualisieren.

Hinweis:Beim Aktualisieren einer Komponente wird automatisch die neueste Patch-Version der Komponente installiert. Wenn Sie ein Upgrade auf eine Patch-Version durchführen möchten, die nicht die neueste ist, müssen Sie mit Apigee Mirror eine eigene Tarball-Kopie des Apigee-Repositorys verwalten und diese Kopie für Apigee-Installationen verwenden. Weitere Informationen finden Sie unter Lokales Edge-Repository verwenden, um Ihre Edge-Version beizubehalten.