4.17.05 - Notes de version d'Edge for Private Cloud

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Depuis la version précédente de Edge for Private Cloud, les versions suivantes ont s'est produite et sont incluses dans cette version de fonctionnalité:

Reportez-vous à la section À propos de la version la numérotation pour comprendre comment déterminer si une version spécifique du cloud inclus dans votre version d'Edge pour Private Cloud.

Présentation de la version

Cette version inclut un certain nombre de fonctionnalités notables qui vous permettent de mieux contrôler et sécuriser API, y compris:

• Les flux partagés sont compatibles avec le déploiement sans temps d'arrêt.
• Il est désormais possible de supprimer des données de monétisation pour une organisation.
• Les nouvelles fonctionnalités supplémentaires sont décrites ci-dessous.

Les coffres-forts sont désormais obsolètes.

La suite de cette rubrique contient des informations détaillées sur toutes les nouvelles fonctionnalités, mises à jour et corrections de bugs. dans l'album.

Abandons et suppressions

Les fonctionnalités suivantes ont été abandonnées ou supprimées dans cette version. Consultez la règle d'obsolescence Edge pour plus d'informations.

Retiré: ajout chemins d'accès dans l'onglet Performance 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 "Performance" et créez différents chemins pour une comparaison basée sur un graphique des données du proxy dans l'onglet "Performances" et dans le tableau de bord "Transactions commerciales". Cette fonctionnalité a été supprimée n'est plus disponible dans l'UI. Pour une alternative à cette fonctionnalité, consultez la documentation Apigee Article de la communauté: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html (EDGEUI-902)

Retraité: URL buildInfo du portail de services pour les développeurs

Dans les versions précédentes du portail, vous avez ouvert les éléments suivants pour déterminer la version de votre portail : URL dans un navigateur:

http://yourportal.com/buildInfo

Cette association a été supprimée dans la version 4.17.05. Pour déterminer la version, ouvrez la page Rapports > Entrée de menu "Rapport d'état" dans Drupal. La version du portail apparaît dans le tableau de la ligne nommée Install profile (Installer le profil).

Abandon d'Apigee stockage sécurisé (coffres-forts)

La solution Apigee ou de "coffre-forts", est en cours d'abandon et sera supprimé un an après date de l'annonce de l'abandon affichée sur la Les abandons et la page "Suppressions". Des coffres-forts, qui permettent de stocker des paires clé/valeur de manière chiffrée, sont créés avec l'API de gestion et accessible au moment de l'exécution avec les fonctions de la couche apigee-access le module Node.js.

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

Nouvelles fonctionnalités et mises à jour

Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations de cette version. En plus des éléments suivants, Cette version inclut également de multiples fonctionnalités en termes de facilité d'utilisation, de performances, de sécurité et de stabilité améliorations.

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 d'installation Edge. Ce paramètre spécifie l'adresse e-mail utilisé lorsque Edge envoie des e-mails automatisés, par exemple lorsqu'un utilisateur demande la réinitialisation d'un mot de passe. Voir Installez les composants Edge sur un Node.js pour en savoir plus.

(EDGEUI-1020)

Possibilité de définir le délai d'inactivité utilisé par l'interface utilisateur Edge pour les appels de gestion d'API Edge

Vous pouvez maintenant spécifier le délai d'expiration de l'API utilisé par l'interface utilisateur Edge pour contrôler la durée de l'interface utilisateur attend le retour d'un appel de gestion d'API. Les propriétés suivantes définissent ce délai:

• Ensembles conf_apigee_apigee.feature.apitimeout durée, en secondes, pendant laquelle l'interface utilisateur attend qu'un appel au backend soit renvoyé, quel que soit le l'activité sur celui-ci. Si l'appel n'est pas terminé dans ce délai, l'interface utilisateur génère une erreur de délai d'inactivité. La la valeur par défaut est de 180 secondes (3 minutes).
• conf_apigee_play.ws.timeout.idle définit comment long temps que l'UI attend, en millisecondes, d'une activité sur le serveur. Elle peut être définie sur la même valeur en tant que conf_apigee_apigee_apitimeout ou sur une valeur inférieure. La définition d'une valeur plus élevée n'a aucun effet. La valeur par défaut est 180 000 millisecondes (3 minutes).
• Ensembles conf_apigee_play.ws.timeout.connection le temps d'attente de l'interface utilisateur pour qu'une connexion soit établie. Elle peut être définie sur la même valeur en tant que conf_apigee_apigee_apitimeout ou sur une valeur inférieure. La définition d'une valeur plus élevée n'a aucun effet. La valeur par défaut est 120 000 millisecondes (2 minutes).

