4.17.05 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Depuis la précédente version de fonctionnalité Edge pour le cloud privé, les versions suivantes ont été publiées et sont incluses dans cette version de fonctionnalité :

Consultez À propos de la numérotation des versions pour savoir comment déterminer si une version cloud spécifique est incluse dans votre version d'Edge for Private Cloud.

Présentation de la version

Cette version inclut plusieurs fonctionnalités importantes qui vous aident à mieux contrôler et sécuriser vos API, y compris :

• Les flux partagés sont compatibles avec le déploiement sans interruption.
• Il est désormais possible de supprimer les données de monétisation pour une organisation.
• D'autres nouvelles fonctionnalités sont décrites ci-dessous.

En ce qui concerne l'obsolescence, les coffres-forts ont été abandonnés.

Le reste de cette rubrique contient des informations détaillées sur toutes les nouvelles fonctionnalités, mises à jour et corrections de bugs incluses dans la version.

Arrêts et suppressions

Les fonctionnalités suivantes ont été abandonnées ou supprimées dans cette version. Pour en savoir plus, consultez les Règles d'abandon d'Edge.

Suppression de l'ajout de chemins d'accès dans l'onglet "Performances" du proxy d'API

Jusqu'à cette version, vous pouviez accéder à un proxy d'API dans l'interface utilisateur de gestion, accéder à l'onglet "Performances" et créer différents chemins pour une comparaison basée sur des graphiques dans l'onglet "Performances" du proxy et dans le tableau de bord "Transactions commerciales". Cette fonctionnalité a été abandonnée et n'est plus disponible dans l'interface utilisateur. Pour trouver une alternative à cette fonctionnalité, consultez l'article de la communauté Apigee suivant : Alternative à l'API Business Transactions. (EDGEUI-902)

Retiré : URL buildInfo pour le portail Developer Services

Dans les versions précédentes du portail, pour déterminer la version de votre portail, vous ouvriez l'URL suivante dans un navigateur :

http://yourportal.com/buildInfo

Ce lien a été supprimé dans la version 4.17.05. Pour déterminer la version, ouvrez l'entrée de menu Rapports > Rapport d'état dans Drupal. La version du portail s'affiche dans le tableau, sur la ligne Install profile (Profil d'installation).

Arrêt du Secure Store (coffres-forts) Apigee

Le magasin sécurisé Apigee, également appelé "coffres-forts", est abandonné et sera supprimé un an après la date de l'annonce de l'abandon indiquée sur la page Abandon et suppression. Les coffres-forts, qui permettent de stocker des paires clé/valeur chiffrées, sont créés avec l'API de gestion et accessibles au moment de l'exécution avec des fonctions du module Node.js apigee-access.

Au lieu d'utiliser le magasin sécurisé, utilisez des mappages clé-valeur (KVM) chiffrés, comme décrit dans Travailler avec des mappages clé-valeur. Les KVM chiffrés sont aussi sécurisés que les coffres-forts et offrent plus d'options de création et de récupération. (MGMT-3848)

Nouvelles fonctionnalités et mises à jour

Voici les nouvelles fonctionnalités et améliorations apportées à cette version. En plus des améliorations suivantes, cette version contient également de nombreuses améliorations en termes d'usabilité, de performances, de sécurité et de stabilité.

Cloud privé

Ajout d'un nouveau paramètre de configuration SMTP obligatoire à l'installation

Vous devez désormais utiliser le paramètre SMTPMAILFROM dans le fichier de configuration de l'installation Edge. Ce paramètre spécifie l'adresse e-mail utilisée par Edge lors de l'envoi d'e-mails automatiques, par exemple lorsqu'un utilisateur demande à réinitialiser un mot de passe. Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

(EDGEUI-1020)

Vous pouvez désormais définir le délai d'attente utilisé par l'UI Edge pour les appels de gestion de l'API Edge.

Vous pouvez désormais spécifier la durée du délai avant expiration de l'API utilisée par l'UI Edge pour contrôler la durée pendant laquelle l'UI attend le retour d'un appel de gestion des API. Les propriétés suivantes définissent le délai avant expiration :

