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 les notes de version d'Apigee.
Nouvelles fonctionnalités et améliorations
Voici les nouvelles fonctionnalités et améliorations apportées à 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
Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations apportées aux services d'API Edge.
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'interface utilisateur de gestion
Vous pouvez co-brander 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 bloqué s'il ne modifiait pas son mot de passe avant son expiration. Toutefois, cela 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 le cloud privé.
Limiter l'accès des administrateurs 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'interface utilisateur de gestion a été repensé pour utiliser l'espace à l'écran de manière plus efficace.
Nouvelles variables de défaillance 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'interface utilisateur, 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 Offline Trace
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'interface utilisateur de l'outil Offline Trace est semblable à l'outil Trace "en direct".
Pour en savoir plus, consultez Utiliser l'outil 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 de l'usabilité et de la 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 aux données analytiques Edge. Elles sont visibles dans l'étape AX de la fenêtre de trace du proxy d'API.
- apigee.edge.execution.is_target_error : 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éveloppeur 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éveloppeurs. Chaque graphique fournit une vue "Plus de détails" qui vous permet d'analyser 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. Parmi tous vos développeurs, vous pouvez savoir qui génère 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 SmartDocs
SmartDocs permet d'importer des documents de spécification Swagger 2.0 et reste rétrocompatible 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".
Gestion distincte 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").
Pour en savoir plus, consultez Gérer les entreprises et les développeurs.
Dans les rapports sur la monétisation, les entreprises restent un filtre principal, mais 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 Get an OAuth 2.0 authorization code renvoie un état incorrect |
| MGMT-1962 | Erreur de connexion à l'interface utilisateur de gestion avec un mot de passe fort La connexion à l'interface utilisateur avec certains caractères spéciaux, tels que le signe pourcentage, n'échoue plus. |
| 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 se termine par .acn |
| MGMT-1362 | L'e-mail de 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 caractère de soulignement. |
| CORERT-613 | Échec du handshake SSL en raison de "unrecognized_name" |
| APIRT-1346 | OAuth 2.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 la monétisation, 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 (plusieurs 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) |