Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
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 sur site" ou "OPDK" est désormais "Apigee Edge pour le cloud privé".
Pour toute question, contactez l'assistance client Apigee.
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 à Edge API Services.
WebSockets
Pour permettre 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 en savoir plus sur la configuration et l'utilisation de WebSockets dans Edge, consultez le guide Apigee Edge pour le cloud privé à l'aide de WebSockets.
Prise en charge des 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 contenant vos utilisateurs administratifs de l'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'interface utilisateur d'Apigee" du guide d'opérations d'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 le journal Node.js, consultez la section 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, cela a également entraîné l'expiration du mot de passe de l'administrateur système, ce qui l'a empêché d'accéder à Edge.
Lorsque vous passez à la version 4.15.04.00, la valeur par défaut change pour que les mots de passe n'expirent pas. Si nécessaire, vous pouvez configurer les mots de passe Edge pour qu'ils expirent à l'aide du script /opt/apigee4/bin/apigee-enable-pwlockout.sh. Pour en savoir plus, consultez le guide d'opérations d'Apigee Edge pour le cloud privé.
Limiter l'accès des administrateurs système à des domaines de messagerie spécifiques
Vous pouvez limiter l'appartenance aux rôles administrateur système ou 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 d'opérations d'Apigee Edge pour le cloud privé.
Messages d'erreur de l'interface utilisateur de gestion
L'affichage des messages d'erreur dans l'UI de gestion a été repensé pour utiliser l'espace de l'écran plus efficacement.
Nouvelles variables de panne OAuthV2
Ces nouvelles variables liées aux erreurs sont définies par la règle OAuthV2:
- oauthV2.<nom-de-règle>.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 la page 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 la page http://apigee.com/docs/developer-services/content/creating-api-products.
Interface utilisateur pour 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'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 la section Utiliser l'outil de traçage hors connexion.
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 s'affichent désormais.
Améliorations apportées à l'interface utilisateur de la gestion des périphéries
Cette version inclut de nombreuses améliorations mineures de l'usabilité et de la cohérence dans l'interface utilisateur de gestion d'Edge.
Services d'analyse
Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations apportées à Edge Analytics Services.
Données disponibles sur six mois
Lorsque vous générez des rapports d'analyse avec l'UI 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.
Variables ajoutées aux données analytiques
Les nouvelles variables suivantes sont transmises à l'analyse Edge, visible à l'étape AX de la fenêtre de suivi du proxy d'API.
- apigee.edge.execution.is_target_error : vous permet de déterminer si les erreurs de l'API sont des erreurs côté cible (valeur "1") ou des erreurs non ciblées 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 : permet d'identifier si une règle a échoué (valeur "1") ou si aucune règle n'a échoué dans une réponse HTTP non réussie (valeur "0"). La valeur est nulle pour une réponse HTTP réussie.
Les variables associées suivantes fournissent des informations sur la règle qui a échoué en premier. Les valeurs sont nulles si aucune règle n'a échoué.- apigee.edge.execution.fault_policy_name : nom de la règle ayant échoué.
- apigee.edge.execution.fault_flow_name : nom du flux de 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 sur les performances des API, des développeurs, des produits et des applications de développeur ont été déplacés. Ils apparaissaient auparavant au bas des pages principales de ces entités. Pour y accéder, sélectionnez l'onglet Analytics en haut de chaque page.
- Cette version inclut des travaux importants sur les tableaux de bord existants ou nouveaux suivants :
- Tableau de bord Apigee (révisé): comprend trois graphiques de métriques: trafic proxy, engagement des développeurs et applications des développeurs. Chaque graphique propose une vue "Plus de détails" qui vous permet d'examiner en détail chaque métrique. Consultez le 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 la section Performances des proxys d'API.
- Composition du trafic (révisé): le tableau de bord a été entièrement repensé en termes d'apparence et de contenu. Mesure la contribution relative de vos API, applications, développeurs et produits principaux par rapport à l'ensemble de votre programme d'API. Consultez Composition du trafic.
- Analyse des erreurs (révisée): apparence et contenu entièrement révisés. Indique 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 suivants ont été renommés:
- Performances du point de terminaison a été renommé Performances de la cible: affiche les modèles de trafic et les métriques de performances pour les cibles de backend de proxy d'API. Consultez la section Performances des cibles.
- Engagement des partenaires a été renommé Engagement des développeurs: indique 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 la section Engagement des développeurs.
Services pour les développeurs
Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations apportées aux services de développement 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 prise en charge des objets de schéma de sécurité et des schémas centralisés sera disponible dans une prochaine version.
Monétisation
Vous trouverez ci-dessous 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'interface utilisateur de gestion propose désormais des fenêtres distinctes pour "Entreprises" et "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, 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 | Le schéma Cassandra 4.15.01 n'est pas mis à niveau |
| MGMT-1986 | Erreur de l'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 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 de pourcentage, ne provoque plus d'erreur. |
| MGMT-1894 | La page "Applications du 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 de réinitialisation du mot de passe ne fonctionne pas si l'adresse e-mail contient un '_' Résolution du problème de réinitialisation du mot de passe dans Private Cloud avec des adresses e-mail contenant un trait de soulignement. |
| CORERT-613 | Échecs de handshake SSL en raison de "unrecognized_name" |
| APIRT-1346 | OAuth2.0 : la 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 pour terminer l'installation/la mise à niveau de la monétisation:
|
| CORERT-318 | Les appels d'API avec des charges utiles volumineuses (des 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 (la valeur par défaut est 10) |