Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Le mardi 19 mai 2015, nous avons publié une version trimestrielle d'Apigee Edge pour le cloud privé.
L'ancien nom de produit "Apigee Edge sur site" ou "OPDK" a été remplacé par "Apigee Edge pour le cloud privé".
Pour toute question, consultez le service 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 de cette version.
OpenLDAP : installation et mise à niveau
OpenLDAP est désormais le seul serveur LDAP pris en charge par Edge pour les nouvelles installations et les mises à niveau.
Services d'API
Voici les nouvelles fonctionnalités et améliorations des services d'API Edge.
WebSockets
Pour permettre les communications Web en temps réel entre un client et un serveur Web, Edge accepte le protocole WebSocket. Edge peut jouer le rôle de client ou de serveur dans les communications WebSocket. Pour plus d'informations 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 externe pour la gestion des API
Edge s'intègre à Active Directory et à d'autres fournisseurs d'authentification/systèmes LDAP externes contenant les administrateurs de vos API. Pour en savoir plus, consultez le guide Configuration de l'authentification externe Edge pour le cloud privé.
Co-branding dans l'interface utilisateur de gestion
Vous pouvez co-brander l'interface utilisateur de gestion Edge avec votre propre logo personnalisé, qui s'affiche à côté du logo Apigee. Pour plus d'informations, consultez la section "Ajout d'un logo personnalisé au menu de l'interface utilisateur Apigee" dans le guide des opérations Apigee Edge pour le cloud privé.
Journaux Node.js dans Trace
Lors du débogage des proxys d'API Node.js, vous pouvez activer la fonctionnalité de journalisation Node.js dans la vue "Trace" de l'éditeur de proxys d'API. Pour activer cette fonctionnalité, définissez apigee.feature.disableNodeJSLogs="false" dans le fichier apigee-base.conf ou apigee-onstaging.conf de votre installation. Pour en savoir plus sur le journal Node.js, consultez la page Déboguer et dépanner les proxys Node.js.
Expiration du mot de passe
Dans Edge 4.15.01.x, les mots de passe Edge ont expiré automatiquement au bout de 30 jours. Un utilisateur perdait son accès à moins de modifier son mot de passe avant qu'il n'expire. Cependant, cela a également entraîné l'expiration du mot de passe de l'administrateur système, ce qui a empêché l'administrateur système d'accéder à Edge.
Lorsque vous passez à la version 4.15.04.00, le paramètre par défaut change afin 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 plus d'informations, consultez le guide des opérations d'Apigee Edge pour le cloud privé.
Limitation de l'accès des administrateurs système à des domaines de messagerie spécifiques
Vous pouvez limiter l'appartenance aux rôles "sysadmin" ou "sysadmin" 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'utilisation d'Apigee Edge pour le cloud privé.
Messages d'erreur de l'interface utilisateur de gestion
Refonte de l'affichage des messages d'erreur dans l'interface utilisateur de gestion pour une utilisation plus efficace de l'espace d'affichage.
Nouvelles variables d'erreur OAuthV2
Ces nouvelles variables liées aux pannes sont définies par la stratégie OAuthV2:
- oauthV2.<policy-name>.failed : défini sur "true" en cas d'échec de la règle.
- oauthv2.<policy_name>.<fault_name> - Le nom de l'erreur. Exemple : invalid_request
- oauthv2.<policy_name>.<fault_cause> : raison de l'erreur. Par exemple: Jeton expiré
Voir 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.
Voir http://apigee.com/docs/developer-services/content/creating-api-products.
UI permettant de supprimer des utilisateurs d'une organisation
Sur la page "Utilisateurs de l'organisation" dans l'interface utilisateur, le bouton "Supprimer" a été remplacé par un bouton "Supprimer". Cela permet d'indiquer clairement que lorsque vous supprimez un utilisateur d'une organisation, son compte Apigee reste actif.
Voir http://apigee.com/docs/api-services/content/managing-organization-users.
Options de filtrage dans l'interface utilisateur de gestion
Sur les pages Proxies, Produits, Développeurs et Applications d'API de l'interface utilisateur de gestion, de nouvelles options de filtrage sont disponibles pour la recherche.
Outil de traçage hors connexion
L'outil de trace hors connexion 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 de traçage hors connexion est semblable à l'outil de traçage en direct.
Pour en savoir plus, consultez la page 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'interface utilisateur de gestion (nom d'utilisateur > Paramètres utilisateur), les rôles de l'utilisateur s'affichent.
Améliorations apportées à l'interface utilisateur de gestion en périphérie
Cette version inclut un certain nombre d'améliorations mineures en matière de convivialité et de cohérence dans l'interface utilisateur de gestion en périphérie.
Services d'analyse
Voici les nouvelles fonctionnalités et améliorations des services Edge Analytics.
Six mois de données disponibles
Lors de la génération de rapports d'analyse avec l'interface utilisateur ou l'API de gestion, les données datant 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 datant de plus de six mois, contactez l'assistance Apigee.
Variables ajoutées à Analytics
Les nouvelles variables suivantes sont transmises à Edge Analytics, visible à l'étape AX de la fenêtre de trace du proxy d'API.
- apigee.edge.execution.is_target_error - Vous permet de déterminer si les erreurs d'API sont des erreurs côté cible (valeur "1") ou non cibles en cas d'échec des réponses HTTP (valeur "0"). La valeur est nulle pour une réponse HTTP réussie.
-
apigee.edge.execution.is_policy_error - Vous permet de déterminer si une stratégie a échoué (valeur "1") ou si aucune stratégie n'a échoué dans une réponse HTTP ayant échoué (valeur "0"). La valeur est nulle pour une réponse HTTP réussie.
Les variables associées suivantes fournissent des détails 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 stratégie ayant échoué.
- apigee.edge.execution.fault_flow_name - Nom du flux de la stratégie qui a échoué (tel que PreFlow, PostFlow ou un flux défini par l'utilisateur).
- apigee.edge.execution.fault_flow_state - L'emplacement où la stratégie 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éveloppement ont été déplacés. Auparavant, elles s'affichaient au bas des pages principales de ces entités. Désormais, vous pouvez accéder aux graphiques en sélectionnant l'onglet Analytics en haut de chaque page.
- Cette version inclut des opérations importantes sur les tableaux de bord nouveaux ou existants :
- Tableau de bord Apigee (révision): comprend trois graphiques de métriques: trafic proxy, engagement des développeurs et applications pour les développeurs. Chaque graphique fournit une vue plus détaillée qui vous permet d'explorer chaque métrique. Consultez le tableau de bord Apigee.
- Proxy Performance (Nouveau): affiche les modèles de trafic et les temps de traitement des proxys d'API. Remplace le tableau de bord des performances des proxys d'API. Voir Performances des proxys d'API.
- Composition du trafic (version révisée): apparence et contenu du tableau de bord entièrement revus. Mesure la contribution relative de vos principaux API, applications, développeurs et produits à l'ensemble de votre programme d'API. Consultez la section Composition du trafic.
- Analyse des erreurs (version révisée): l'aspect et le contenu ont été entièrement revus. Affiche les taux d'erreur pour les mandataires et les cibles d'API. Consultez la page Tableau de bord d'analyse de code d'erreur.
-
Ces tableaux de bord existants ont été renommés:
- Performances des points de terminaison a été renommé Performances cibles: affiche les modèles de trafic et les métriques de performances pour les cibles backend des proxys d'API. Consultez la section Performances cibles.
- Engagement des partenaires a été renommé Engagement des développeurs, qui indique quels développeurs d'applications enregistrées génèrent le plus de trafic d'API. Pour chacun de vos développeurs, vous pouvez identifier qui génère le plus de trafic API et le plus d'erreurs. Voir Engagement des développeurs.
Services pour les développeurs
Voici les nouvelles fonctionnalités et améliorations des services pour les développeurs Edge.
Compatibilité de Swagger 2.0 avec SmartDocs
SmartDocs permet d'importer des documents de spécification Swagger 2.0 et assure la rétrocompatibilité avec Swagger 1.2. Les objets de schéma de sécurité et les schémas centralisés seront pris en charge dans une prochaine version.
Monétisation
Voici les nouvelles fonctionnalités et améliorations de 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 plusieurs entreprises aux développeurs et plusieurs développeurs aux entreprises. L'interface utilisateur de gestion fournit désormais des fenêtres "Sociétés" et "Développeurs" distinctes (accessible depuis le menu "Publier").
Consultez Gérer des entreprises et des 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 | 4.15.01 Le schéma Cassandra n'est pas mis à niveau |
| MGMT-1986 | Erreur d'UI lors de l'ajout d'un développeur |
| MGMT-1983 | Une API de code d'autorisation OAuth 2.0 renvoie un état incorrect |
| MGMT-1962 | Erreur lors de la connexion à l'interface utilisateur de gestion avec un mot de passe sécurisé La connexion à l'interface utilisateur à l'aide de certains caractères spéciaux tels que le signe de pourcentage n'échoue plus. |
| MGMT-1894 | Le chargement de la colonne des développeurs ne se termine jamais sur la page des applications pour développeurs |
| MGMT-1872 | Impossible de télécharger des rapports personnalisés |
| MGMT-1777 | Impossible d'ajouter un utilisateur dont l'adresse e-mail porte le domaine .acn |
| MGMT-1362 | L'adresse e-mail "Mot de passe oublié" ne fonctionne pas si l'adresse e-mail contient "_" Corrige 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 du handshake SSL en raison de "un certainementd_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 correctifs 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 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 comportant 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 (le paramètre par défaut est 10) |