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é :
- Cloud : 15.07.08, 15.07.22, 15.08.05, Migration Nginx, 15.09.02, 15.09.30, 16.01.20
- Private Cloud : 4.15.07.01, 4.15.07.03
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>/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>/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 |
|
|
Intégration |
/<inst_root>/apigee4/bin/setup-org.sh |
|
|
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 |
|
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 :
- Documentation de référence sur la configuration des proxys d'API
- Dynamic SSLInfo for TargetEndpoint using variable reference
(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 |
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 |