Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Le mardi 2 juin 2015, nous avons lancé une nouvelle version cloud d'Apigee Edge.
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.
Disponibilité générale de SmartDocs
SmartDocs passe de la version bêta à la disponibilité générale. Voici quelques-unes des mises à jour et des nouvelles fonctionnalités:
- Prise en charge de Swagger 2.0, y compris l'importation par fichier ou URL, et compatibilité avec les objets de sécurité portant un nom personnalisé.
- Améliorations apportées à la conception visuelle des modèles qui génèrent des SmartDocs.
- Amélioration de la facilité d'utilisation et des workflows dans le portail des développeurs, via le menu Contenu > SmartDocs de Drupal.
- Le processus d'authentification par "jeton personnalisé" s'appelle désormais "clé API".
- Objets "sécurité" de l'authentification définis au niveau de la révision
- Configuration de l'authentification du client au niveau du modèle. Les nouvelles révisions ne réinitialisent plus les identifiants client SmartDocs préconfigurés.
Pour obtenir d'autres descriptions de fonctionnalités, consultez cet article de blog.
Pour la documentation sur SmartDocs, consultez Utiliser SmartDocs pour documenter des API.
Nouvel éditeur de proxy d'API (bêta)
Une nouvelle version bêta de l'éditeur de proxys d'API est disponible. Pour y accéder, cliquez sur le lien "Accéder à la version bêta" lorsque vous modifiez un proxy d'API existant. Vous pouvez basculer entre les versions "classique" et "bêta".
Nouvelle règle OAuthV2
La nouvelle règle DeleteOAuthV2Info vous permet de supprimer des codes d'autorisation et des jetons d'accès. Pour en savoir plus, consultez la section Supprimer la règle d'informations OAuthV2.
Nouvelles entités dans la règle d'entité d'accès
La règle d'entité d'accès permet d'accéder aux nouvelles entités suivantes: champ d'application des clés client, code d'autorisation, jeton de requête et vérificateur. Pour en savoir plus, consultez la section Stratégie d'entité d'accès.
Affichage des certificats SSL bientôt arrivés à expiration
La page "Certificats SSL" de l'interface utilisateur de gestion (Administration > Certificats SSL) indique quand les certificats SSL expirent dans un délai de 10, 15, 30 ou 90 jours, en fonction de votre sélection dans le nouveau champ déroulant d'expiration.
Nom de l'application du développeur affiché dans l'UI de gestion
Les applications de développement dans Edge ont à la fois un nom interne qui ne change pas et un nom d'affichage que vous pouvez modifier. Sur la page d'une application de développeur dans l'interface utilisateur de gestion (Publier > Applications de développement > Nom de l'application), le "Nom" interne de l'application s'affiche avec le "Nom à afficher". Il est ainsi plus facile d'identifier visuellement les applications grâce à leur nom interne à des fins de dépannage et de gestion des API.
Version classique des rapports personnalisés supprimés de l'interface utilisateur de gestion
La version classique facultative des rapports d'analyse personnalisés n'est plus disponible dans l'interface utilisateur de gestion.
Processus de mise à niveau de SmartDocs
Si vous avez déjà utilisé SmartDocs pendant la phase bêta, vous devez mettre à niveau SmartDocs dans votre portail des développeurs pour profiter des nouvelles fonctionnalités de la version en disponibilité générale.
Toutes les pages SmartDocs déjà publiées sur votre portail des développeurs continueront de fonctionner, mais vous devrez suivre le processus de mise à jour avant de modifier ou de publier des modifications apportées à des pages nouvelles ou existantes.
Gardez à l'esprit que bien que vous puissiez afficher et publier des SmartDocs sur votre portail des développeurs, les SmartDocs sont générés à partir du modèle d'API qui réside dans les services de gestion d'API Edge d'Apigee. Toutes les modifications que vous apportez à un modèle d'API dans Edge sont les mêmes dans tous vos environnements Pantheon (de la même manière que les développeurs existent dans les environnements Pantheon).
Pour passer de la version bêta de SmartDocs à la disponibilité générale
- Mettez à jour et testez la version 15.05.27 dans votre environnement dev ou test sur Pantheon.
- Créez un modèle pour remplacer tout modèle d'API existant que vous utilisez.
- Si vous avez importé des documents Swagger ou WADL, réimportez-les dans une nouvelle révision.
- Si vous avez géré votre modèle d'API via le module SmartDocs, exportez-le au format JSON SmartDocs et importez-le dans votre nouveau modèle à l'aide d'un fichier en pièce jointe.
- Définissez les propriétés de sécurité de la révision de votre modèle. Sur la page Contenu > SmartDocs > Modèle, sélectionnez Paramètres de sécurité.
- Vérifiez toute authentification préconfigurée sur la page des paramètres du modèle (Contenu > SmartDocs) en cliquant sur Paramètres dans la colonne "Opérations".
- Mettez à jour les modèles personnalisés pour utiliser la version 6 des éléments CSS et JS, et apportez les modifications nécessaires pour refléter les nouveaux noms d'objets, tels que authSchemes et apiSchema. Pour en savoir plus sur la mise à jour des modèles SmartDocs, consultez Utiliser SmartDocs pour documenter des API.
- Effectuez un nouveau rendu et publiez la révision de votre modèle.
- Après avoir validé la nouvelle documentation, mettez à jour votre portail de production vers la version 15.05.27.
Si vous êtes un client Edge Enterprise et que vous avez des questions ou des préoccupations concernant le processus de mise à niveau, veuillez envoyer un e-mail à marsh@apigee.com et cnovak@apigee.com. Sinon, veuillez faire appel à la communauté Apigee pour obtenir une réponse optimale.
Bugs résolus
Les bugs suivants sont résolus dans cette version.
| ID du problème | Description |
|---|---|
| TBD-72 | Problème lié aux règles de journalisation des messages |
| MGMT-2124 | Les autorisations du rôle client sont réinitialisées lors de l'enregistrement des autorisations dans l'UI |
| MGMT-2048 | Un utilisateur disposant d'un rôle personnalisé qui limite les autorisations de déploiement à un environnement peut être déployé dans d'autres environnements |
| MGMT-2041 | Supprimer l'élément FaultRules du modèle de pièce jointe par défaut L'élément FaultRules, qui n'est pas utilisé dans les stratégies ni dans les étapes de proxy d'API, n'est plus ajouté automatiquement lorsque vous créez des proxys d'API ou ajoutez des règles. |
| MGMT-2034 | La récupération du WSDL renvoie une erreur: "Erreur de récupération WSDL: Erreur lors du traitement du WSDL." |
| MGMT-1812 | Ajouter la validation TargetEndpoint lors de l'importation Comme pour ProxyEndpoint, le TargetEndpoint sera validé pour le schéma et les expressions appropriés utilisés dans les conditions lors de l'importation du proxy d'API. |
| MGMT-1345 | L'importation de WSDL avec plusieurs espaces de noms génère une étape SOAP de compilation incorrecte |
| MGMT-800 | La création d'une ressource nommée "default" entraîne un dysfonctionnement de l'interface utilisateur |
| MGMT-602 | Vue Développement du proxy d'API: ajout d'une stratégie de cache de réponse lorsque le point de terminaison ne comporte pas de PreFlow/PostFlow provoque une erreur |
| MGMT-460 | Le changement de nom d'une règle entraîne un comportement glitch, une règle en double qui ne peut pas être supprimée |
| DEVRT-1565 | Intervalles de 15 minutes pour les DÉBITS |
| AXAPP-1728 | Ignorer les variables de monétisation dans Analytics |
| AXAPP-1690 | "Erreur d'API non valide" dans les rapports personnalisés |
| AXAPP-1533 | La GeoMap d'analyse génère une erreur d'appel d'API non valide |
| APIRT-52 | Rapports personnalisés: le code d'état de la réponse pour de nombreuses API est nul |