4.16.01 - Notes de version d'Edge for Private Cloud

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

Le jeudi 24 mars 2016, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Depuis la précédente version trimestrielle d'Edge pour le cloud privé (4.15.07.00), les versions suivantes ont été publiées et sont incluses dans cette version de fonctionnalité :

Consultez À propos de la numérotation des versions pour savoir comment déterminer si une version cloud spécifique est incluse dans votre version d'Edge for Private Cloud.

Abandons

Cloud privé 4.15.07.03

API Description
Vérification de la file d'attente QPID Vous ne pouvez plus utiliser d'API pour vérifier les files d'attente QPID
Vous ne pouvez plus rechercher les files d'attente créées sur le serveur QPID en exécutant les commandes CURL suivantes :
curl http:// <qpid_IP>:8083/v1/servers/self/queues
Cette API est obsolète.

Analytics : vue du tableau de bord des rapports personnalisés pour plusieurs rapports (Cloud 15.09.30)

La fonctionnalité spécifique du tableau de bord des rapports personnalisés qui permet d'afficher jusqu'à quatre rapports personnalisés est abandonnée et sera supprimée dans une prochaine version. (MGMT-2673). Tous les autres aspects des rapports personnalisés resteront disponibles.

Impossible de remplacer la longueur du nom de l'organisation dans un cloud privé

Vous ne pouvez plus remplacer la limite de 20 caractères pour le nom de l'organisation en définissant :

  • APIGEE_ORG_NAME_LENGTH=25
  • APIGEE_ENV_NAME_LENGTH=25

Nouvelles fonctionnalités et améliorations

Voici les nouvelles fonctionnalités et améliorations apportées à cette version. En plus des améliorations suivantes, cette version contient également de nombreuses améliorations en termes d'usabilité, de performances, de sécurité et de stabilité.

Cloud privé

Ajout de la compatibilité avec RedHat, CentOS et Oracle 6.7 à 7.2

Cette version est compatible avec les versions 6.7 à 7.2 de RedHat Enterprise Linux, CentOS et Oracle Linux.

Pour obtenir la liste complète de la configuration système requise, consultez Logiciels et versions compatibles.

Installation basée sur RPM

Cette version d'Edge utilise un mécanisme d'installation basé sur RPM, ce qui simplifie considérablement les procédures d'installation et de migration.

Nouveau répertoire de base

La structure des répertoires pour la version Edge 4.16.01 a été modifiée. Dans les versions précédentes d'Edge, vous installiez Edge dans le répertoire de base :

/<install-dir>/apigee4

install-dir peut se trouver n'importe où, avec une valeur par défaut de /opt. Exemple :

/opt/apigee4

Pour la version 4.16.01, vous devez installer Edge dans le répertoire suivant :

/opt/apigee

Notez également que le répertoire apigee4 a été remplacé par apigee.

L'emplacement de votre répertoire de données n'est pas affecté. Il peut se trouver sous /opt/apigee ou ailleurs.

Nouvelle exigence concernant les hôtes virtuels

Le script de migration Edge gère la plupart des tâches requises pour migrer un routeur Netty existant vers Nginx. Toutefois, lors de la mise à niveau, vous devez également vous assurer que toutes vos définitions d'hôte virtuel incluent un alias d'hôte avant la migration.

Pour savoir comment ajouter un alias d'hôte à un hôte virtuel existant, consultez le Guide d'installation d'Edge, disponible sur le site FTP d'Apigee : ftp://ftp.apigee.com/.

Coder avec la configuration

Dans la version 4.16.01 d'Edge, vous n'utilisez plus les fichiers .properties du répertoire /<install-dir>/apigee4/conf pour configurer les composants Edge. Depuis la version 4.16.01, vous configurez toujours les composants Edge à l'aide de fichiers .properties, mais ils se trouvent désormais dans le répertoire suivant :

/opt/apigee/customer/application

Pour chaque composant Edge installé sur un nœud, un fichier .properties se trouve dans ce répertoire. Pour configurer un composant, modifiez le fichier .properties correspondant afin de modifier la valeur d'une propriété existante ou d'ajouter une propriété et une valeur. Si le fichier n'existe pas déjà, vous pouvez le créer.

Contrairement aux versions précédentes d'Edge, les fichiers .properties pour Edge 4.16.01 ne contiennent pas toutes les propriétés d'un composant. L'une des modifications apportées à cette version est que les fichiers .properties ne contiennent que des remplacements des valeurs de propriété par défaut.

L'avantage de cette architecture est que, lors d'une migration vers une version ultérieure d'Edge, le programme d'installation d'Edge n'écrase jamais les fichiers dans /opt/apigee/customer/application. Cela élimine le risque qu'Edge écrase accidentellement vos paramètres.

Lors d'une migration, le programme d'installation Edge examine vos fichiers .properties existants et copie les modifications apportées aux valeurs de propriété par défaut dans le répertoire /opt/apigee/token. Par conséquent, vous ne devriez pas avoir à apporter de modifications après la migration.

Pour en savoir plus, consultez le Guide des opérations d'Apigee Edge, disponible sur le site FTP d'Apigee : ftp://ftp.apigee.com/.

Les scripts de configuration Edge ont été remplacés

Les scripts de configuration que vous avez utilisés dans les versions précédentes d'Edge ont été supprimés et remplacés par :

  • Commandes que vous exécutez à l'aide des utilitaires Apigee, tels que les utilitaires apigee-service, apigee-all, apigee-setup, apiee-provision ou apigee-migrate.
    Par exemple, les scripts all-start.sh et all-stop.sh ont été remplacés par les commandes suivantes :
    > /opt/apigee/apigee-service/bin/apigee-all start
    > /opt/apigee/apigee-service/bin/apigee-all stop
  • Commandes que vous exécutez directement sur les composants Edge. Par exemple, dans les versions précédentes, vous utilisiez le script chpasswd-openldap.sh pour modifier le mot de passe OpenLDAP. Ce script a été remplacé par la commande suivante, que vous exécutez sur le composant apigee-openldap :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

