20.04.06 : Notes de version d'Apigee Edge pour le cloud public

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

Aux dates suivantes, nous avons commencé à déployer des mises à jour de composants pour Apigee Edge pour le cloud public :

• Processeur de messages : vendredi 1er mai 2020
• Gestion des API : lundi 20 avril 2020
• Gestion de la monétisation : lundi 20 avril 2020
• Version corrective d'API Management : lundi 22 juin 2020
• Version corrective de Monetization Management : lundi 6 juillet 2020
• Mise à jour de sécurité du serveur de gestion : lundi 24 août 2020
• Version corrective du processeur de messages avec correction de bugs : jeudi 24 septembre 2020
• Version corrective du processeur de messages avec correction de bugs : lundi 26 octobre 2020
• Version corrective du processeur de messages avec correction de bugs : lundi 1er février 2021

Nouvelles fonctionnalités et mises à jour

Vous trouverez ci-dessous les nouvelles fonctionnalités et mises à jour offertes par cette version.

Règles JWT

• Chiffrement JWT

  Les règles JWT vous permettent de générer, de vérifier et de décoder des jetons chiffrés. Voici les nouveaux éléments des règles :

  • <Type> : permet de définir si les jetons sont signés ou chiffrés.
  • <EncryptionAlgorithms> : vous permet de définir les algorithmes de chiffrement <Key> et <Content>.

  (67165581)

• Compatibilité avec les algorithmes PSS dans les jetons signés

  Les règles de génération et de validation des jetons JWT et JWS sont désormais compatibles avec les algorithmes PS256, PS384 et PS512, comme décrit dans la RFC 7518 de l'IETF. (119856499)

• Heure de début relative GenerateJWT pour le jeton

  Lorsque vous générez un jeton JWT avec la règle GenerateJWT, l'élément <NotBefore> vous permet de spécifier un délai relatif entre la génération d'un jeton et sa validité. Par exemple, une valeur <NotBefore> de 2h signifie qu'un jeton n'est valide que deux heures après sa génération. Vous pouvez définir la durée <NotBefore> en millisecondes (ms), secondes (s), minutes (m), heures (h), jours (d) ou semaines (w). (126261970)

• Faire référence à la clé publique/au certificat dans VerifyJWT

  Dans la règle VerifyJWT, un élément <PublicKey>/<Certificate> vous permet de faire référence au certificat au format PEM avec lequel vérifier les signatures JWT entrantes. Exemple :

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

Fonctions des modèles de messages

Voici les nouvelles fonctions de modèle de message disponibles dans cette version :

• firstnonull : renvoie la valeur du premier argument non nul (le plus à gauche). (139698514)
• xpath : vous permet d'appliquer une expression XML Path (XPath) pour analyser les variables XML. (123246424)

Règle AssignMessage : AssignVariable vous permet de faire référence à un modèle de message

Dans la règle AssignMessage, l'élément <AssignVariable> / <Template> autorise un attribut ref, ce qui vous permet d'injecter un modèle prédéfini au moment de l'exécution, qui peut changer sans avoir à modifier la règle. (118396082)

Plusieurs alias de certificat

Lorsque vous configurez TLS et que vous utilisez plusieurs certificats dans un keystore, chacun avec un alias différent, Edge vous permet de référencer des alias de certificat spécifiques dans votre configuration <SSLInfo><KeyAlias>. Pour activer ce nouveau comportement, définissez une nouvelle propriété HTTPClient.choose.alias.by.keyalias sur "true" dans le fichier http.properties des processeurs de messages. Les utilisateurs d'Edge pour le cloud public doivent contacter l' assistance pour ajouter cette propriété. (142141620)

Règle JSONtoXML : omettre la déclaration XML, mettre en retrait la sortie

Deux nouvelles options booléennes dans la règle JSONtoXML vous permettent de mieux contrôler la sortie XML.

• <Options> <OmitXmlDeclaration> : lorsque la valeur est définie sur "true" (la valeur par défaut est "false"), l'élément <OmitXmlDeclaration> omet la déclaration XML <?xml version="1.0" encoding="UTF-8"?> par défaut générée par la règle.

• <Options> <Indent> : lorsque la valeur est définie sur "true" (la valeur par défaut est "false"), l'élément <Indent> indente la sortie XML. Par exemple, au lieu de ce résultat :

  <Array><n>1</n><n>2</n><n>3</n></Array>

  L'élément "Indent" (Retrait) produit le résultat suivant :

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

Réponses pour l'analyse des hôtes virtuels

Si une requête était envoyée à l'adresse IP d'un point de terminaison Apigee (sans hôte virtuel spécifié), Edge renvoyait une réponse HTTP 200 et un document HTML vide à partir de l'hôte virtuel Apigee par défaut associé à cette adresse IP. Pour éviter de donner l'impression erronée qu'une telle réponse pourrait représenter une faille potentielle qui pourrait être exploitée, la connexion est abandonnée et aucune réponse n'est renvoyée. (140005396)

Propriétés du serveur cible dans Trace pour faciliter le dépannage

Les nouvelles propriétés de trace suivantes permettent de résoudre les problèmes de connexion à la cible en indiquant si le HTTPClient du serveur cible a été mis en cache : isHttpClientCached et isFromClientPool. (140574604)

Règle MessageLogging : message Syslog

Dans la règle MessageLogging, un nouvel élément <Syslog> / <PayloadOnly> (booléen) vous permet de déterminer si quelque chose est automatiquement ajouté au <Message> que vous définissez. Si vous définissez <PayloadOnly> sur "true", rien n'est ajouté au début de votre définition de message (quel que soit le paramètre <FormatMessage>). Si cette valeur est définie sur "false" (valeur par défaut), le paramètre <FormatMessage> détermine ce qui est ajouté au début du message de journal. (68722102)

Expiration des règles de cache

Un nouvel élément d'expiration <TimeoutInSeconds> sur les règles ResponseCache et PopulateCache se comporte comme l'élément <TimeoutInSecs> existant était initialement censé fonctionner. Veuillez utiliser le nouvel élément. L'élément <TimeoutInSecs> obsolète existe toujours pour assurer la rétrocompatibilité. Si les éléments <TimeoutInSecs> et <TimeoutInSeconds> sont configurés, Edge utilise <TimeoutInSeconds>. (119172893)

Variable de flux virtualhost.aliases.values

Une nouvelle variable de flux de messages virtualhost.aliases.values en lecture seule renvoie un tableau au format JSON de tous les alias attribués à l'hôte virtuel appelé dans la requête entrante. (128453178)

Nouveau paramètre pour assurer la suppression de la révision du proxy

Un nouveau paramètre de requête force a été ajouté à l'API de suppression de révision de proxy d'API. Dans les cas où la révision est listée dans l'API List API Proxies, mais ne peut pas être interrogée, ce paramètre garantit que la révision du proxy est supprimée. (111691721)

Exemple :

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

Nouvelle variable de flux pour les valeurs d'alias d'hôte virtuel

Une nouvelle variable de flux de messages virtualhost.aliases.values en lecture seule renvoie un tableau au format JSON de tous les alias attribués à l'hôte virtuel appelé dans la requête entrante. (128453178)

Bugs résolus

Les bugs suivants sont résolus dans cette version. Cette liste s'adresse principalement aux utilisateurs qui veulent vérifier si un correctif a été émis en réponse à leurs demandes d'assistance. Elle n'est pas conçue pour fournir des informations détaillées à tous les utilisateurs.