Reportez-vous à la section Définir le délai avant expiration utilisé par l'interface utilisateur Edge pour les appels de gestion des API Edge.

(EDGEUI-816)

Ajout d'un délai avant expiration du processeur de messages aux routeurs

Ajout d'un délai avant expiration pour que les routeurs arrêtent de relancer une requête aux processeurs de messages et renvoie une s'affiche.

Reportez-vous à la section Configuration au routeur pour relancer les connexions à un processeur de messages.

(APIRT-2912).

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

La documentation est désormais incluse pour modifier l'administrateur système par défaut.

Voir la section Gestion Utilisateurs, rôles et autorisations.

(DOS-4895).

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

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

Voir Installation Edge Présentation.

(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. Beaucoup de ces e-mails contiennent un lien. Par exemple, lorsqu'un utilisateur est ajouté organisation, l'interface utilisateur Edge envoie à l'utilisateur un e-mail contenant une URL de connexion au format suivant:

https://domain/login

Le domaine est déterminé automatiquement par Edge et il convient généralement à l'organisation. Toutefois, il est possible que lorsque l'interface utilisateur Edge se trouve derrière un équilibreur de charge, la fonction le nom de domaine généré est incorrect. Si tel 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.

Reportez-vous à la section Définir le paramètre nom d'hôte des liens dans les e-mails générés pour en savoir plus.

(EDGEUI-1044)

Définition de 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 écran peut inclure le numéro de port du routeur l'hôte virtuel.

Dans la plupart des cas, l'URL affichée dans l'interface utilisateur Edge est l'URL correcte pour rendre les fichiers externes de requêtes envoyées au proxy. Toutefois, pour certaines configurations, l'URL affichée est incorrecte. Par exemple, pour l'une des configurations suivantes, l'URL affichée peut ne pas s'afficher correspond à 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 port a lieu entre un équilibreur de charge et des routeurs Apigee.
• Un équilibreur de charge configuré avec la réécriture des chemins d'accès

Edge pour Private Cloud 4.17.05 et versions ultérieures prennent en charge un attribut sur l'hôte virtuel appelé &lt;BaseUrl&gt; qui vous permet remplacer l'URL affichée par l'interface utilisateur Edge. Voici un exemple illustrant l'objet hôte virtuel avec la nouvelle interface &lt;BaseURL&gt; . Dans cet exemple, la valeur http://myCo.com apparaît 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 &lt;BaseUrl&gt; n'est pas défini, la valeur par défaut, l'URL par défaut rendue par l'interface utilisateur Edge apparaîtra sous la forme : "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 lors de la création d'une organisation en utilisant la propriété VHOST_BASEURL avec le paramètre apigee-provision utilitaire.

Voir la section Configuration de TLS l'accès à une API pour le cloud privé.

(EDGEUI-5008)

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

Une documentation a été ajoutée pour décrire comment activer/désactiver la journalisation de débogage pour Edge composants.

Consultez la section Activer la journalisation du débogage. pour en savoir plus.

(APIRT-4018)

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

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

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

Voir Importation de l'API Traffic Data to Apigee - Beta Release.

Nouveau répertoire d'installation par défaut après la mise à jour du portail des services pour les développeurs de Nginx/Postgres à partir d'une nouvelle installation 4.17.01

Après la mise à jour d'une nouvelle installation de la version 4.17.01 qui utilise Nginx/Postgres, le répertoire racine modifié à partir 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 plus stricte des entrées a été appliquée à toutes les entités de l'organisation Apigee Edge. Les caractères autorisés sont généralement des lettres (toutes lettres majuscules), des chiffres et des traits de soulignement.

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 des ressources (accroche Java, xlsx, toutes les ressources)
• Keystores
• CRLstores
• Références de ressources
• Serveurs cibles

(MGMT-3840)

Déploiement sans temps d'arrêt des flux partagés

Lorsque vous souhaitez déployer des flux partagés et vous assurer que peu ou pas de trafic entrant est rejeté pendant le déploiement, vous pouvez désormais utiliser une API de gestion du déploiement sans temps d'arrêt. La procédure est la suivante : presque identique au déploiement sans temps d'arrêt pour les proxys d'API à l'aide de l'API de gestion. La seule est la ressource de l'API de gestion.

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

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 des données de monétisation pour une organisation

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

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

Pour en savoir plus, consultez Supprimer des 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 afin d'activer la monétisation pour une organisation.

Voir 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 (environnement d'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)