Consultez le Guide des opérations d'Apigee Edge, disponible sur le site FTP d'Apigee : ftp://ftp.apigee.com/, pour en savoir plus sur la façon dont vous effectuez désormais la configuration à l'aide de commandes.

Nouveau routeur périphérique

Cette version d'Edge pour le cloud privé inclut une nouvelle architecture de routeur basée sur le routeur Nginx. Le routeur Nginx remplace le routeur Netty utilisé dans les versions Edge antérieures à la version 4.16.01.

Les routeurs Nginx ont les mêmes exigences matérielles et de port que le routeur Netty. Aucune modification des nœuds existants n'est donc requise.

Pour en savoir plus, consultez l'annexe A "À propos du routeur Nginx" dans le Guide d'installation d'Edge, disponible sur le site FTP d'Apigee : ftp://ftp.apigee.com/.

Équilibreur de charge BaaS supprimé

L'équilibreur de charge interne a été supprimé du portail API BaaS. Vous devez désormais utiliser votre propre équilibreur de charge entre le portail API BaaS et les trois nœuds de la pile API BaaS.

Au lieu d'un équilibreur de charge, vous pouvez utiliser le round-robin DNS. Dans ce scénario, vous créez une entrée DNS avec plusieurs enregistrements A correspondant aux adresses IP de la pile BaaS. Lors d'une recherche DNS, le serveur DNS renvoie automatiquement les valeurs d'enregistrement A de manière séquentielle.

Nouvelle documentation décrivant comment ajouter des nœuds Cassandra et ZooKeeper, et comment ajouter un centre de données à un centre de données existant

Le fichier ZIP de documentation sur le site FTP Apigee contient désormais "Scaling Edge for Private Cloud" (Mise à l'échelle d'Edge pour le cloud privé), qui décrit comment ajouter des nœuds Cassandra et ZooKeeper, et comment ajouter un centre de données à un centre de données existant.

Outil d'organisation supprimé

L'outil d'organisation peut interroger une installation Edge pour obtenir des informations sur une organisation. Cet outil a été supprimé. Vous utilisez désormais l'interface utilisateur Edge ou les appels d'API pour obtenir des informations sur l'organisation.

Effectuer des tâches dans la version 4.16.01

Le tableau suivant montre comment vous effectuiez les tâches dans la version 4.15.07.03 et comment vous les effectuez désormais dans la version 4.16.01. Pour en savoir plus, consultez le Guide des opérations Edge, disponible sur le site FTP d'Apigee : ftp://ftp.apigee.com/.

Tâche 4.15.07.0x 4.16.01

Répertoire d'installation

/<inst_dir>/apigee4 /opt/apigee

Répertoire des journaux

/<inst_dir>/apigee4/var/log /opt/apigee/var/log/comp

Installer un composant

/<inst_root>/apigee4/share/installer/apigee-setup.sh -p comp -f configFile

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Toutes les commandes de démarrage, d'arrêt, de redémarrage, d'état et de version

/<inst_root>/apigee4/bin/all-start.sh
/<inst_root>/apigee4/bin/all-stop.sh
/<inst_root>/apigee4/bin/all-status.sh
/<inst_root>/apigee4/bin/check.sh

/<inst_root>/apigee/apigee-service/bin/apigee-all start|stop|restart|status|version

Démarrer, arrêter, redémarrer, état, version de la compilation

/<inst_root>/apigee4/bin/apigee-service comp start|stop|restart|status

/<inst_root>/apigee/apigee-service/bin/apigee-service comp start|stop|restart|status|version

Sauvegarde/Restauration

/<inst_root>/apigee4/bin/backup.sh
/<inst_root>/apigee4/bin/restore-comp.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service comp backup

/<inst_root>/apigee/apigee-service/bin/apigee-service comp restore

Tester l'installation

/<inst_root>/apigee4/test/test-sa.sh

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  2. /opt/apigee/apigee-service/bin/apigee-service apigee-validate setup

Intégration

/<inst_root>/apigee4/bin/setup-org.sh

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Ajouter une organisation, un environnement et un hôte virtuel en une seule étape

/<inst_root>/apigee4/bin/setup-org.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Ajouter une organisation

/<inst_root>/apigee4/bin/create-org.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile

Ajouter un environnement

/<inst_root>/apigee4/bin/add-env.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

Ajouter un utilisateur

Appel d'API

Appel d'API ou :

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

Migrer

/<install_root>/apigee4/share/installer/apigee-upgrade.sh -c comp

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-migrate install
  2. /opt/apigee/apigee-migrate/bin/migrate.sh -c cs,zk -f configFile

Version alpha de l'outil et du tableau de bord de surveillance

Cette version inclut une version alpha du nouvel outil et tableau de bord de surveillance pour Edge. Cet outil vous permet de comprendre l'état de différents composants (routeurs, processeurs de messages, ZooKeeper, Cassandra), ainsi que les codes d'erreur HTTP pour différentes organisations et différents environnements de votre déploiement. Vous pouvez également prendre un instantané des données de votre tableau de bord et le partager avec Apigee pour résoudre les incidents d'assistance.

La documentation, y compris les instructions d'installation, est incluse dans le fichier ZIP de la documentation Edge 4.16.01 disponible sur le site FTP d'Apigee : ftp://ftp.apigee.com/.

