Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
Le mardi 19 mai 2015, nous avons lancé une version trimestrielle d'Apigee Edge pour le cloud privé.
L'ancien nom de 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
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
Voici 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 Apigee Edge pour le cloud privé à l'aide de WebSockets.
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 administratifs d'API. Pour en savoir plus, consultez le guide Configuration de l'authentification externe pour Edge pour le cloud privé.
Co-branding dans l'UI de gestion
Vous pouvez co-marquer l'UI de gestion Edge avec votre propre logo personnalisé, qui s'affiche à côté du logo Apigee. Pour en savoir plus, consultez la section "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 journalisation Node.js dans la vue Trace de l'éditeur de proxy d'API. Pour activer cette 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 la journalisation Node.js, consultez
Débogage et dépannage
des 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 entraînait également l'expiration du mot de passe de l'administrateur système, de sorte que l'administrateur système était bloqué dans Edge.
Lorsque vous effectuez une mise à niveau vers la version 4.15.04.00, la valeur par défaut est modifiée de sorte que les mots de passe n'expirent pas. Si
nécessaire, vous pouvez configurer l'expiration des mots de passe Edge à l'aide du
/opt/apigee4/bin/apigee-enable-pwlockout.sh script. Pour en savoir plus, consultez le
Guide des opérations Apigee Edge pour le cloud privé.
Limiter l'accès de l'administrateur système à des domaines de messagerie spécifiques
Vous pouvez limiter l'appartenance 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 à l'écran de manière plus efficace.
Nouvelles variables de défaillance OAuthV2
Ces nouvelles variables liées aux défaillances 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 la défaillance. Par exemple, invalid_request
- oauthv2.<policy_name>.<fault_cause> : raison de la défaillance. 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 le nom du produit en plus du nom à afficher.
Consultez http://apigee.com/docs/developer-services/content/creating-api-products.
UI pour 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 clarifier 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'UI de gestion
Sur les pages "Proxys d'API", "Produits", "Développeurs" et "Applications" de l'UI de gestion, de nouvelles options de filtrage sont disponibles pour la recherche.
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 Offline Trace.
Rôles utilisateur affichés dans les paramètres utilisateur
Sur la page "Paramètres utilisateur" de l'UI de gestion (nom d'utilisateur > Paramètres utilisateur), les rôles de l'utilisateur sont désormais affichés.
Améliorations apportées à l'UI de gestion Edge
Cette version inclut un certain nombre de petites améliorations en termes de convivialité et de cohérence dans l'UI de gestion Edge.
Services d'analyse
Voici les nouvelles fonctionnalités et améliorations apportées aux services d'analyse Edge.
Six mois de données disponibles
Lorsque vous générez des rapports d'analyse avec l'UI de gestion ou l'API, 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 à l'analyse
Les nouvelles variables suivantes sont transmises à l'analyse Edge et sont visibles dans l'étape 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 cibles 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 dans le 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. Ils s'affichaient auparavant en bas des pages principales de ces entités. Vous pouvez désormais accéder aux graphiques en sélectionnant 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'explorer chaque métrique. Consultez Tableau de bord Apigee.
- Performances de proxy (nouveau) : affiche les modèles de trafic des proxys d'API et les temps de traitement. Remplace le tableau de bord "Performances de proxy d'API". Consultez API Proxy Performances.
- Composition du trafic (révisé) : apparence, contenu et fonctionnement du tableau de bord entièrement révisés. Mesure la contribution relative de vos principaux produits, développeurs, applications et API à l'ensemble de votre programme d'API. Consultez Composition du trafic.
- Analyse des erreurs (révisé) : apparence, contenu et fonctionnement entièrement révisés et contenu. Affiche les taux d'erreur pour les proxys d'API et les cibles. Consultez 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 performance pour les cibles de backend de proxy d'API. Consultez Performances des cibles performance.
- Engagement des partenaires a été renommé Engagement des développeurs : vous indique quels sont les développeurs d'applications enregistrés qui génèrent le plus de trafic 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.
Compatibilité avec Swagger 2.0 pour SmartDocs
SmartDocs est compatible avec l'importation de documents de spécification Swagger 2.0 et maintient 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" .
Gestion séparée 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 de monétisation, les entreprises restent un filtre principal, bien que le libellé du filtre soit passé de "Développeurs" à "Entreprises".
Bugs résolus
Les bugs suivants sont résolus dans cette version.
| ID du problème | Description |
|---|---|
| OPDK-954 | Le schéma Cassandra 4.15.01 n'est pas mis à niveau |
| MGMT-1986 | Erreur d'UI 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 lors de la 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, n'échoue plus. |
| MGMT-1894 | **La page "Applications de développeur" ne se charge jamais pour la colonne "Développeur"** |
| MGMT-1872 | Impossible de télécharger des rapports personnalisés |
| MGMT-1777 | Impossible d'ajouter un utilisateur avec une adresse e-mail dont le TLD est .acn |
| MGMT-1362 | L'e-mail "Mot de passe oublié" ne fonctionne pas si l'adresse e-mail contient
'_' Résout le problème de réinitialisation du mot de passe dans le cloud privé avec les adresses e-mail contenant un trait de soulignement. |
| CORERT-613 | Échecs de 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 l'installateur 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 pour terminer l'installation/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) |