Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

4.53.00.02 – Versionshinweise zu Edge for Private Cloud

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

Am 19. Dezember 2024 haben wir eine neue Version von Apigee Edge for Private Cloud veröffentlicht.

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 einem früheren Release ausführen müssen, lesen Sie den Abschnitt Mehrere Patch-Versionen anwenden.

Wenn Sie diesen Release aktualisieren, werden die unten aufgeführten Komponenten aktualisiert:

apigee-nginx-1.26.1-el8.x86_64.rpm
apigee-nginx-1.26.1-el9.x86_64.rpm
apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
apigee-sso-4.53.00-0.0.21506.noarch.rpm
apigee-tomcat-9.0.86-0.0.948.noarch.rpm

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

apigee-all version

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

Auf allen Edge-Knoten:
1. Yum-Repositories bereinigen:
```
sudo yum clean all
```
2. Laden Sie die neueste Edge 4.53.00-Datei bootstrap_4.53.00.sh in /tmp/bootstrap_4.53.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
3. Installieren Sie das Edge 4.53.00-apigee-service-Dienstprogramm und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.53.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 apigee-service.sh-Skript mit dem Befehl source aus:
```
source /etc/profile.d/apigee-service.sh
```

Führen Sie das update.sh-Skript auf allen Qpid-Knoten aus:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Folgen Sie auf SSO-Knoten der Anleitung im Abschnitt Schritte zum Aktualisieren von Apigee SSO von älteren Versionen:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
```

Schritte zum Aktualisieren von Apigee SSO von älteren Versionen

In Edge for Private Cloud 4.53.00 werden die in der apigee-sso-Komponente verwendeten IDP-Schlüssel und -Zertifikate jetzt über einen Keystore konfiguriert. Sie müssen den zuvor verwendeten Schlüssel und das Zertifikat in einen Schlüsselspeicher exportieren, ihn konfigurieren und dann wie gewohnt mit der SSO-Aktualisierung fortfahren.

Identifizieren Sie den vorhandenen Schlüssel und das vorhandene Zertifikat, die zum Konfigurieren des IdP verwendet werden:
1. Rufen Sie das Zertifikat ab, indem Sie den Wert von SSO_SAML_SERVICE_PROVIDER_CERTIFICATE in der SSO-Installationskonfigurationsdatei nachschlagen oder die apigee-sso-Komponente nach conf_login_service_provider_certificate abfragen.
  
  Verwenden Sie den folgenden Befehl auf dem SSO-Knoten, um apigee-sso nach dem IDP-Zertifikatspfad zu fragen. Suchen Sie in der Ausgabe nach dem Wert in der letzten Zeile.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. Rufen Sie den Schlüssel ab, indem Sie in der SSO-Installationskonfigurationsdatei nach dem Wert von SSO_SAML_SERVICE_PROVIDER_KEY suchen oder die apigee-sso-Komponente nach conf_login_service_provider_key abfragen.
  
  Verwenden Sie den folgenden Befehl auf dem SSO-Knoten, um apigee-sso nach dem IDP-Schlüsselpfad zu fragen. Suchen Sie in der Ausgabe nach dem Wert in der letzten Zeile.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Exportieren Sie den Schlüssel und das Zertifikat in einen Schlüsselspeicher:
1. Exportieren Sie den Schlüssel und das Zertifikat in einen PKCS12-Schlüsselspeicher:
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Parameter:
  - certificate_path: Pfad zur Zertifikatsdatei, die in Schritt 1a abgerufen wurde.
  - key_path: Pfad zur privaten Schlüsseldatei, die in Schritt 1b abgerufen wurde.
  - keystore_path: Pfad zum neu erstellten Keystore mit dem Zertifikat und dem privaten Schlüssel.
  - alias: Alias für das Schlüssel- und Zertifikatspaar im Keystore.
  Weitere Informationen finden Sie in der OpenSSL-Dokumentation.
2. (Optional) Exportieren Sie den Schlüssel und das Zertifikat aus PKCS12 in einen JKS-Schlüsselspeicher:
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Parameter:
  - PKCS12_keystore_path: Pfad zum in Schritt 2a erstellten PKCS12-Keystore, der das Zertifikat und den Schlüssel enthält.
  - destination_keystore_path: Pfad zum neuen JKS-Keystore, in den das Zertifikat und der Schlüssel exportiert werden.
  - alias: Alias, der für das Schlüssel- und Zertifikatspaar im JKS-Keystore verwendet wird.
Ändern Sie den Inhaber der Ausgabeschlüsselspeicherdatei in den Nutzer „apigee“:
```
sudo chown apigee:apigee <keystore_file>
```

Fügen Sie die folgenden Attribute in der Apigee-SSO-Konfigurationsdatei hinzu und aktualisieren Sie sie mit dem Keystore-Dateipfad, dem Passwort, dem Keystore-Typ und dem Alias:

# Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

Aktualisieren Sie die Apigee SSO-Software auf dem SSO-Knoten wie gewohnt mit dem folgenden Befehl:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Fehlerkorrekturen

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

Problem-ID	Beschreibung
379446933	Das Problem, das verhindert hat, dass `nginx` an Port 443 gebunden wird, wurde behoben.

Behobene Sicherheitsprobleme

Im Folgenden finden Sie eine Liste bekannter Sicherheitsprobleme, die in diesem Release behoben wurden. Installieren Sie die neueste Version von Edge Private Cloud, um diese Probleme zu vermeiden.

Problem-ID	Beschreibung
344961470	Das QPID-Verwaltungsportal wurde gepatcht, um eine XSS-Sicherheitslücke zu schließen.

Änderungen an der unterstützten Software

In diesem Release wird keine neue Software unterstützt.

Einstellung und Außerbetriebnahme

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

Neue Funktionen

In diesem Abschnitt werden die neuen Funktionen in dieser Version aufgeführt.

Problem-ID	Beschreibung
379125083	Die Einmalanmeldung (SSO) wurde in FIPS-fähigen RHEL 8-Umgebungen aktiviert.
379125495	Für SSO werden jetzt Schlüssel und Zertifikate für den IdP im Schlüsselspeicherformat akzeptiert.

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 Update von einer Version von Edge for Private Cloud durchführen, die älter als die vorherige Patch-Release-Version 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 nach Ihrer aktuell installierten Version enthalten war. Sie finden diese Komponenten, indem Sie sich die Versionshinweise zu Edge for Private Cloud für alle Versionen ansehen, die neuer als Ihre aktuelle Version sind, und die Liste der RPMs für diese Releases prüfen. Unter Apigee-Versionshinweise finden Sie Links zu allen Versionshinweisen für 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 erstellen und diese Kopie für Apigee-Installationen verwenden. Weitere Informationen finden Sie unter Lokales Edge-Repository verwenden, um Ihre Edge-Version beizubehalten.