Toutefois, avant de pouvoir installer et utiliser le tableau de bord, vous devez remplir le contrat d'évaluation Apigee inclus dans le fichier ZIP de la documentation et le renvoyer à Apigee en l'envoyant par e-mail à orders@apigee.com.

Plate-forme Edge

Restylage de l'UI de gestion (Cloud 15.09.30)

L'apparence de plusieurs pages de l'interface utilisateur de gestion a été modifiée. (MGMT-2627)

Services d'API

Assistant de proxy d'API repensé (Cloud 16.01.20)

L'assistant de proxy d'API a été repensé. Lorsque vous cliquez sur "+ Proxy d'API" sur la page "Proxys d'API" de l'interface utilisateur de gestion, le nouvel assistant vous guide tout au long du processus de création de proxy d'API. Tous les paramètres de l'assistant de proxy d'API précédent sont disponibles. (MGMT-1376)

Créer des proxys d'API avec des documents OpenAPI (Swagger) (Cloud 16.01.20)

Dans le cadre de la refonte de l'assistant de création de proxy d'API, vous pouvez désormais créer un proxy d'API à partir d'un document OpenAPI (Swagger). Sur la première page de l'assistant de proxy d'API, cliquez sur Utiliser OpenAPI lorsque vous sélectionnez Proxy inverse, Application Node.js ou Aucune cible. Dans le champ qui s'affiche, saisissez l'URL de votre document OpenAPI. Pour en savoir plus, consultez Créer un proxy d'API simple. (MGMT-1376)

Compatibilité avec WSDL 1.2 pour les proxys SOAP (Cloud 16.01.20)

Apigee Edge est compatible avec WSDL 1.2 pour la création de proxys d'API permettant d'appeler des services SOAP. (MGMT-2835)

Variables SSLInfo dans les configurations TargetEndpoint (Cloud 16.01.20)

Dans un TargetEndpoint de proxy d'API, vous pouvez définir de manière dynamique les détails SSL/TLS pour répondre aux exigences d'exécution flexible. Dans l'exemple suivant, la valeur de SSLInfo est définie dans une configuration TargetEndpoint, les valeurs peuvent être fournies lors de l'exécution par un appel Java, une stratégie JavaScript ou une stratégie Assign Message. Utilisez les variables de message qui contiennent les valeurs que vous souhaitez définir.

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

Cette fonctionnalité est décrite dans les documents suivants :

(APIRT-1475)

Prise en charge de l'algorithme RSA_SHA256 pour les règles d'assertion SAML (Cloud 16.01.20)

Les règles d'assertion SAML sont désormais compatibles avec l'algorithme RSA_SHA256 en plus de RSA_SHA1. (APIRT-1779)

Validation des importations de certificats (Cloud 16.01.20)

Pour éviter l'importation de certificats expirés ou non valides dans les magasins de clés et de certificats de confiance, l'API Management valide les certificats lors de l'importation. Les certificats sont validés pour s'assurer que la taille du fichier ne dépasse pas 50 Ko et que le format est PEM ou DER. L'expiration du certificat est également validée. Pour remplacer la validation de l'expiration par défaut (afin de ne pas valider l'expiration du certificat lors de l'importation), utilisez le paramètre de requête suivant : ?ignoreExpiryValidation=true

Pour en savoir plus, consultez Importer un fichier JAR dans un Keystore et Importer un certificat dans un Truststore. (SECENG-516) et (APIRT-2213)

Actualisation automatique sur la page des journaux Node.js (Cloud 16.01.20)

Lorsque vous consultez les journaux Node.js depuis l'éditeur de proxy, la page "Journaux Node.js" est automatiquement actualisée régulièrement pour lister les nouveaux journaux disponibles. Cliquez sur "Arrêter l'actualisation automatique" pour la désactiver. (MGMT-1692)

En-tête HTTP X-Forwarded-For (Cloud 15.09.30)

Pour renforcer la sécurité, Edge supprime par défaut l'en-tête de requête HTTP X-Forwarded-For qui peut contenir une ou plusieurs adresses IP. Le nouveau comportement par défaut signifie que l'adresse IP du client reçue par Edge sera l'adresse IP reçue lors du dernier handshake TCP externe, et non une adresse qui pourrait potentiellement être usurpée pour contourner la Règle de contrôle des accès.

Pour modifier ce comportement par défaut et autoriser les adresses X-Forwarded-For à accéder à vos proxys d'API, vous devez définir la propriété feature.enableMultipleXForwardCheckForACL=true dans votre organisation.

Accès JavaScript aux propriétés des règles (Cloud 15.07.08)

Lorsque vous utilisez JavaScript dans des flux de proxy d'API, vous pouvez accéder aux propriétés définies dans la règle JavaScript. Cela est particulièrement utile si vous souhaitez utiliser des variables connues dans votre code JavaScript. Par exemple, supposons que votre règle JavaScript contienne la définition de propriété suivante :

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

Dans votre code JavaScript, vous pouvez accéder à la réponse du message en faisant référence à la propriété "source", comme suit :
var source = properties.get('source'); // returns: response.content
ou
var source = properties.source
ou
var source = properties['source']

Pour en savoir plus, consultez la règle JavaScript. (APIRT-1460)

Audits au niveau de l'organisation (Cloud 15.07.08)

Les administrateurs d'entreprise peuvent auditer l'historique des actions effectuées au niveau de l'entreprise. Dans l'interface utilisateur de gestion, sélectionnez Administrateur > Historique de l'organisation. Pour en savoir plus, consultez Audits : historique des API, des produits et de l'organisation. (MGMT-2232)

