4.16.01 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

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

Depuis la version trimestrielle précédente d'Edge for Private Cloud (4.15.07.00), les versions suivantes ont eu lieu et sont incluses dans cette version de fonctionnalité:

Consultez la section À propos de la numérotation de version pour comprendre comment déterminer si une version spécifique du cloud 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 une API pour vérifier les files d'attente QPID
Vous ne pouvez plus vérifier les files d'attente créées sur le serveur QPID à l'aide des commandes CURL suivantes:
curl http:// <qpid_IP>:8083/v1/servers/self/queues
Cette API est obsolète.

Analytics: Tableau de bord de 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 en cours d'abandon 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 le cloud privé

Vous ne pouvez plus remplacer la longueur du nom de l'organisation (20 caractères) par le paramètre suivant:

  • APIGEE_ORG_NAME_LENGTH=25
    
  • APIGEE_ENV_NAME_LENGTH=25
    

Nouvelles fonctionnalités et améliorations

Voici les nouvelles fonctionnalités et améliorations de cette version. Outre les améliorations suivantes, cette version inclut plusieurs améliorations en termes de convivialité, de performances, de sécurité et de stabilité.

Cloud privé

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 le RPM

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

Nouveau répertoire de base

La structure de répertoires de la version Edge 4.16.01 a changé. Dans les versions précédentes d'Edge, vous avez installé Edge dans le répertoire de base:

/<install-dir>/apigee4

Où "install-dir" peut se trouver n'importe où, avec la valeur par défaut /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é. Elle peut se trouver sous /opt/apigee ou se trouver ailleurs.

Nouvelle condition d'hôte virtuel

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.

Consultez le guide d'installation d'Edge, disponible sur le site FTP d'Apigee: ftp://ftp.apigee.com/ pour plus d'informations sur l'ajout d'un alias d'hôte à un hôte virtuel existant.

Coder avec configuration

Dans Edge version 4.16.01, vous n'utilisez plus de fichiers .properties dans le 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:

/opt/apigee/customer/application

Il existe un fichier .properties dans ce répertoire pour chaque composant Edge installé sur un nœud. Pour configurer un composant, modifiez le fichier .properties correspondant afin de changer 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 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 d'utilisation 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 utilisiez dans les versions précédentes d'Edge ont été supprimés et remplacés par l'une des versions suivantes:

  • Commandes que vous exécutez via des utilitaires Apigee, tels que 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 ancienPword -n newPword

Consultez le guide d'utilisation d'Apigee Edge, disponible sur le site FTP d'Apigee à l'adresse ftp://ftp.apigee.com/, pour en savoir plus sur la configuration via des commandes.

Nouveau routeur de périphérie

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 d'Edge antérieures à la version 4.16.01.

Les routeurs Nginx ont les mêmes exigences en termes de matériel et de ports que le routeur Netty. Aucune modification des nœuds existants n'est donc nécessaire.

Pour en savoir plus, consultez l'annexe A: À propos du routeur Nginx, dans le guide d'installation 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 BaaS des API. Vous devez maintenant utiliser votre propre équilibreur de charge entre le portail BaaS de l'API et les trois nœuds de pile BaaS de l'API.

Au lieu d'un équilibreur de charge, vous pouvez utiliser un DNS à tour de rôle. 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 résolution DNS, le serveur DNS renvoie automatiquement les valeurs d'enregistrement A à tour de rôle.

Nouvelle documentation expliquant 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 disponible sur le site FTP d'Apigee contient à présent "Scaling 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.

Suppression d'Orgtool

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

Comment effectuer des tâches dans la version 4.16.01

Le tableau suivant montre comment vous avez effectué les tâches de la version 4.15.07.03 et comment vous les avez effectuées actuellement dans la version 4.16.01. Pour en savoir plus, consultez le guide d'utilisation d'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 de journaux

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

Installer le composant

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

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

Tous les démarrages, les arrêts, les redémarrages, les états, les versions

/<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émarrage, arrêt, redémarrage, état, version

/<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

Sauvegarder/Restaurer

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

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

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

Installation test

/<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 configuration apigee-validate

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

Ajoutez l'organisation, l'environnement et l'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 env

/<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

un appel d'API ou:

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

Migration

/<racine_installation>/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 de surveillance et du tableau de bord