• conf_apigee_apigee.feature.apitimeout définit le délai en secondes pendant lequel l'UI attend le retour d'un appel au backend, quelle que soit l'activité sur celui-ci. Si l'appel n'est pas terminé dans ce délai, l'UI génère une erreur de délai avant expiration. La valeur par défaut est de 180 secondes (3 minutes).
• conf_apigee_play.ws.timeout.idle définit la durée pendant laquelle l'UI attend une activité sur le serveur (en millisecondes). Elle peut être définie sur la même valeur que conf_apigee_apigee_apitimeout ou sur une valeur inférieure. Définir une valeur plus élevée n'a aucun effet. La valeur par défaut est de 180 000 millisecondes (3 minutes).
• conf_apigee_play.ws.timeout.connection définit la durée pendant laquelle l'UI attend l'établissement d'une connexion. Elle peut être définie sur la même valeur que conf_apigee_apigee_apitimeout ou sur une valeur inférieure. Définir une valeur plus élevée n'a aucun effet. La valeur par défaut est de 120 000 millisecondes (2 minutes).

Pour en savoir plus, consultez Définir le délai d'attente utilisé par l'interface utilisateur Edge pour les appels de gestion des API Edge.

(EDGEUI-816)

Ajout du délai avant nouvelle tentative du processeur de messages aux routeurs

Ajout d'un délai d'inactivité pour que les routeurs cessent de réessayer d'envoyer une requête aux processeurs de messages et renvoient un message d'erreur.

Pour en savoir plus, consultez Configurer le routeur pour qu'il réessaie les connexions à un processeur de messages.

(APIRT-2912)

Ajout d'une procédure pour modifier l'administrateur système par défaut

La documentation inclut désormais la procédure permettant de modifier l'administrateur système par défaut.

Pour en savoir plus, consultez Gérer les utilisateurs, les rôles et les autorisations.

(DOS-4895)

Ajout d'une documentation sur la séparation des tâches d'installation d'Edge entre les utilisateurs racine et non racine

Une nouvelle documentation décrit les étapes à suivre pour séparer les tâches d'installation d'Edge entre l'utilisateur racine et l'utilisateur non racine.

Pour en savoir plus, consultez Présentation de l'installation Edge.

(DOS-4573)

Ajout d'une propriété permettant de définir le nom d'hôte des liens dans les e-mails générés

Edge envoie automatiquement des e-mails en réponse à certains événements, par exemple lorsqu'un utilisateur est ajouté à une organisation. La plupart de ces e-mails contiennent un lien. Par exemple, lorsqu'un nouvel utilisateur est ajouté à une organisation, l'interface utilisateur Edge lui envoie un e-mail contenant une URL de connexion au format suivant :

https://domain/login

Le domaine est déterminé automatiquement par Edge et est généralement correct pour l'organisation. Toutefois, il est possible que le nom de domaine généré automatiquement soit incorrect lorsque l'interface utilisateur Edge se trouve derrière un équilibreur de charge. Si c'est le cas, vous pouvez utiliser la propriété conf_apigee_apigee.emails.hosturl pour définir explicitement la partie nom de domaine de l'URL générée.

Pour en savoir plus, consultez Définir le nom d'hôte pour les liens dans les e-mails générés.

(EDGEUI-1044)

Définir l'URL de base affichée par l'interface utilisateur Edge pour un proxy d'API

L'interface utilisateur Edge affiche l'URL d'un proxy d'API en fonction des paramètres de l'hôte virtuel correspondant à l'emplacement où le proxy est déployé. Cet affichage peut inclure le numéro de port du routeur de l'hôte virtuel.

Dans la plupart des cas, l'URL affichée dans l'interface utilisateur Edge est l'URL correcte pour effectuer des requêtes externes au proxy. Toutefois, pour certaines configurations, l'URL affichée n'est pas correcte. Par exemple, l'une des configurations suivantes peut entraîner une non-correspondance entre l'URL affichée et l'URL réelle utilisée pour envoyer des requêtes externes au proxy :

• La terminaison SSL se produit au niveau d'un équilibreur de charge.
• Le mappage de ports a lieu entre un équilibreur de charge et les routeurs Apigee.
• Équilibreur de charge configuré avec la réécriture de chemin d'accès

Edge for Private Cloud 4.17.05 et versions ultérieures sont compatibles avec un attribut sur l'hôte virtuel appelé <BaseUrl>, qui vous permet de remplacer l'URL affichée par l'UI Edge. Voici un exemple montrant l'objet hôte virtuel avec le nouvel attribut <BaseURL>. Dans cet exemple, la valeur http://myCo.com s'affiche dans l'interface utilisateur Edge :

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Si <BaseUrl> n'est pas défini (valeur par défaut), l'URL par défaut affichée par l'interface utilisateur Edge se présente comme suit : http://DNS_name_or_IP:9005/, alors que la configuration réelle de l'alias d'hôte est http://myCo.com.