Suppression d'un administrateur d'organisation de son rôle (Cloud 15.07.08)

Les administrateurs d'organisation peuvent se retirer du rôle d'administrateur d'organisation dans l'interface utilisateur de gestion en accédant à Admin > Utilisateurs de l'organisation et en cliquant sur Supprimer à côté de leur nom. (MGMT-934)

Indicateur de progression de l'importation de groupes de proxys d'API (Cloud 15.07.08)

Lorsque vous importez un grand bundle de proxy d'API dans l'interface utilisateur de gestion, une animation "En cours" s'affiche pour indiquer que l'importation est toujours en cours. Vous ne pouvez donc pas interagir avec l'interface utilisateur de gestion tant que l'importation n'est pas terminée. (MGMT-1285)

Comportement et configuration du cache (Cloud 15.07.22)

Pour une meilleure gestion et utilisation du cache en mémoire, les paramètres "Nombre maximal d'éléments en mémoire" des ressources de cache d'environnement ont été abandonnés à partir de la version Edge Cloud 15.06.10. Dans la version 15.07.22 d'Edge Cloud, ce paramètre a été supprimé de l'interface utilisateur "Créer un cache" dans la section "Configuration de l'environnement" de l'interface utilisateur de gestion Apigee Edge.

Le nombre total d'éléments présents dans toutes les ressources de cache (y compris le cache par défaut) dépend de la mémoire totale allouée au cache. Par défaut, la mémoire totale allouée à la mise en cache en mémoire sur un processeur de messages donné correspond à 40 % de la mémoire totale disponible. Les éléments ne seront évincés du cache en mémoire que lorsque la mémoire cache sera insuffisante ou que les éléments expireront. (MGMT-2413, APIRT-1140)

Configuration du serveur cible dans l'interface utilisateur de gestion (Cloud 15.07.22)