Cette version comprend une version alpha du nouvel outil de surveillance et du nouvel tableau de bord 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 associés à divers organisations et environnements de votre déploiement. Vous pouvez également prendre un instantané des données de votre tableau de bord et les partager avec Apigee pour résoudre les incidents d'assistance.

La documentation, y compris les instructions d'installation, est incluse dans le fichier ZIP du document 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 du document, puis le renvoyer à Apigee en l'envoyant par e-mail à l'adresse orders@apigee.com.

Plate-forme périphérique

Refonte de l'interface utilisateur de gestion (Cloud 15.09.30)

L'aspect général a été mis à jour pour plusieurs pages de l'interface utilisateur de gestion. (MGMT-2627)

Services d'API

Refonte de l'assistant de proxy d'API (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 du 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 du nouvel assistant de proxy d'API, vous pouvez maintenant 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)

Prise en charge de WSDL 1.2 pour les proxys SAML (Cloud 16.01.20)

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

Variables SSLInfo dans les configurations de TargetEndpoint (Cloud 16.01.20)

Dans un point de terminaison cible d'un proxy d'API, vous pouvez définir les détails SSL/TLS de manière dynamique pour répondre aux exigences d'exécution flexibles. Dans l'exemple suivant qui illustre la définition de SSLInfo dans une configuration TargetEndpoint, les valeurs peuvent être fournies au moment de l'exécution par une accroche Java, une règle JavaScript ou une règle d'attribution de messages. 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 abordée dans les documents suivants:

(APIRT-1475).

Compatibilité de l'algorithme RSA_SHA256 avec 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 des keystores et des stores, l'API de gestion valide les certificats lors de l'importation. Les certificats sont validés pour s'assurer que la taille du fichier n'est pas supérieure à 50 Ko et que le format est soit PEM, soit DER. L'expiration du certificat est également validée. Pour ignorer 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 les sections Importer un fichier JAR dans un keystore et Importer un certificat dans un Truststore. (SECENG-516) et (APIRT-2213)

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

Lorsque vous affichez des journaux Node.js à partir de l'éditeur de proxy, la page "Journaux" de Node.js est automatiquement actualisée régulièrement pour répertorier 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 qu'elle a reçue lors du dernier handshake TCP externe, et non une adresse qui pourrait potentiellement être falsifiée pour contourner la stratégie de contrôle d'accès.

Pour modifier ce comportement par défaut et autoriser les adresses X-Forwarded-For à atteindre 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 stratégies (Cloud 15.07.08)

Lorsque vous utilisez JavaScript dans les flux de proxy d'API, vous pouvez accéder aux propriétés définies dans la règle JavaScript. Ceci est particulièrement utile si vous souhaitez utiliser des variables connues dans votre code JavaScript. Supposons, par exemple, 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 au message 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 de l'organisation peuvent auditer l'historique des actions effectuées au niveau de l'organisation. Dans l'interface utilisateur de gestion, sélectionnez Admin > Historique de l'organisation. Pour en savoir plus, consultez la page Audits: API, produits et historique de l'organisation. (MGMT-2232)

Retrait automatique du rôle d'un administrateur de l'organisation (Cloud 15.07.08)

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

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

Lors de l'importation d'un groupe de proxys d'API volumineux dans l'interface utilisateur de gestion, une animation "fonctionnelle" s'affiche pour indiquer que l'importation est toujours en cours, ce qui vous empêche d'interagir avec l'interface utilisateur de gestion jusqu'à la fin de l'importation. (MGMT-1285)

Comportement et configuration du cache (Cloud 15.07.22)

Pour améliorer la gestion et l'utilisation du cache en mémoire, le paramètre "Nombre maximal d'éléments en mémoire" sur les ressources du cache de l'environnement a été abandonné depuis la version 15.06.10 d'Edge Cloud. 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 partie "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 sont supprimés du cache en mémoire que si la mémoire du cache est insuffisante ou que les éléments expirent. (MGMT-2413, APIRT-1140)

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

La page API > Configuration de l'environnement de l'interface utilisateur de gestion vous permet à présent d'ajouter, de modifier et de supprimer des serveurs cibles.

De plus, la page a été repensée de sorte que des caches puissent également être créés, ajoutés et supprimés directement au lieu d'accéder à une nouvelle page. Plusieurs propriétés de cache, y compris le "Nombre maximal d'éléments en mémoire", ne sont plus disponibles dans l'interface utilisateur, car la définition de ces propriétés n'a plus d'incidence sur le comportement du cache au moment de l'exécution. (MGMT-280)

SSL avec journalisation des messages vers syslog (Cloud 15.07.22)

La stratégie de journalisation des messages permet l'envoi de syslog à des fournisseurs tiers de gestion des journaux via SSL/TLS. Utilisez les éléments suivants dans la configuration de la stratégie en tant qu'enfant direct de l'élément parent:

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

Pour en savoir plus, consultez la section Règle de journalisation des messages. (APIRT-942)

UI de gestion (Cloud 15.07.22)

Les ingénieurs Apigee ont corrigé plusieurs bugs mineurs et amélioré la facilité d'utilisation de l'interface utilisateur de gestion.

cURL dans Trace (Cloud 15.09.02)

Lors du traçage d'un appel de proxy d'API qui envoie une requête à un serveur cible, vous pouvez afficher la requête sur le serveur cible sous la forme d'une commande cURL. Sélectionnez l'étape "Request sent to target server" (Demande envoyée au serveur cible) dans le diagramme de carte des transactions, puis cliquez sur le bouton "Show Curl" (Afficher l'URL) dans la colonne "Request sent to target server" (Demande envoyée au serveur cible) dans le volet "Phase Details" (Détails de la phase). (MGMT-2589)

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

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

Cartes clés-valeurs dans l'interface utilisateur de gestion (Cloud 15.09.30)

Vous pouvez désormais créer et gérer des cartes clés-valeurs (KVM) à l'échelle de l'environnement dans l'interface utilisateur de gestion en périphérie. Les KVM à l'échelle de l'environnement contiennent des paires clé/valeur accessibles par n'importe quel proxy d'API dans un environnement, tel que test ou production. Dans le menu de l'interface utilisateur de gestion, accédez à API > Configuration de l'environnement > sélectionnez l'environnement de votre choix > onglet Cartes clés-valeurs. Pour en savoir plus, consultez la section Créer et modifier des mappages de clé-valeur d'environnement. (MGMT-1393)

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

Lors de l'ajout d'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 de produit d'API, aucune application de développement répertoriée (Cloud 16.01.20)

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

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

Dans les organisations comptant un grand nombre d'applications de développement (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 pour définir la propriété suivante au niveau de l'organisation: features.appsNoCredentialsEnabled = true. Cette propriété supprime la colonne "Clé". Toutefois, notez que la suppression de la colonne "Clé" supprime également la possibilité d'effectuer une recherche par clé et code secret client. (MGMT-2486)

Icône de chargement de la page d'informations sur le développeur (Cloud 15.09.30)

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

Monétisation

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

Vous pouvez mettre à jour le nom d'un package d'API à tout moment du cycle de monétisation, même si le package d'API contient un plan tarifaire publié. (DEVRT-2177)

Nombre décimal autorisé dans les attributs personnalisés (Cloud 16.01.20)

Dans le cas d'un forfait "Tableau des tarifs avec attribut personnalisé", l'attribut personnalisé de l'en-tête du message qui est utilisé comme multiplicateur pour la transaction peut désormais être une valeur décimale comportant jusqu'à quatre chiffres après la virgule. Pour en savoir plus sur ce type de forfait, consultez la section Spécifier les détails de l'attribut personnalisé du tableau des tarifs (DEVRT-2191).

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

Lorsque vous générez un rapport récapitulatif sur les revenus avec l'API de gestion, vous pouvez ajouter les colonnes "Nom du plan tarifaire" 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 la section Créer des rapports. Notez que cette fonctionnalité n'est pas encore disponible dans l'interface utilisateur des rapports de monétisation. Dans les rapports détaillés, les colonnes "Nom du plan tarifaire" et "ID" existantes 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 d'analyse personnalisés et les appels d'API, la fonction d'agrégation "sum" est désormais disponible pour le temps de réponse cible, le 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 maintenant utiliser le paramètre de requête "select" suivant: ?select=sum(total_response_time). (AXAPP-2006)

Rapport d'analyse de latence: noms de proxy d'API triés (Cloud 16.01.20)

Dans l'interface utilisateur du rapport d'analyse de latence (forfaits d'entreprise Apigee Edge uniquement), les proxys d'API sont répertoriés par ordre alphabétique dans la liste déroulante Proxy. (MGMT-2858)

Applications de développement sur le tableau de bord affichées par leur nom à afficher (Cloud 16.01.20)

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

Nouveau widget date/heure dans les rapports personnalisés (Cloud 16/01/20)

Amélioration du widget de sélecteur de date/heure sur une page de rapports personnalisés dans l'interface utilisateur de gestion. (MGMT-2881)

Détail des villes sur GeoMap (Cloud 15.07.22)

La GeoMap d'analyse inclut une vue détaillée "Ville" pour les États-Unis et le Canada. Lorsque vous cliquez sur un État ou une province sur la carte, la liste des villes d'où proviennent les appels s'affiche. (MGMT-2282)

| (barre verticale) et = caractères dans les rapports d'analyse personnalisés (Cloud 15.09.02)

Les définitions de rapport personnalisées Analytics prennent en charge l'utilisation des symboles | (barre verticale) et =. Auparavant, les encodages %7C et %3D devaient être utilisés pour ces symboles. (MGMT-2504)

Dimension "Suffixe du chemin proxy" (Cloud 15.09.30)

Une nouvelle dimension "Suffixe du chemin d'accès proxy (proxy_pathsuffix)" est disponible dans les rapports personnalisés d'analyse et les appels d'API. Le suffixe du chemin d'accès au proxy est la partie d'une URL de proxy d'API qui suit le chemin de base, telle que 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 d'analyse Edge avec l'API /stats qui renvoie les 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 for Private Cloud. Pour obtenir ces correctifs, suivez les instructions pour mettre à jour votre installation 4.16.01 vers les derniers RPM et fichiers de support, comme décrit dans la section Mettre à jour Apigee Edge 4.16.01.x vers la dernière version 4.16.01.

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

apigee-lib n'a plus besoin de 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 du cluster Zoo ceseper 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

Possibilité de spécifier l'emplacement des fichiers journaux

apigee-service-4.16.05-0.0.435
PRC-840

Liens symboliques défectueux pour les composants Edge

edge-gateway-4.16.01-0.0.538

EDGEUI-538
EDGEUI-524

Interruption de la génération du proxy Soap pour l'importation WSDL/ Problème lors de la génération d'un proxy d'API à partir d'un WSDL

edge-ui-4.16.01-0.0.3650
EDGEUI-543

Impossible d'importer le fichier WSDL à partir de l'option "URL" lorsque l'URL est une adresse locale

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

target.url est maintenant définie lors de la création d'accroches 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 à l'intérieur de la balise Flows
MGMT-2957 L'ajout d'un nouveau pod à une organisation renvoie l'état de déploiement du bundle en tant qu'erreur pour les routeurs du nouveau pod
MGMT-2937 Erreurs d'autorisations insuffisantes avec les rôles personnalisés
MGMT-2875 La génération SAML WSDL comporte des en-têtes incorrects pour SAML 1.2
MGMT-2739 Rapport sur les applications de développement, l'onglet "Analytics" n'affiche pas de graphique d'anomalie
MGMT-2735 L'actualisation des journaux Node.js ne se termine jamais/ne s'arrête jamais
MGMT-2734 Le bouton "Save" (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 de TargetServer dans l'interface utilisateur 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 de FireFox et d'IE, qui autorisent de manière inappropriée les requêtes intersites.
MGMT-2681 Éditeur de proxy: lors de l'utilisation d'une correspondance d'expression régulière dans la condition, le navigateur de flux n'affiche pas le verbe
MGMT-2361 Échec du déploiement des proxys avec RPCException: le délai d'appel a expiré
MGMT-1662 Le déploiement du proxy d'API échoue pendant les versions d'Apigee Public Cloud
DEVRT-2286 L'API de monétisation sync-organization ne fonctionne pas
L'API utilisée pour synchroniser les données Apigee Edge avec la monétisation a été corrigée dans la dernière mise à jour de la version 16.01.20.
DEVRT-2173 Vous devez renommer le package, mais vous ne pouvez pas le modifier en raison d'un plan tarifaire actif
DEVRT-1661 Le développeur ne peut pas effectuer de requêtes API avant la date de début du plan tarifaire, mais le blocage n'est jamais libéré
Si un développeur d'API a accepté une plate-forme mensuelle forfaitaire, avec limite de volume ou bundle qui commence à une date ultérieure, puis envoie des requêtes API avant la date de début spécifiée, le développeur de l'API n'est pas autorisé à envoyer d'autres requêtes. Une fois la date de début du plan tarifaire atteinte, le blocage est libéré.
DEVRT-1643 Le plan tarifaire brouillon est corrompu après son enregistrement
AXAPP-1991 Vous pouvez vous désinscrire des analyses Apigee sans interruption
AXAPP-1946 Le nettoyage Analytics ne libère pas d'espace disque
AXAPP-1708 L'API Analytics semble produire des chiffres différents pour la même statistique selon la façon dont je pose la question.
AXAPP-1293 E-mail récapitulatif sur les noms d'applications de développeur qui n'existent pas dans Analytics
APIRT-2518 Problèmes de connexion au backend HTTPS avec une règle JavaScript
APIRT-2398 Code d'autorisation non valide ou expiré, comptabilisé comme une erreur Apigee
APIRT-2397 steps.assignmessage.SetVariableFailed comptant comme erreur Apigee
APIRT-2396 IllegalArgumentException, ArrayIndexOutofBoundsException dans OAuth comptabilisée comme une 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 Échec important 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 de transfert fragmenté 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 ajoutés récemment
APIRT-2117 La règle de journalisation des messages ne respecte pas les mises à jour DNS
APIRT-2110 Un seul en-tête X-Forwarded-For est transmis par le routeur
APIRT-2062 Le cache de réponse ne fonctionne pas correctement lorsque la condition SkipCacheLookup est remplie
APIRT-2061 Le processeur de messages ne transmet pas les messages à QPID
APIRT-2052 Nombre élevé de messages 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
Avis d'abandon de X-Forwarded-For ajouté aux notes de version 150930 et à la stratégie de contrôle d'accès.
APIRT-1933 Les chargeurs de classe spécifiques au proxy délèguent toujours le 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 Faible limite de streaming simultané observée
APIRT-1820 Latence intermittente (> 1%) dans l'environnement de cloud privé 4.15.04
APIRT-707 NPE pendant l'exécution si l'élément <GenerateResponse> figure 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 point de terminaison ProxyEndpoint
MGMT-2355 L'interface utilisateur ne calcule pas correctement les autorisations pour plusieurs rôles si l'un des rôles est "orgadmin"
MGMT-2324 L'importation d'un modèle Swagger génère des nœuds SmartDocs incorrects
MGMT-1518 L'interface utilisateur montre le proxy comme déployé alors que le déploiement a échoué sur les MP
MGMT-1489 Le produit d'API ne génère pas les ressources correctes
DOC-1246 Déclaration contradictoire dans la documentation concernant les jetons d'accès
DEVRT-1661

NextRecurringFeeDate est vide lorsque le développeur accepte le forfait de fonctionnalité
Si un développeur a accepté un forfait mensuel forfaitaire, un forfait par bandes ou un forfait groupé qui commence à une date ultérieure, effectue quelques appels d'API sur le plan tarifaire avant la date de début et qu'il a été bloqué des appels (comportement attendu), il n'a pas été automatiquement débloqué lors de l'entrée en vigueur du plan tarifaire. 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" obtient des erreurs d'autorisation à la connexion
MGMT-2341 Le filtre de rapport personnalisé crée une requête de manière incorrecte
MGMT-2207 JSONThreatProtection : ArrayElementCount ne fonctionne pas si l'élément contenu est non primitif
Dans la stratégie JSON Threat Protection, l'élément ArrayElementCount ne limitait pas avec précision le nombre d'éléments autorisés dans les tableaux. Ce problème a été résolu.
MGMT-2158 Impossible d'importer le fichier WSDL si la sortie fait référence à une partie sans type

Cloud 15.08.05

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

Cloud 15.09.02

ID du problème Description
plusieurs Un certain nombre de petits bugs ont été corrigés dans l'éditeur de proxys d'API.
MGMT-2618 Problèmes fréquents de déploiement
MGMT-2588 La page de l'historique des développeurs exécute le code html/code : faille de persistance XSS
MGMT-2543 Le nouvel éditeur de proxy modifie le code XML dans le champ <Payload> de la stratégie d'AssignMessage, ce qui rompt les proxys d'API existants
MGMT-2521 La session Trace se bloque parfois
MGMT-2519 L'interface utilisateur de configuration de l'environnement ne fonctionne pas
AXAPP-1814 Les variables personnalisées (stratégie du collecteur de statistiques) ne sont pas créées en production lorsque le conservateur ZK est activé
APIRT-1927 Un hôte virtuel non valide empêche le routeur de charger la configuration pour l'environnement.
APIRT-1863 Échec du déploiement en raison d'un espace blanc dans le bundle
APIRT-1823 Les appels d'API dont le corps POST contient les caractères & (esperluette) sont bloqués
APIRT-1789 Processeurs de messages de certaines organisations confrontés à 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élais d'inactivité sur WebSockets
APIRT-1600 ConcurrentModificationException dans le routeur
Les journaux de routeur ont affiché régulièrement plusieurs instances de ConcurrentModification dans les journaux. La raison à cela était que des connexions étaient ajoutées à la liste Reaper pendant que le Reaper supprimait les connexions plus anciennes. Ce problème a été résolu.
APIRT-1491 Exception 503 : service non disponible
APIRT-1421 Le traitement des règles JavaCallout prend du temps par intermittence
DEVRT-1843 L'UI de Mint devrait faciliter 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 des développeurs dans l'interface utilisateur de gestion se fige lorsque des milliers de développeurs sont présents, et la pagination n'est pas activée pour une organisation
MGMT-2674 L'interface utilisateur Edge tente de télécharger à partir d'Internet à la connexion de l'utilisateur
MGMT-2658 Problèmes de l'interface utilisateur du serveur de gestion dépendant de la version d'OPDK lors de la mise à niveau de la révision du proxy d'API
MGMT-2616 Le nouvel éditeur de proxy 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 le signe "+" dans le mot de passe ne fonctionne pas
MGMT-2510 Liste déroulante n'affichant pas tous les développeurs appartenant à l'organisation
MGMT-2508 Icône de lien non fonctionnel sur les règles affichées de manière inexacte
MGMT-2334 Impossible d'accéder aux ressources du 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 Conditions de filtre non conformes comme indiqué dans la documentation
AXAPP-1869 La suppression d'un utilisateur d'une organisation doit le désabonner des e-mails Analytics
AXAPP-1533 La Geomap Analytics génère une erreur "Appel d'API non valide"
APIRT-2061 Le processeur de messages ne transmet pas les messages à QPID
APIRT-2052 Nombre élevé de messages 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"
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/de l'environnement.
APIRT-1820 Latence intermittente (> 1%) dans l'environnement de cloud privé 4.15.04
APIRT-2159 Ajouter message_id au préfixe de journalisation
APIRT-2160 Exclure le handshake SSL de request_processing_latence dans les données d'analyse
AXAPP-1882 Le thread d'observation du consommateur se connecte à la mauvaise file d'attente dans un déploiement actif/actif
AXAPP-1946 Les données sont déplacées vers une table de faits parente et non vers une table de faits enfant si elles se trouvent dans un fuseau horaire autre qu'UTC
MGMT-1590 Correction d'une faille de sécurité
MGMT-1662 Le déploiement échoue pendant la publication
MGMT-2361 Échec du déploiement des proxys avec RPCException: le délai d'appel a expiré
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 est inaccessible en tant que membre CONNECTÉ
OPDK-1981 backup-cassandra.sh ne sauvegarde pas l'espace de clés du système
OPDK-1982 apigee-upgrade.sh doit vérifier la version de SSTable de Cassandra avant la mise à niveau

Cloud privé 4.15.07.01

ID du problème Description
OPDK-1927 Tables manquantes pour la mise à niveau de la monétisation ; création d'index en double
OPDK-1878 Problèmes liés à la modification du nom du POD de la passerelle lors de la configuration
OPDK-1886 Le nœud ne peut pas accéder aux adresses IP locales telles que 192.168.x.y
MGMT-2521 La session Trace se bloque parfois
MGMT-2543 Le nouvel éditeur de proxy modifie le code XML dans le champ <Payload> de la stratégie d'AssignMessage, ce qui rompt les proxys d'API existants
MGMT-2599 Le nouvel éditeur de proxy restaure le préfixe d'espace de noms après sa suppression
MGMT-2702 Faille de sécurité intersites pour FireFox et IE
APIRT-1074 Le contenu compressé avec 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 d'Edge JMX n'est pas disponible avec Edge for Private Cloud 4.16.01, le serveur Nginx qui a remplacé le routeur Netty.
APIRT-2978

Le routeur ne parvient pas à démarrer Nginx ou le routeur ne démarre pas

Si le routeur Edge ne parvient pas à démarrer Nginx ou ne démarre pas, 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 et 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 packages connu, l'agent Katello utilisé dans Satellite Server 6 ne s'installe pas correctement sur les hôtes Apigee Edge exécutant le daemon 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 une erreur s'affiche sous la forme suivante:

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