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. info

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 le cloud privé. Si vous devez effectuer une mise à jour à partir d'une version antérieure, consultez Appliquer plusieurs versions de correctif.

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

Vous pouvez vérifier si les versions RPM actuellement installées doivent être mises à jour en saisissant :

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 Edge 4.53.00 bootstrap_4.53.00.sh dans /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 et les dépendances Edge 4.53.00 :
```
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. Utilisez la commande source pour exécuter le script apigee-service.sh :
```
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 de mise à jour d'Apigee SSO à partir d'anciennes versions :

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

Étapes de mise à jour d'Apigee SSO à partir d'anciennes versions

Dans Edge pour le cloud privé 4.53.00, les clés et certificats 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 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 d'installation 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 pour 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 d'installation 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 pour 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.
Modifiez le propriétaire du fichier de keystore de sortie en définissant 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 de 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 du 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

Voici 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 pour le cloud privé.

ID du problème	Description
344961470	Correction du portail de gestion QPID pour une faille XSS.

Modifications apportées aux logiciels compatibles

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

Abandon et mise hors service

Aucun abandon ni mise hors service n'ont été effectués dans cette version.

Nouvelles fonctionnalités

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

ID du problème	Description
379125083	Activation de la fonctionnalité d'authentification unique (SSO) dans les environnements RHEL-8 compatibles avec 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 correctif

Cette section explique comment appliquer plusieurs versions de correctif si vous effectuez une mise à jour à partir de une version d'Edge pour le cloud privé antérieure à la version précédente du correctif.

Chaque version de correctif contient des mises à jour de composants spécifiques d'Edge pour le cloud privé, tels que edge-management-server. Pour appliquer plusieurs versions de correctif, vous devez mettre à jour chaque composant Edge inclus dans une version de correctif ultérieure à votre version actuellement installée. Vous pouvez trouver ces composants en consultant les notes de version d'Edge pour le cloud privé pour toutes les versions ultérieures à votre version actuelle et en vérifiant 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 le cloud privé.

Remarque : Vous n'avez besoin de mettre à jour chaque composant qu'une seule fois en installant le RPM pour la dernière version du composant inclus dans les versions de correctif. Suivez les instructions des notes de version pour mettre à jour le composant.

Remarque : La mise à niveau d'un composant installe automatiquement la dernière version de correctif d'un composant. Si vous souhaitez effectuer une mise à niveau vers une version de correctif 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 conserver votre version Edge.