Vous pouvez également définir l'URL de base lorsque vous créez une organisation à l'aide de la propriété VHOST_BASEURL avec l'utilitaire apigee-provision.

Pour en savoir plus, consultez Configurer l'accès TLS à une API pour le cloud privé.

(EDGEUI-5008)

Ajout de la documentation sur l'activation de la journalisation de débogage

La documentation a été ajoutée pour décrire comment activer/désactiver la journalisation du débogage pour les composants Edge.

Pour en savoir plus, consultez Activer la journalisation de débogage.

(APIRT-4018)

Nouveau programme d'installation et nouvelle syntaxe de commande pour l'utilitaire apigee-analytics-collector

Tous les clients Edge pour le cloud privé doivent envoyer à Apigee des statistiques sur le trafic de proxy d'API à l'aide de la version bêta de l'utilitaire en ligne de commande apigee-analytics-collector. Cet utilitaire renvoie le rapport sur le volume d'appels d'API à Apigee.

Cette version d'Edge contient de nouvelles instructions d'installation et une nouvelle syntaxe de commande pour l'utilitaire apigee-analytics-collector. Dans cette version, vous utilisez désormais apigee-service pour installer l'utilitaire apigee-analytics-collector au lieu de npm, et vous appelez l'utilitaire apigee-analytics-collector via apigee-service au lieu d'une commande autonome.

Pour en savoir plus, consultez Importer des données de trafic d'API dans Apigee – Version bêta.

Nouveau répertoire d'installation par défaut après la mise à jour du portail Developer Services de Nginx/Postgres à partir d'une nouvelle installation 4.17.01

Après la mise à jour d'une nouvelle installation de 4.17.01 utilisant Nginx/Postgres, le répertoire racine est passé de :

/opt/apigee/apigee-drupal

par :

/opt/apigee/apigee-drupal/wwwroot

Services d'API

Validation des entrées plus stricte pour les entités

Une validation des entrées plus stricte a été appliquée à toutes les entités de l'organisation Apigee Edge. Les caractères autorisés sont généralement les lettres (toutes les majuscules et minuscules), les chiffres et les traits de soulignement.

Voici quelques-unes des entités concernées :

• Organisations
• Environnements
• Proxys d'API
• Révisions du proxy d'API
• Noms des règles dans le proxy d'API
• ID de configuration du masque de trace de débogage
• Noms de ressources (appel Java, xsl, toutes les ressources)
• Keystores
• CRLstores
• Références de ressources
• Serveurs cibles

(MGMT-3840)

Déploiement sans interruption des flux partagés

Si vous souhaitez déployer des flux partagés et vous assurer qu'aucun trafic entrant (ou très peu) n'est rejeté lors du déploiement, vous pouvez désormais utiliser une API de gestion du déploiement sans temps d'arrêt. La procédure est presque identique au déploiement sans temps d'arrêt pour les proxys d'API à l'aide de l'API Management. La seule différence réside dans la ressource de l'API Management.

L'appel suivant déploie la révision du flux partagé indiquée dans l'URI, puis annule le déploiement de la révision précédemment déployée (le paramètre de requête override=true permet cela) :

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monétisation

Supprimer les données de monétisation pour une organisation

Vous pouvez supprimer les données de monétisation de votre organisation dans les cas suivants :

• Supprimez votre organisation. Dans ce cas, vous devez supprimer les données de monétisation avant de pouvoir supprimer l'organisation.
• Effacez les données de monétisation d'une organisation de test que vous souhaitez réutiliser. Dans ce cas, vous devez synchroniser les données Apigee Edge après avoir supprimé les données de monétisation.

Pour en savoir plus, consultez Supprimer les données de monétisation de votre organisation. (DEVRT-2581)

Ajout d'une API permettant d'activer la monétisation pour une organisation

Vous pouvez désormais utiliser une API pour activer la monétisation d'une organisation.

Pour en savoir plus, consultez Activer la monétisation pour une organisation.

(DEVRT-2383)

Bugs résolus

Les bugs suivants sont résolus dans cette version. Cette liste s'adresse principalement aux utilisateurs qui veulent vérifier si leurs demandes d'assistance ont été corrigées. Elle n'est pas conçue pour fournir des informations détaillées à tous les utilisateurs.

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (monétisation)

Cloud 17.03.13.01 (monétisation)

Cloud 17.03.13 (gestion des API)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (exécution de l'API)

Cloud 17.02.13 (gestion des API)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (gestion des API)

Cloud 17.01.16 (monétisation)