Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
Le mardi 2 juin 2015, nous avons lancé une nouvelle version cloud d'Apigee Edge.
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.
Disponibilité générale de SmartDocs
SmartDocs passe de la version bêta à la disponibilité générale. Voici les mises à jour et les nouvelles fonctionnalités:
- Compatibilité avec Swagger 2.0, y compris l'importation par fichier ou URL, y compris la compatibilité avec les objets de sécurité nommés de manière personnalisée.
- Améliorations de la conception visuelle dans les modèles qui génèrent des SmartDocs.
- Améliorations de l'usabilité et du workflow dans le portail des développeurs, disponibles dans le menu "Contenu > SmartDocs" de Drupal.
- L'authentification "Jeton personnalisé" s'appelle désormais "Clé API".
- Objets "sécurité" d'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 en savoir plus sur les fonctionnalités, consultez cet article de blog.
Pour en savoir plus sur SmartDocs, consultez Utiliser SmartDocs pour documenter les API.
Nouveau nouvel éditeur de proxys d'API (bêta)
Une nouvelle version bêta de l'éditeur de proxy 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 éditeurs "classique" et "bêta".
Nouvelle règle OAuthV2
La nouvelle règle DeleteOAuthV2Info vous permet de supprimer les codes d'autorisation et les jetons d'accès. Pour en savoir plus, consultez la section Règle de suppression des informations OAuthV2.
Nouvelles entités dans la règle d'entité des accès
La règle d'accès aux entités permet d'accéder aux nouvelles entités suivantes: consumerkey-scopes, authorizationcode, requesttoken et verifier. Pour en savoir plus, consultez la section Règle AccessEntity.
Affichage des certificats SSL sur le point d'expirer
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 champ déroulant "Nouvelle date d'expiration".
Nom de l'application du développeur affiché dans l'UI de gestion
Les applications de développement dans Edge ont un nom interne qui ne change pas et un nom à afficher que vous pouvez modifier. Sur une page d'application de développeur dans l'UI de gestion (Publier > Applications de développeur > nom de l'application), le nom interne de l'application s'affiche avec le nom à afficher, ce qui permet d'identifier plus facilement les applications par leur nom interne pour le dépannage et la gestion des API.
Suppression de la version classique des rapports personnalisés de l'interface utilisateur de gestion
La version classique facultative des rapports d'analyse personnalisés n'est plus disponible dans l'UI de gestion.
Processus de mise à niveau de SmartDocs
Si vous utilisiez déjà SmartDocs pendant la période bêta, vous devez mettre à niveau SmartDocs dans votre portail pour les développeurs pour profiter des nouvelles fonctionnalités de la version disponible pour tous.
Les pages SmartDocs déjà publiées dans votre portail pour les développeurs continueront de fonctionner, mais vous devez suivre la procédure de mise à jour avant de modifier ou de publier des modifications apportées à des pages existantes ou nouvelles.
N'oubliez pas que, même si vous pouvez afficher et publier des SmartDocs dans votre portail des développeurs, ils sont générés à partir du modèle d'API qui se trouve dans les services de gestion des API Edge d'Apigee. Toutes les modifications que vous apportez à un modèle d'API dans Edge seront les mêmes dans tous vos environnements Pantheon (comme les développeurs dans les environnements Pantheon).
Passer de la version bêta de SmartDocs à la version disponible pour tous les utilisateurs
- Mettez à jour et testez la version 15.05.27 dans vos environnements dev ou test sur Pantheon.
- Créez un modèle pour remplacer tout modèle d'API existant que vous utilisiez.
- Si vous avez importé des documents Swagger ou WADL, importez-les à nouveau 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, puis importez-le dans votre nouveau modèle à l'aide d'une 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 qu'ils utilisent la version 6 des composants CSS et JS, et apportez les modifications nécessaires pour refléter les nouveaux noms d'objets, tels que authSchemes et apiSchema. Pour savoir comment mettre à jour des modèles SmartDocs, consultez Utiliser SmartDocs pour documenter des API.
- Réaffichez et publiez la version 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 utiliser la communauté Apigee pour obtenir la meilleure réponse.
Bugs résolus
Les bugs suivants sont résolus dans cette version.
| ID du problème | Description |
|---|---|
| TBD-72 | Problème lié à la règle de journalisation des messages |
| MGMT-2124 | Les autorisations du rôle client sont réinitialisées lors de l'enregistrement des autorisations dans l'interface utilisateur. |
| MGMT-2048 | Un utilisateur disposant d'un rôle personnalisé qui limite les autorisations de déploiement à un environnement peut effectuer des déploiements dans d'autres environnements. |
| MGMT-2041 | Suppression de l'élément FaultRules du modèle d'attachement par défaut L'élément FaultRules, qui n'est pas utilisé dans les règles ni dans les étapes du 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 fichier WSDL renvoie un échec: "Erreur de récupération du fichier WSDL: erreur de traitement du fichier WSDL". |
| MGMT-1812 | Ajouter la validation de TargetEndpoint lors de l'importation Comme pour ProxyEndpoint, le schéma et les expressions appropriés utilisés dans les conditions seront validés pour TargetEndpoint lors de l'importation du proxy d'API. |
| MGMT-1345 | L'importation d'un fichier WSDL avec plusieurs espaces de noms entraîne une étape de compilation SOAP incorrecte |
| MGMT-800 | Créer une ressource avec le nom "default" entraîne une interface utilisateur défectueuse |
| MGMT-602 | Vue "Develop" du proxy d'API: l'ajout d'une règle de cache de réponse lorsque le point de terminaison ne dispose pas de PreFlow/PostFlow entraîne une erreur |
| MGMT-460 | Le changement de nom d'une règle entraîne un comportement défectueux et une règle en double qui ne peut pas être supprimée. |
| DEVRT-1565 | Intervalles de 15 minutes pour les CHARGES |
| AXAPP-1728 | Ignorer les variables de monétisation dans les données analytiques |
| AXAPP-1690 | Erreur"API non valide" dans les rapports personnalisés |
| AXAPP-1533 | Geomap Analytics génère une erreur d'appel d'API non valide |
| APIRT-52 | Rapports personnalisés: le code d'état de réponse de nombreuses API est nul |