Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

4.53.00.02 : notes de version d'Edge pour le cloud privé

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Le 19 décembre 2024, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Procédure de mise à jour

Cette section explique comment installer cette version si vous effectuez une mise à jour à partir de la version précédente d'Edge pour Private Cloud. Si vous devez effectuer une mise à jour à partir d'une version antérieure, consultez Appliquer plusieurs versions de correctifs.

La mise à jour de cette version mettra à jour les composants listés ci-dessous :

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

Pour vérifier si les versions RPM actuellement installées doivent être mises à jour, saisissez la commande suivante :

apigee-all version

Pour mettre à jour votre installation, procédez comme suit sur les nœuds Edge :

Sur tous les nœuds Edge :
1. Nettoyez les dépôts Yum :
```
sudo yum clean all
```
2. Téléchargez le dernier fichier bootstrap_4.53.00.sh Edge 4.53.00 sur /tmp/bootstrap_4.53.00.sh :
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
3. Installez l'utilitaire apigee-service Edge 4.53.00 et les dépendances :
```
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  où uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.
4. Exécutez le script apigee-service.sh à l'aide de la commande source :
```
source /etc/profile.d/apigee-service.sh
```

Sur tous les nœuds Qpid, exécutez le script update.sh :

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

Sur les nœuds SSO, suivez la procédure détaillée dans la section Étapes à suivre pour mettre à jour Apigee SSO à partir d'anciennes versions :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
```

Procédure de mise à jour d'Apigee SSO à partir d'anciennes versions

Dans Edge for Private Cloud 4.53.00, les clés et certificats de l'IdP utilisés dans le composant apigee-sso sont désormais configurés via un keystore. Vous devrez exporter la clé et le certificat utilisés précédemment dans un keystore, le configurer, puis procéder à la mise à jour du SSO comme d'habitude.

Identifiez la clé et le certificat existants utilisés pour configurer l'IdP :
1. Récupérez le certificat en recherchant la valeur de SSO_SAML_SERVICE_PROVIDER_CERTIFICATE dans le fichier de configuration de l'installation du SSO ou en interrogeant le composant apigee-sso pour conf_login_service_provider_certificate.
  
  Utilisez la commande suivante sur le nœud SSO pour interroger apigee-sso afin d'obtenir le chemin d'accès au certificat IdP. Dans le résultat, recherchez la valeur sur la dernière ligne.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. Récupérez la clé en recherchant la valeur de SSO_SAML_SERVICE_PROVIDER_KEY dans le fichier de configuration de l'installation du SSO ou en interrogeant le composant apigee-sso pour conf_login_service_provider_key.
  
  Utilisez la commande suivante sur le nœud SSO pour interroger apigee-sso afin d'obtenir le chemin d'accès à la clé IdP. Dans le résultat, recherchez la valeur sur la dernière ligne.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Exportez la clé et le certificat vers un keystore :
1. Exportez la clé et le certificat vers un keystore PKCS12 :
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Paramètres :
  - certificate_path : chemin d'accès au fichier de certificat récupéré à l'étape 1.a.
  - key_path : chemin d'accès au fichier de clé privée récupéré à l'étape 1.b.
  - keystore_path : chemin d'accès au keystore nouvellement créé contenant le certificat et la clé privée.
  - alias : alias utilisé pour la paire clé/certificat dans le keystore.
  Pour en savoir plus, consultez la documentation OpenSSL.
2. (Facultatif) Exportez la clé et le certificat de PKCS12 vers un keystore JKS :
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Paramètres :
  - PKCS12_keystore_path : chemin d'accès au keystore PKCS12 créé à l'étape 2.a, contenant le certificat et la clé.
  - destination_keystore_path : chemin d'accès au nouveau keystore JKS dans lequel le certificat et la clé seront exportés.
  - alias : alias utilisé pour la paire clé/certificat dans le keystore JKS.
Remplacez le propriétaire du fichier keystore de sortie par l'utilisateur "apigee" :
```
sudo chown apigee:apigee <keystore_file>
```

Ajoutez les propriétés suivantes dans le fichier de configuration Apigee SSO et mettez-les à jour avec le chemin d'accès au fichier keystore, le mot de passe, le type de keystore et l'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

Mettez à jour le logiciel Apigee SSO sur le nœud SSO comme d'habitude à l'aide de la commande suivante :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Correction de bugs

Cette section liste les bugs liés au cloud privé qui ont été corrigés dans cette version.

ID du problème	Description
379446933	Correction du problème qui empêchait `nginx` de se lier au port 443.

Problèmes de sécurité résolus

Vous trouverez ci-dessous la liste des problèmes de sécurité connus qui ont été résolus dans cette version. Pour éviter ces problèmes, installez la dernière version d'Edge Private Cloud.

ID du problème	Description
344961470	Portail de gestion QPID corrigé pour une faille XSS.

Modifications apportées aux logiciels compatibles

Aucune prise en charge de nouveau logiciel n'a été incluse dans cette version.

Abandons et arrêts

Aucune fonctionnalité n'est abandonnée ni supprimée dans cette version.

Nouvelles fonctionnalités

Cette section liste les nouvelles fonctionnalités de cette version.

ID du problème	Description
379125083	Fonctionnalité d'authentification unique (SSO) activée dans les environnements RHEL-8 compatibles FIPS.
379125495	L'authentification unique accepte désormais les clés et les certificats pour l'IdP au format keystore.

Problèmes connus

Pour obtenir la liste complète des problèmes connus, consultez Problèmes connus avec Edge pour le cloud privé.

Appliquer plusieurs versions de correctifs

Cette section explique comment appliquer plusieurs versions de correctifs si vous effectuez une mise à jour à partir d'une version d'Edge for Private Cloud antérieure à la version de correctif précédente.

Chaque version corrective contient des mises à jour de composants spécifiques d'Edge pour Private Cloud, tels que edge-management-server. Pour appliquer plusieurs versions correctives, vous devez mettre à jour chaque composant Edge inclus dans une version corrective ultérieure à celle actuellement installée. Pour trouver ces composants, consultez les notes de version d'Edge pour le cloud privé pour toutes les versions ultérieures à la vôtre, puis vérifiez la liste des RPM pour ces versions. Consultez les notes de version d'Apigee pour obtenir des liens vers toutes les notes de version d'Edge pour Private Cloud.

Remarque : Il vous suffit de mettre à jour chaque composant une seule fois en installant le fichier RPM de la dernière version du composant inclus dans les versions correctives. Suivez les instructions des notes de version de cette version pour mettre à jour le composant.

Remarque : La mise à niveau d'un composant installe automatiquement la dernière version du correctif d'un composant. Si vous souhaitez passer à une version corrective qui n'est pas la dernière, vous devez conserver votre propre copie tarball du dépôt Apigee à l'aide du miroir Apigee et utiliser ce miroir pour les installations Apigee. Pour en savoir plus, consultez Utiliser un dépôt Edge local pour gérer votre version Edge.