Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.
Le mardi 19 mai 2015, nous avons lancé une version trimestrielle d'Apigee Edge pour un cloud privé.
L'ancien nom du produit "Apigee Edge On-premises" ou "OPDK" est désormais "Apigee Edge pour le cloud privé".
Pour toute question, contactez l'assistance Apigee Edge.
Pour obtenir la liste de toutes les notes de version d'Apigee Edge, consultez Notes de version d'Apigee.
Nouvelles fonctionnalités et améliorations
Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations de cette version.
OpenLDAP : installation et mise à niveau
OpenLDAP est désormais le seul serveur LDAP compatible avec Edge pour les nouvelles installations et les mises à niveau.
Services d'API
Voici les nouvelles fonctionnalités et améliorations apportées aux services Edge API.
WebSockets
Pour activer les communications Web en temps réel entre un client Web et un serveur, Edge est compatible avec le protocole WebSocket. Edge peut jouer le rôle de client ou de serveur dans les communications WebSocket. Pour savoir comment configurer et utiliser WebSockets dans Edge, consultez le guide Utiliser WebSockets avec Apigee Edge pour le cloud privé.
Compatibilité avec les fournisseurs d'authentification externes pour la gestion des API
Edge s'intègre à Active Directory et à d'autres fournisseurs d'authentification externes/systèmes LDAP qui contiennent vos utilisateurs administrateurs d'API. Pour en savoir plus, consultez le guide Configuration de l'authentification externe pour Edge for Private Cloud.
Co-branding dans l'UI de gestion
Vous pouvez co-brand l'UI de gestion Edge avec votre propre logo personnalisé, qui s'affiche à côté du logo Apigee. Pour en savoir plus, consultez "Ajouter un logo personnalisé au menu de l'UI Apigee" dans le Guide des opérations Apigee Edge pour le cloud privé.
Journaux Node.js dans Trace
Lorsque vous déboguez des proxys d'API Node.js, vous pouvez activer la fonctionnalité de journal Node.js dans la vue Trace de l'éditeur de proxy d'API. Pour activer la fonctionnalité, définissez apigee.feature.disableNodeJSLogs="false" dans le fichier apigee-base.conf ou apigee-onpremise.conf de votre installation. Pour en savoir plus sur les journaux Node.js, consultez Déboguer et résoudre les problèmes liés aux proxys Node.js.
Expiration du mot de passe
Dans Edge 4.15.01.x, les mots de passe Edge expiraient automatiquement au bout de 30 jours. Cela signifiait qu'un utilisateur était verrouillé, sauf s'il modifiait son mot de passe avant son expiration. Toutefois, il a également entraîné l'expiration du mot de passe de l'administrateur système, qui a donc été bloqué dans Edge.
Lorsque vous passez à la version 4.15.04.00, la valeur par défaut change et les mots de passe n'expirent plus. Si nécessaire, vous pouvez configurer l'expiration des mots de passe Edge à l'aide du script /opt/apigee4/bin/apigee-enable-pwlockout.sh. Pour en savoir plus, consultez le Guide des opérations Apigee Edge pour un cloud privé.
Limiter l'accès administrateur système à des domaines de messagerie spécifiques
Vous pouvez limiter l'accès aux rôles d'administrateur système ou d'administrateur système en lecture seule aux utilisateurs de domaines de messagerie spécifiques. Pour activer cette fonctionnalité, ajoutez les domaines autorisés au fichier apigee4/conf/apigee/management-server/security.properties, comme décrit dans le Guide des opérations Apigee Edge pour le cloud privé.
Messages d'erreur de l'UI de gestion
L'affichage des messages d'erreur dans l'UI de gestion a été repensé pour utiliser l'espace de l'écran de manière plus efficace.
Nouvelles variables de défaut OAuthV2
Ces nouvelles variables liées aux erreurs sont définies par la règle OAuthV2 :
- oauthV2.<policy-name>.failed : défini sur "true" si la règle a échoué.
- oauthv2.<policy_name>.<fault_name> : nom de l'erreur. Par exemple, invalid_request
- oauthv2.<policy_name>.<fault_cause> : raison de l'erreur. Par exemple : "Jeton expiré"
Consultez http://apigee.com/docs/api-services/content/oauthv2-policy.
Création de produits
Lorsque vous créez un produit, vous pouvez désormais spécifier son nom en plus de son nom à afficher.
Consultez http://apigee.com/docs/developer-services/content/creating-api-products.
Interface utilisateur permettant de supprimer des utilisateurs d'une organisation
Sur la page "Utilisateurs de l'organisation" de l'UI, le bouton "Supprimer" a été remplacé par un bouton "Supprimer". Cela permet de préciser que lorsque vous supprimez un utilisateur d'une organisation, son compte Apigee reste actif.
Consultez http://apigee.com/docs/api-services/content/managing-organization-users.
Options de filtrage dans l'interface utilisateur de gestion
De nouvelles options de filtrage sont disponibles pour la recherche sur les pages "Proxys d'API", "Produits", "Développeurs" et "Applications" de l'UI de gestion.
Outil Trace hors connexion
L'outil Offline Trace vous permet d'afficher et d'analyser les sessions de trace précédemment enregistrées. Une session de trace sauvegardée est essentiellement un "enregistrement" d'une session de trace. Elle peut être utile dans les cas où un dépannage et une analyse plus approfondie sont nécessaires. L'UI de l'outil Trace hors connexion est semblable à celle de l'outil Trace "en direct".
Pour en savoir plus, consultez Utiliser l'outil de trace hors connexion.
Rôles utilisateur affichés dans les paramètres utilisateur
Les rôles de l'utilisateur sont désormais affichés sur la page "Paramètres utilisateur" de l'interface utilisateur de gestion (nom d'utilisateur > Paramètres utilisateur).
Améliorations apportées à l'interface utilisateur de gestion Edge
Cette version inclut un certain nombre de petites améliorations en termes d'usabilité et de cohérence dans l'interface utilisateur de gestion Edge.
Services d'analyse
Voici les nouvelles fonctionnalités et améliorations apportées aux services Edge Analytics.
Six mois de données disponibles
Lorsque vous générez des rapports d'analyse avec l'interface utilisateur ou l'API de gestion, les données de plus de six mois à compter de la date du jour ne sont pas accessibles par défaut. Si vous souhaitez accéder à des données de plus de six mois, contactez l'assistance Apigee Edge.
Variables ajoutées aux données analytiques
Les nouvelles variables suivantes sont transmises à Edge Analytics et sont visibles dans la phase AX de la fenêtre de trace du proxy d'API.
- apigee.edge.execution.is_target_error : vous permet d'identifier si les erreurs d'API sont des erreurs côté cible (valeur "1") ou des erreurs non liées à la cible pour les réponses HTTP infructueuses (valeur "0"). La valeur est nulle pour une réponse HTTP réussie.
-
apigee.edge.execution.is_policy_error : vous permet d'identifier si une règle a échoué (valeur "1") ou si aucune règle n'a échoué dans une réponse HTTP infructueuse (valeur "0"). La valeur est nulle pour une réponse HTTP réussie.
Les variables associées suivantes fournissent des détails sur la première règle qui a échoué. Les valeurs sont nulles si aucune règle n'a échoué.- apigee.edge.execution.fault_policy_name : nom de la règle qui a échoué.
- apigee.edge.execution.fault_flow_name : nom du flux dans la règle qui a échoué (par exemple, PreFlow, PostFlow ou un flux défini par l'utilisateur).
- apigee.edge.execution.fault_flow_state : emplacement où la règle a été associée au flux. Valeurs possibles : PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Tableaux de bord
- Les graphiques de performances pour les API, les développeurs, les produits et les applications de développeurs ont été déplacés. Auparavant, elles s'affichaient en bas des pages principales de ces entités. Pour accéder aux graphiques, sélectionnez l'onglet Analytics en haut de chaque page.
- Cette version inclut des modifications importantes apportées aux tableaux de bord existants ou nouveaux suivants :
- Tableau de bord Apigee (révisé) : inclut trois graphiques de métriques : trafic de proxy, engagement des développeurs et applications de développeur. Chaque graphique fournit une vue "Plus de détails" qui vous permet d'examiner chaque métrique. Consultez Tableau de bord Apigee.
- Performances du proxy (nouveau) : affiche les modèles de trafic et les temps de traitement des proxys d'API. Remplace le tableau de bord "Performances des proxys d'API". Consultez Performances des proxys d'API.
- Composition du trafic (révisé) : l'apparence, l'ergonomie et le contenu du tableau de bord ont été entièrement revus. Mesure la contribution relative de vos principales API, applications, développeurs et produits à l'ensemble de votre programme d'API. Consultez Composition du trafic.
- Analyse des erreurs (révisée) : l'apparence et le contenu ont été entièrement revus. Affiche les taux d'erreur pour les proxys d'API et les cibles. Consultez le tableau de bord "Analyse des codes d'erreur".
-
Les tableaux de bord existants ont été renommés :
- Performances des points de terminaison a été renommé Performances des cibles : affiche les modèles de trafic et les métriques de performances pour les cibles de backend de proxy d'API. Consultez Performances des cibles.
- Engagement des partenaires a été renommé Engagement des développeurs : indique quels développeurs d'applications enregistrés génèrent le plus de trafic d'API. Pour chacun de vos développeurs, vous pouvez identifier ceux qui génèrent le plus de trafic d'API et le plus d'erreurs. Consultez Engagement des développeurs.
Services pour les développeurs
Voici les nouvelles fonctionnalités et améliorations apportées aux services pour les développeurs Edge.
Prise en charge de Swagger 2.0 pour Smart Docs
SmartDocs permet d'importer des documents de spécification Swagger 2.0 et assure la rétrocompatibilité avec Swagger 1.2. La compatibilité avec les objets de schéma de sécurité et les schémas centralisés sera disponible dans une prochaine version.
Monétisation
Voici les nouvelles fonctionnalités et améliorations apportées à la monétisation Edge. Pour en savoir plus sur la monétisation, consultez également la section "Problèmes connus".
Traitement distinct des entreprises et des développeurs
Les entreprises et les développeurs sont désormais gérés séparément, ce qui permet d'ajouter plus facilement plusieurs entreprises à des développeurs et plusieurs développeurs à des entreprises. L'UI de gestion fournit désormais des fenêtres distinctes pour les "Entreprises" et les "Développeurs" (accessibles depuis le menu "Publier").
Consultez Gérer les entreprises et les développeurs.
Dans les rapports sur la monétisation, les entreprises restent un filtre principal, même si le libellé du filtre est passé de "Développeurs" à "Entreprises".
Bugs résolus
Les bugs suivants sont résolus dans cette version.
| ID du problème | Description |
|---|---|
| OPDK-954 | 4.15.01 Le schéma Cassandra n'est pas mis à niveau |
| MGMT-1986 | Erreur d'interface utilisateur lors de l'ajout d'un développeur |
| MGMT-1983 | L'API "Obtenir un code d'autorisation OAuth 2.0" renvoie un état incorrect |
| MGMT-1962 | Erreur de connexion à l'UI de gestion avec un mot de passe sécurisé La connexion à l'UI avec certains caractères spéciaux, tels que le signe pourcentage, ne génère plus d'erreur. |
| MGMT-1894 | La page "Applications du développeur" ne finit jamais de se charger pour la colonne "Développeur" |
| MGMT-1872 | Impossible de télécharger des rapports personnalisés |
| MGMT-1777 | Impossible d'ajouter un utilisateur dont l'adresse e-mail comporte un TLD .acn |
| MGMT-1362 | L'e-mail "Mot de passe oublié" ne fonctionne pas si l'adresse e-mail contient un caractère "_" Résolution du problème de réinitialisation du mot de passe dans le cloud privé avec les adresses e-mail contenant un underscore. |
| CORERT-613 | Échecs du handshake SSL en raison de "unrecognized_name" |
| APIRT-1346 | OAuth2.0 : une valeur hachée est renvoyée dans la réponse du jeton d'accès lorsque hash.oauth.tokens.enabled est défini sur "true" |
Cette version contient également des corrections de bugs des versions suivantes :
| Edge Cloud | Edge pour le cloud privé |
|---|---|
Problèmes connus
Cette version présente les problèmes connus suivants.
| ID du problème | Description |
|---|---|
| N/A |
Deux scripts Cassandra, que le programme d'installation utilise lors de l'installation ou de la mise à niveau de monetization, n'ont pas été inclus dans la version. Pour contourner ce problème, exécutez les commandes suivantes après l'installation ou la mise à niveau de Cassandra afin de terminer l'installation ou la mise à niveau de la monétisation :
|
| CORERT-318 | Les appels d'API avec des charges utiles volumineuses (centaines de Ko) peuvent parfois se bloquer. Pour contourner ce problème, définissez la valeur de propriété suivante dans votre fichier router.properties :HTTPServer.streaming.buffer.limit=0 (le paramètre par défaut est 10) |