La page "APIs > Environment Configuration" (API > Configuration de l'environnement) de l'UI de gestion vous permet désormais d'ajouter, de modifier et de supprimer des serveurs cibles.

De plus, la page a été repensée pour que les caches puissent également être créés, ajoutés et supprimés en ligne, sans avoir à accéder à une nouvelle page. Plusieurs propriétés de cache, y compris "Nombre maximal d'éléments en mémoire", ne sont plus disponibles dans l'interface utilisateur, car leur définition n'a plus aucun effet sur le comportement du cache d'exécution. (MGMT-280)

SSL avec journalisation des messages dans syslog (Cloud 15.07.22)

La règle MessageLogging permet d'envoyer des messages syslog à des fournisseurs de gestion de journaux tiers via SSL/TLS. Utilisez ce qui suit dans la configuration de la règle en tant qu'enfant direct de l'élément parent :

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

Pour en savoir plus, consultez la Règle MessageLogging. (APIRT-942)

Interface utilisateur de gestion (Cloud 15.07.22)

L'équipe d'ingénierie Apigee a corrigé divers bugs mineurs et amélioré la facilité d'utilisation de l'interface utilisateur de gestion.

cURL dans Trace (Cloud 15.09.02)

Lorsque vous tracez un appel de proxy d'API qui envoie une requête à un serveur cible, vous pouvez afficher la requête adressée au serveur cible sous la forme d'une commande cURL. Sélectionnez l'étape "Requête envoyée au serveur cible" dans le diagramme de la carte des transactions, puis cliquez sur le bouton "Afficher Curl" dans la colonne "Requête envoyée au serveur cible" du volet "Détails de la phase". (MGMT-2589)

Caractères spéciaux pour le masquage des données (Cloud 15.09.02)

Lorsque vous utilisez le masquage de données pour masquer des données sensibles dans des charges utiles JSON, les caractères spéciaux tels que $, *, et { peuvent désormais être masqués. (APIRT-1727)

Mappages clé-valeur dans l'interface utilisateur de gestion (Cloud 15.09.30)

Vous pouvez désormais créer et gérer des mappages clé-valeur (KVM) au niveau de l'environnement dans l'interface utilisateur de gestion Edge. Les KVM à portée d'environnement contiennent des paires clé/valeur accessibles par n'importe quel proxy d'API dans un environnement, tel que "test" ou "prod". Dans le menu de l'interface utilisateur de gestion, accédez à API > Configuration de l'environnement > sélectionnez l'environnement de votre choix > onglet "Mappages clé-valeur". Pour en savoir plus, consultez Créer et modifier des mappages clé-valeur d'environnement. (MGMT-1393)

Expiration par défaut de la règle PopulateCache dans l'interface utilisateur de gestion (Cloud 15.09.30)

Lorsque vous ajoutez une règle PopulateCache avec l'éditeur de proxy d'API, l'élément <TimeoutInSec> pour l'expiration du cache est prérempli avec une valeur de 3 600 secondes (1 heure). La valeur par défaut précédente était de 300 secondes (5 minutes). (MGMT-2622)

Services pour les développeurs

Performances de la page du produit d'API, aucune application de développeur listée (Cloud 16.01.20)

Lorsque vous affichez un produit d'API dans l'interface utilisateur de gestion, les applications de développeur associées à ce produit sont listées. Pour améliorer les performances de l'UI, la liste des applications de développeur ne s'affiche pas lorsque vous modifiez le produit d'API. (MGMT-2869)

Colonne "Clé" sur la page "Applications de développeur" (Cloud 15.08.05)

Dans les organisations qui comptent un grand nombre d'applications de développeur (plusieurs milliers), l'affichage de la colonne "Clé" sur la page "Applications de développeur" (qui indique le nombre de clés par application) peut nuire aux performances d'affichage. Pour améliorer les performances d'affichage dans cette situation, contactez l'assistance Apigee afin de définir la propriété suivante au niveau de l'organisation : features.appsNoCredentialsEnabled = true. Cette propriété supprime la colonne "Clé". Toutefois, notez que si vous supprimez la colonne "Clé", vous ne pourrez plus effectuer de recherche par clé client et secret client. (MGMT-2486)

Indicateur de progression sur la page "Informations sur le développeur" (Cloud 15.09.30)

Lorsque la page "Informations sur le développeur" est chargée dans l'interface utilisateur de gestion, la section "Applications" de la page affiche une icône de progression si les applications sont toujours en cours de chargement. Cela améliore le comportement précédent, où la section "Applications" apparaissait vide lors du chargement des applications. (MGMT-2667)

Monétisation

Modifier les noms de packages d'API (Cloud 16.01.20)

Vous pouvez modifier le nom d'un package d'API à tout moment au cours du cycle de vie de la monétisation, même lorsque le package d'API contient un plan tarifaire publié. (DEVRT-2177)

Décimales autorisées dans les attributs personnalisés (Cloud 16.01.20)

Lorsque vous utilisez un forfait "Tarif avec attribut personnalisé", l'attribut personnalisé dans l'en-tête du message qui sert de multiplicateur pour la transaction peut désormais être une valeur décimale comportant jusqu'à quatre décimales. Pour en savoir plus sur ce type de forfait, consultez Spécifier les détails de l'attribut personnalisé de la fiche tarifaire (DEVRT-2191).

Nom et ID du forfait dans les rapports récapitulatifs (Cloud 15.09.02)

Lorsque vous générez un rapport récapitulatif sur les revenus avec l'API Management, vous pouvez ajouter les colonnes "Nom du forfait" et "ID du forfait" au rapport. Pour ce faire, ajoutez "RATEPLAN" en tant qu'attribut groupBy dans l'appel d'API, comme décrit dans Créer des rapports. (Notez que cette fonctionnalité n'est pas encore disponible dans l'interface utilisateur du rapport sur la monétisation.) Dans les rapports détaillés, les colonnes existantes "Nom du forfait" et "ID du forfait" se trouvent désormais au début du rapport, avec les autres colonnes de regroupement. (DEVRT-1740)

Services d'analyse

Fonction sum( ) sur les métriques de temps de réponse (Cloud 16.01.20)

Dans les rapports personnalisés Analytics et les appels d'API, la fonction d'agrégation "sum" est désormais disponible pour les champs "Temps de réponse cible", "Temps de réponse total" et "end_point_response_time". Par exemple, dans l'API /stats (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0), vous pouvez désormais utiliser le paramètre de requête "select" suivant : ?select=sum(total_response_time). (AXAPP-2006)

Rapport "Analyse de la latence" : noms des proxys d'API triés (Cloud 16.01.20)

Dans l'interface utilisateur du rapport "Analyse de la latence" (plans Apigee Edge Enterprise uniquement), les proxys d'API sont listés par ordre alphabétique dans la liste déroulante "Proxy". (MGMT-2858)

Applications pour les développeurs affichées dans le tableau de bord par nom à afficher (Cloud 16.01.20)

Dans le tableau de bord de l'interface utilisateur de gestion, le graphique à barres "Applications de développeur" liste les applications de développeur par nom à afficher plutôt que par nom interne. (MGMT-2853)

Nouveau widget de date/heure dans les rapports personnalisés (Cloud 16.01.20)

Le widget de sélection de la date et de l'heure sur la page des rapports personnalisés de l'interface utilisateur de gestion a été amélioré. (MGMT-2881)

Afficher le détail des villes dans la carte géographique (Cloud 15.07.22)

La carte géographique Analytics inclut un détail des villes pour le Canada et les États-Unis. Lorsque vous cliquez sur un État ou une province sur la carte, une liste des villes d'où proviennent les appels s'affiche. (MGMT-2282)

Caractères | (barre verticale) et = dans les rapports personnalisés Analytics (Cloud 15.09.02)

Les définitions de rapports personnalisés Analytics acceptent les symboles | (barre verticale) et =. Avant cela, l'encodage %7C et %3D devait être utilisé pour ces symboles. (MGMT-2504)

Dimension "Suffixe du chemin de proxy" (Cloud 15.09.30)

Une nouvelle dimension "Suffixe du chemin de proxy" (proxy_pathsuffix) est disponible dans les rapports personnalisés Analytics et les appels d'API. Le suffixe du chemin de proxy est la partie d'une URL de proxy d'API qui suit le chemin de base, comme le chemin créé pour les flux conditionnels. (AXAPP-1902)

Les rapports affichent les ID de développeur et non les noms à afficher (Cloud 15.09.30)

Lorsque vous effectuez des appels d'API Edge Analytics avec l'API /stats qui renvoie des développeurs, le nom à afficher du développeur est renvoyé avec l'ID du développeur. Auparavant, seul l'ID de développeur était renvoyé. (AXAPP-1759)

Bugs résolus

Les bugs suivants sont résolus dans cette version.

Private Cloud 4.16.01

Le tableau suivant répertorie les bugs corrigés depuis la version 4.16.01 d'Edge pour le cloud privé. Pour obtenir ces correctifs, suivez les instructions permettant de mettre à jour votre installation 4.16.01 vers les derniers RPM et fichiers d'assistance, comme décrit dans Mettre à jour Apigee Edge 4.16.01.x vers la dernière version 4.16.01.

ID du problème Description Numéro de build
PRC-736

apigee-lib ne nécessite plus GCC

apigee-lib-4.16.01-0.0.901
PRC-735

apigee-validate n'échoue plus, car l'API Yahoo Weather nécessite OAuth.

apigee-validate-4.16.01-0.0.910
PRC-739

Autoriser les utilisateurs à extraire le miroir dans n'importe quel dossier du système de fichiers

apigee-mirror-4.16.01-0.0.904
PRC-756

BaaS Usergrid check_cassandra_availability.sh n'utilise plus la commande nc

baas-usergrid-2.1.0-0.0.112
PRC-778

Les informations sur le cluster Zookeeper ne sont plus perdues après la mise à niveau

apigee-migrate-4.16.01-0.0.873
PRC-787

L'API BaaS est désormais compatible avec l'authentification Cassandra

baas-usergrid-2.1.1-0.0.122
PRC-804

Vous pouvez désormais spécifier l'emplacement des fichiers journaux.

apigee-service-4.16.05-0.0.435
PRC-840

Liens symboliques rompus pour les composants Edge

edge-gateway-4.16.01-0.0.538

EDGEUI-538
EDGEUI-524

Génération de proxy SOAP bloquée lors de l'importation de WSDL/ Problème de génération d'un proxy d'API à partir d'un WSDL

edge-ui-4.16.01-0.0.3650
EDGEUI-543

L'option "Impossible d'importer le WSDL à partir d'une URL" s'affiche lorsque l'URL est une adresse locale

edge-ui-4.16.01-0.0.3650
APIRT-2719
APIRT-2918

target.url est désormais défini lors de la création d'encadrés cibles

edge-gateway-4.16.01-0.0.538

Cloud 16.01.20

ID du problème Description
MGMT-2964 Le nouvel éditeur de proxy n'accepte pas les commentaires dans la balise "Flows"
MGMT-2957 L'ajout d'un pod à une organisation renvoie l'état de déploiement du bundle comme erreur pour les routeurs du nouveau pod.
MGMT-2937 Erreurs "Autorisations insuffisantes" avec les rôles personnalisés
MGMT-2875 La génération WSDL SOAP comporte des en-têtes incorrects pour SOAP 1.2
MGMT-2739 Le graphique des anomalies ne s'affiche pas dans l'onglet "Analytics" du rapport "Applications pour les développeurs"
MGMT-2735 L'actualisation des journaux Node.js ne se termine/s'arrête jamais
MGMT-2734 Le bouton "Enregistrer" ne s'active pas après une erreur lors de l'enregistrement d'un bundle déployé.
MGMT-2729 La mise à jour du port pour TargetServer dans l'UI efface SSLInfo
MGMT-2702 Faille de sécurité intersites pour Firefox et IE
Correction d'une faille de sécurité qui pouvait se produire en raison de failles Firefox et IE qui autorisent de manière incorrecte les requêtes intersites.
MGMT-2681 Éditeur de proxy : lorsque vous utilisez une correspondance d'expression régulière dans la condition, le navigateur de flux n'affiche pas le verbe.
MGMT-2361 Le déploiement des proxys échoue avec l'exception RPCException : délai avant expiration de l'appel
MGMT-1662 Échec du déploiement du proxy d'API lors des versions Apigee Public Cloud
DEVRT-2286 L'API Monetization sync-organization ne fonctionne pas
L'API utilisée pour synchroniser les données Apigee Edge avec la monétisation a été corrigée lors de la dernière actualisation de la version 16.01.20.
DEVRT-2173 Vous devez renommer le forfait, mais vous ne pouvez pas le modifier en raison d'un plan tarifaire actif.
DEVRT-1661 Le développeur est bloqué pour avoir effectué des requêtes API avant la date de début du forfait, mais le blocage n'est jamais levé
Si un développeur d'API a accepté un forfait mensuel à prix fixe, à volume échelonné ou groupé qui commence à une date ultérieure, puis envoie des requêtes API avant la date de début spécifiée, il est bloqué et ne peut plus envoyer de requêtes. Une fois la date de début du forfait atteinte, le bloc est levé.
DEVRT-1643 Plan tarifaire brouillon corrompu après son enregistrement
AXAPP-1991 La désactivation du résumé et des e-mails Apigee Analytics ne fonctionne pas
AXAPP-1946 Le nettoyage Analytics ne libère pas d'espace disque
AXAPP-1708 L'API Analytics semble générer des chiffres différents pour la même statistique selon la façon dont je pose la question
AXAPP-1293 Noms d'applications de développeur inexistants dans l'e-mail récapitulatif Analytics
APIRT-2518 Problèmes de connexion au backend HTTPS avec la règle JavaScript
APIRT-2398 Code d'autorisation non valide/expiré comptabilisé comme une erreur Apigee
APIRT-2397 steps.assignmessage.SetVariableFailed comptabilisé comme une erreur Apigee
APIRT-2396 IllegalArgumentException, ArrayIndexOutofBoundsException dans OAuth comptabilisé comme erreur Apigee
APIRT-2362 Erreur de compilation JavaScript
APIRT-2322 ID client non valide signalé à tort comme erreur Apigee
APIRT-2159 Ajouter message_id au préfixe de journalisation
APIRT-2145 Taux d'échec élevé des transactions pour l'API Facebook
La validation des valeurs d'en-tête commençant par ":" a été supprimée.
APIRT-2137 MP : Encodage par transfert segmenté et 205 avec une longueur de contenu de 0
APIRT-2124 Le routeur Nginx ne met pas à jour le pool de MP pour les MP nouvellement ajoutés
APIRT-2117 La règle MessageLogging ne respecte pas les mises à jour DNS
APIRT-2110 Le routeur ne transmet qu'un seul en-tête X-Forwarded-For.
APIRT-2062 Le cache de réponse ne fonctionne pas correctement lorsque la condition SkipCacheLookup est remplie
APIRT-2061 Le processeur de messages n'envoie pas de messages à QPID
APIRT-2052 Nombre élevé d'états CLOSE_WAIT, car le port de gestion ne répond pas
APIRT-2024 Nginx sans équilibreur de charge ne remplit pas correctement les en-têtes HTTP X-Forwarded-For.
Avis de suppression de X-Forwarded-For ajouté aux notes de version 150930 et à la règle de contrôle des accès.
APIRT-1933 Les chargeurs de classe spécifiques au proxy délèguent toujours au chargeur de classe MP
APIRT-1877 Impossible de masquer les réponses XML comportant des espaces de noms
APIRT-1838 Apigee-127 : VerifyAPIKey ne renvoie qu'un seul produit d'API lorsque plusieurs produits existent
APIRT-1827 Limite de streaming simultané faible observée
APIRT-1820 Latence intermittente (> 1 %) dans l'environnement Private Cloud 4.15.04
APIRT-707 NPE lors de l'exécution si l'élément <GenerateResponse> se trouve dans la stratégie VerifyAccessToken

Cloud 15.07.08

ID du problème Description
MGMT-2381 Impossible de déployer des proxys à l'aide du nouvel éditeur de proxy
MGMT-2374 L'espace dans l'élément BasePath doit être supprimé avant d'enregistrer le ProxyEndpoint.
MGMT-2355 L'UI ne calcule pas correctement les autorisations pour plusieurs rôles si l'un d'eux est un rôle d'administrateur de l'organisation
MGMT-2324 L'importation d'un modèle Swagger produit des nœuds SmartDocs incorrects
MGMT-1518 L'UI indique que le proxy est déployé, même si le déploiement a échoué sur les MP
MGMT-1489 Le produit API ne génère pas les ressources appropriées
DOC-1246 Déclaration contradictoire dans la documentation concernant les jetons d'accès
DEVRT-1661

La valeur de NextRecurringFeeDate est vide lorsque le développeur accepte un forfait avec des tarifs spécifiques aux fonctionnalités
Si un développeur a accepté un forfait mensuel à tarif fixe, à tarifs par volume ou groupé qui commence à une date ultérieure, a effectué quelques appels d'API sur le forfait avant la date de début, puis a été bloqué pour effectuer des appels (comportement attendu), le développeur n'a pas été automatiquement débloqué lorsque le forfait est entré en vigueur. Ce problème a été résolu.

Cloud 15.07.22

ID du problème Description
TBD-73 Adresse IP statique pour le trafic entrant vers Apigee
MGMT-2422 Impossible de modifier l'application de l'entreprise
MGMT-2419 Un utilisateur appartenant au rôle "Utilisateur" reçoit des erreurs d'autorisation lors de la connexion
MGMT-2341 Le filtre de rapport personnalisé crée une requête incorrecte
MGMT-2207 JSONThreatProtection : ArrayElementCount ne fonctionne pas si l'élément contenu n'est pas primitif
Dans la règle JSON Threat Protection, l'élément ArrayElementCount ne limitait pas précisément le nombre d'éléments autorisés dans les tableaux. Ce problème a été résolu.
MGMT-2158 Impossible d'importer le WSDL si la sortie fait référence à une partie sans type

Cloud 15.08.05

ID du problème Description
plusieurs Plusieurs petits bugs ont été corrigés dans l'éditeur de proxys d'API.

Cloud 15.09.02

ID du problème Description
plusieurs Plusieurs petits bugs ont été corrigés dans l'éditeur de proxys d'API.
MGMT-2618 Problèmes de déploiement fréquents
MGMT-2588 La page de l'historique des développeurs exécute du code HTML/du code – Persistance de la faille XSS
MGMT-2543 Le nouvel éditeur de proxy modifie le code XML dans <Payload> de la règle AssignMessage, ce qui endommage les proxys d'API existants
MGMT-2521 Les sessions Trace se bloquent parfois
MGMT-2519 L'interface utilisateur de configuration de l'environnement ne fonctionne pas
AXAPP-1814 Les variables personnalisées (règle StatisticsCollector) ne sont pas créées en production lorsque le conservateur Zookeeper est activé
APIRT-1927 Un hôte virtuel non valide empêche le routeur de charger la configuration de l'environnement.
APIRT-1863 Échec du déploiement en raison d'un espace dans le bundle
APIRT-1823 Les appels d'API avec des corps POST contenant des caractères & (esperluette) se bloquent
APIRT-1789 Processeurs de messages pour certaines organisations rencontrant des erreurs de mémoire insuffisante
APIRT-1776 L'appel de "print" dans les règles JavaScript entraîne une journalisation excessive
APIRT-1766 Délai d'expiration sur les WebSockets
APIRT-1600 ConcurrentModificationException dans le routeur
Les journaux du routeur ont montré plusieurs instances de ConcurrentModification dans les journaux de manière régulière. Cela était dû au fait que des connexions étaient ajoutées à la liste du reaper alors que celui-ci supprimait les connexions plus anciennes. Ce problème a été résolu.
APIRT-1491 Exception "503 Service indisponible"
APIRT-1421 Les règles JavaCallout mettent parfois beaucoup de temps à être traitées
DEVRT-1843 L'interface utilisateur Mint devrait mieux prendre en charge la mise à jour des attributs personnalisés dans TRP
DEVRT-1472 La mise à jour du développeur a entraîné une erreur de serveur 500

Cloud 15.09.30

ID du problème Description
MGMT-2687 Les rapports personnalisés figent le navigateur avec plus de 14 000 éléments dimensionnels
MGMT-2677 Monétisation : la page "Développeurs" de l'UI de gestion se fige lorsqu'une organisation compte des milliers de développeurs et que la pagination n'est pas activée
MGMT-2674 L'UI Edge tente de télécharger des données depuis Internet lors de la connexion de l'utilisateur
MGMT-2658 Problèmes liés à l'interface utilisateur du serveur de gestion en fonction de la version OPDK lors de la mise à niveau de la révision du proxy d'API
MGMT-2616 Le nouvel éditeur de proxys d'API ne gère pas correctement les entités XML
MGMT-2541 L'ID du système d'authentification externe ajouté en tant qu'administrateur système avec un signe + dans le mot de passe ne fonctionne pas
MGMT-2510 La liste déroulante n'affiche pas tous les développeurs appartenant à l'organisation
MGMT-2508 L'icône de lien rompu s'affiche de manière incorrecte sur les règles
MGMT-2334 Impossible d'accéder aux ressources depuis le deuxième point de terminaison du proxy
MGMT-1967 Les applications de développeur portant le même nom à afficher affichent le même trafic dans les données analytiques.
DEVRT-1839 Monétisation : la liste de sélection des pays dans l'interface utilisateur de gestion n'est pas triée correctement
AXAPP-1887 Les conditions de filtrage ne fonctionnent pas comme indiqué dans la documentation
AXAPP-1869 La suppression d'un utilisateur d'une organisation doit entraîner sa désinscription des e-mails d'analyse.
AXAPP-1533 La carte géographique Analytics renvoie l'erreur "Appel d'API non valide"
APIRT-2061 Le processeur de messages n'envoie pas de messages à QPID
APIRT-2052 Nombre élevé d'états CLOSE_WAIT, car le port de gestion ne répond pas
APIRT-2024 Nginx sans équilibreur de charge ne renseigne pas correctement les en-têtes HTTP X-Forwarded-For
APIRT-1838 Apigee-127 : VerifyAPIKey ne renvoie qu'un seul produit d'API lorsque plusieurs produits existent

Cloud privé 4.15.07.03

ID du problème Description
APIRT-1600 ConcurrentModificationException dans les journaux du routeur
APIRT-1734 Mise à jour des fichiers de ressources sans temps d'arrêt au niveau de l'organisation ou de l'environnement
APIRT-1820 Latence intermittente (> 1 %) dans l'environnement Private Cloud 4.15.04
APIRT-2159 Ajouter message_id au préfixe de journalisation
APIRT-2160 Exclure le handshake SSL de request_processing_latency dans les données Analytics
AXAPP-1882 Le thread de surveillance des consommateurs se connecte à la mauvaise file d'attente dans le déploiement actif/actif
AXAPP-1946 Les données sont déplacées vers la table de faits parente au lieu de la table de faits enfant lorsqu'elles se trouvent dans un fuseau horaire autre qu'UTC.
MGMT-1590 Correction d'une faille de sécurité
MGMT-1662 Échec du déploiement lors de la publication
MGMT-2361 Le déploiement des proxys échoue avec l'exception RPCException : délai avant expiration de l'appel
MGMT-2397 La vue Code n'analyse pas correctement les caractères de fin de ligne
MGMT-2466 La vérification du cluster par rapport au processeur de messages indique que le routeur non accessible est un membre CONNECTÉ
OPDK-1981 backup-cassandra.sh ne sauvegarde pas l'espace de clés système
OPDK-1982 apigee-upgrade.sh doit vérifier la version SSTable de Cassandra avant la mise à niveau

Cloud privé 4.15.07.01

ID du problème Description
OPDK-1927 Tables manquantes lors de la mise à niveau de la monétisation ; index en double créés
OPDK-1878 La modification du nom du pod de la passerelle lors de la configuration pose problème
OPDK-1886 Le nœud ne peut pas accéder aux adresses IP locales telles que 192.168.x.y
MGMT-2521 Les sessions Trace se bloquent parfois
MGMT-2543 Le nouvel éditeur de proxy modifie le code XML dans <Payload> de la règle AssignMessage, ce qui endommage les proxys d'API existants
MGMT-2599 Le nouvel éditeur de proxys restaure le préfixe de l'espace de noms après sa suppression
MGMT-2702 Faille de sécurité multisite pour Firefox et IE
APIRT-1074 Le contenu compressé au format gzip n'est pas géré correctement lorsque l'en-tête "Connection: Close" est envoyé sans les en-têtes "Content-Length" ou "Transfer-Encoding"

Problèmes connus

Cette version présente les problèmes connus suivants.

ID du problème Description
APIRT-2742 L'intégration JMX Edge n'est pas disponible avec Edge for Private Cloud 4.16.01 en raison de l'introduction du serveur Nginx qui a remplacé le routeur Netty.
APIRT-2978

Échec du démarrage de Nginx ou du routeur

Si le routeur Edge ne parvient pas à démarrer Nginx ou ne démarre pas du tout, comme indiqué dans le fichier /opt/apigee/var/log/edge-router/logs/system.log, supprimez tous les fichiers du répertoire /opt/nginx/conf.d, puis redémarrez le routeur :

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
DOC-1687 En raison d'un conflit de dépendances de package connu, l'agent Katello utilisé dans Satellite Server 6 ne s'installera pas correctement sur les hôtes Apigee Edge exécutant le démon Qpid.
PRC-1118

Erreur lors de l'exécution de la commande "apigee-service apigee-postgresql pg-data-purge"

Si vous exécutez la commande "apigee-service apigee-postgresql pg-data-purge" et que vous voyez une erreur au format suivant :

ERREUR : vous devez être le propriétaire de la relation

Modifiez /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge et définissez la propriété suivante sur "apigee" :

POSTGRES_USER=apigee