4.52.00.03 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation Apigee Edge.
Accéder à la documentation d'Apigee X
en savoir plus

Le 25 octobre 2023, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Remarque:Cette version sera compatible jusqu'au 25 octobre 2024.

Mettre à jour la procédure

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 la section Appliquer plusieurs versions de correctif.

La mise à jour de cette version mettra à jour les composants de la liste de RPM suivante:

  • 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

Vous pouvez vérifier les versions RPM actuellement installées et déterminer si elles doivent être mises à jour en saisissant la commande suivante:

apigee-all version

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

  1. Sur tous les nœuds périphériques:

    1. Nettoyez les dépôts Yum :
      sudo yum clean all
    2. Téléchargez le dernier fichier bootstrap_4.52.00.sh Edge 4.52.00 dans /tmp/bootstrap_4.52.00.sh :
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Installez l'utilitaire apigee-service et les dépendances Edge 4.52.00 :
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous serez invité à le faire.

    4. Utilisez la commande source pour exécuter le script apigee-service.sh :
      source /etc/profile.d/apigee-service.sh
  2. Sur tous les nœuds périphériques, exécutez le script update.sh pour le processus périphérique :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. Exécutez le script update.sh pour l'authentification unique sur tous les nœuds:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. Sur tous les nœuds de l'interface utilisateur, exécutez le script update.sh correspondant à l'interface utilisateur :
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. Si vous utilisez la nouvelle expérience Edge, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

Problèmes de sécurité résolus

Voici une 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 Private Cloud.
ID du problème Description
279065506 Dans l'URL de redirection pour OAuth2, l'entropie du paramètre "state" a été améliorée pour le rendre imprévisible et éviter la faille CSRF (Cross Site Request Forgery).",
279065586 Ajout de règles de sécurité du contenu dans l'en-tête pour renforcer la sécurité des sites contre les attaques côté client.

Modifications apportées aux logiciels compatibles

Les versions logicielles suivantes sont désormais compatibles:

  • Red Hat Enterprise Linux (Intel 64 bits): version 8.8
  • Oracle Linux (Intel 64 bits): versions 7.9, 8.7 et 8.8
  • Rocky Linux 8
  • Tomcat 9.0.82

Voir Edge pour les logiciels compatibles avec le cloud privé pour une liste complète des logiciels pris en charge.

Abandons et suppressions

Cette version ne contient aucune nouvelle abandon ni suppression.

Nouvelles fonctionnalités

Cette version présente les nouvelles fonctionnalités suivantes:

Définir le nombre maximal de caractères pour les noms d'organisation et d'environnement

Avec cette version, vous pouvez limiter le nombre maximal de caractères dans les noms d'organisation et d'environnement lors de la création d'une organisation ou d'un environnement. La valeur par défaut pour le nombre maximal de caractères est de 255. Pour définir une valeur maximale inférieure, définissez les propriétés suivantes dans leur fichier de propriétés respectif:

  • Dans le fichier de propriétés de l'organisation, définissez org.name.max.length.
  • Dans le fichier de propriétés de l'organisation, définissez env.name.max.length.

Si l'une de ces propriétés est définie sur une valeur inférieure à 0 ou supérieure à 255, le système utilisera une valeur maximale de 1 ou 255, respectivement.

Définir l'expiration des jetons d'accès

Avec cette version, vous pouvez définir l'expiration des jetons d'accès en définissant la propriété conf_keymanagement_oauth_access_token_expiry_time_in_millis sur le délai d'expiration souhaité, en millisecondes. Cette fonctionnalité est désactivée par défaut. Pour l'activer, définissez conf_keymanagement_oauth_access_token_is_apply_limit sur true dans le processeur de messages.

Cette fonctionnalité permet aux administrateurs Apigee de mieux contrôler l'expiration des jetons d'accès créés dans Apigee.

Corrections de bugs

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

ID du problème Description
290242749

Lorsque la variable ServiceCallout.response a été utilisée dans DataMasking, les règles n'étaient pas visibles dans la trace.

Ce problème a été résolu.
260397807

Un problème dans les modèles d'e-mail a empêché l'envoi de caractères à plusieurs octets dans l'e-mail.

Ce problème a été résolu.
234544436

Le menu de gauche disparaissait lors du changement d'organisation dans la nouvelle interface utilisateur Edge.

Ce problème a été résolu.
293268203

Les dépendances d'analyse n'étaient pas mises à niveau automatiquement sur les nœuds du serveur de gestion.

Ce problème a été résolu.
261616264

Ajout d'une vérification d'amorçage pour s'assurer que postgresql n'est pas supprimé pendant le processus de mise à niveau.

279065586

Dans l'URL de redirection pour OAuth2, l'entropie du paramètre "state" a été améliorée pour le rendre imprévisible et éviter la faille CSRF (Cross Site Request Forgery).

283310836

Nous avons amélioré le message d'erreur lors de l'analyse de fichiers XML volumineux.

245936798

Un problème lié aux noms d'organisation et d'environnement entraînait l'échec des requêtes Postgresql <code<create< code="" dir="ltr" translation="no">.</code<create<>

Ce problème a été résolu grâce à une meilleure gestion des conflits de noms d'index postgres pour les noms d'organisation et d'environnement longs.
293733533

La bibliothèque tierce Spring dans les composants Edge Gateway a été mise à jour de la version 5.3.20 à la version 5.3.27.

294363158

En raison d'une régression, certaines dimensions supplémentaires s'affichaient dans les menus déroulants des pages d'analyse et de surveillance de l'interface utilisateur Edge.

Ce problème a été résolu.
297889765

Les artefacts générés par apigee-mirror ont désormais la bonne propriété

Problèmes connus

Consultez Problèmes connus avec Edge pour Private Cloud pour une liste complète des problèmes connus.

Appliquer plusieurs versions de correctif

Cette section explique comment appliquer plusieurs versions de correctif au cas où vous effectuez une mise à jour à partir d'une version d'Edge pour Private Cloud qui est antérieure à la version de correctif précédente.

Chaque version de correctif contient des mises à jour de composants spécifiques de Edge pour Private Cloud, tels que edge-management-server. Pour appliquer plusieurs versions de correctif, vous devez mettre à jour chaque composant Edge inclus dans une version de correctif plus tard que la version actuellement installée. Vous pouvez trouver ces composants en consultant les notes de version d'Edge for Private Cloud 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 Edge for Private Cloud.

Remarque:Vous n'avez besoin de mettre à jour chaque composant qu'une seule fois, en installant le RPM de la dernière version du composant inclus dans les versions de correctif. Suivez les instructions fournies dans les 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. Si vous souhaitez effectuer une mise à niveau vers une version de correctif qui n'est pas la plus récente, vous devez gérer votre propre copie tarball du dépôt Apigee à l'aide du miroir Apigee et l'utiliser pour les installations Apigee. Pour plus d'informations, reportez-vous à la section Utiliser un dépôt Edge local pour gérer votre version Edge.