4.17.09 - 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

La nouvelle fonctionnalité la plus importante de cette version est la prise en charge du langage SAML (Security Assertion Markup Language) 2.0 comme mécanisme d'authentification pour Edge, API BaaS et le portail des services pour les développeurs. En utilisant SAML avec Edge, vous pouvez activer SSO pour l'UI et l'API Edge, en plus de tous les autres services que vous fournissez et qui sont également compatibles avec SAML.

L'authentification SAML offre plusieurs avantages. Avec SAML, vous pouvez effectuer les opérations suivantes :

• Contrôlez entièrement la gestion des utilisateurs. Lorsque des utilisateurs quittent votre organisation et qu'ils sont déprovisionnés de manière centralisée, ils se voient automatiquement refuser l'accès à Edge.
• Contrôlez la façon dont les utilisateurs s'authentifient pour accéder à Edge. Vous pouvez choisir différents types d'authentification pour différentes organisations Edge.
• Contrôlez les règles d'authentification. Votre fournisseur SAML peut accepter des règles d'authentification plus conformes aux normes de votre entreprise.
• Vous pouvez surveiller les connexions, les déconnexions, les tentatives de connexion infructueuses et les activités à haut risque sur votre déploiement Edge.
• Notez que SAML n'est utilisé que pour l'authentification. L'autorisation est toujours contrôlée par les rôles utilisateur Edge.

Pour en savoir plus, consultez Prise en charge de SAML sur Edge pour le cloud privé.

Cette version inclut un certain nombre d'autres fonctionnalités notables, dont les suivantes :

• Possibilité de migrer le portail de services pour les développeurs d'Apache/MySQL vers Postgres/Nginx
• Commande permettant de désactiver TLS dans l'interface utilisateur Edge
• Nouvelles propriétés pour configurer l'installation Edge
• Règles de dénomination personnalisées pour la clé et le code secret du client
• Compatibilité avec Red Hat/CentOS version 7.4

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.

Abandons

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

Le magasin sécurisé Apigee, également appelé "coffres-forts", est abandonné et sera supprimé en avril 2018. Les coffres-forts, qui fournissent un stockage chiffré des paires clé/valeur, 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)

Obsolescence de l'ajout de chemins 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)

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 de la compatibilité avec SAML dans Edge, API BaaS et le portail des services pour les développeurs

Edge est désormais compatible avec SAML (Security Assertion Markup Language) 2.0 en tant que mécanisme d'authentification pour Edge, API BaaS et le portail des services pour les développeurs. SAML est compatible avec un environnement d'authentification unique (SSO). En utilisant SAML, vous pouvez activer SSO pour Edge, en plus de tous les autres services que vous fournissez et qui sont également compatibles avec SAML.

Consultez Compatibilité avec SAML sur Edge pour Private Cloud.

Ajout de l'utilitaire apigee-ssoadminapi.sh

Après avoir activé SAML, vous utilisez le nouvel outil apigee-ssoadminapi.sh pour effectuer de nombreuses tâches administratives, comme la création d'utilisateurs et d'organisations.

Consultez Utiliser apigee-ssoadminapi.sh.

(DOS-5118)

Possibilité de migrer le portail Developer Services d'Apache/MySQL/MariaDB vers Nginx/PostgreSQL

Une installation du portail de services pour les développeurs basée sur .tar utilise Apache et MySQL ou MariaDB. Vous pouvez désormais migrer votre installation existante du portail pour utiliser Nginx et Postgres. Cette migration est obligatoire si vous souhaitez passer à la version 4.17.09 du portail.

Consultez Convertir un portail basé sur tar en portail basé sur RPM.

Ajout de la compatibilité avec Red Hat/CentOS version 7.4

Vous pouvez désormais déployer Edge pour le cloud privé, API BaaS et le portail de services pour les développeurs sur Red Hat/CentOS version 7.4.

Consultez Logiciels et versions compatibles.

Ajout d'une propriété pour que le programme d'installation vérifie les exigences en matière de processeur et de mémoire lors de l'installation

Le fichier de configuration de l'installation Edge accepte désormais la propriété suivante :

ENABLE_SYSTEM_CHECK=y 

Si la réponse est "y", le programme d'installation vérifie que le système répond aux exigences de processeur et de mémoire pour le composant en cours d'installation. Consultez les exigences d'installation pour connaître les exigences de chaque composant. La valeur par défaut est "n" pour désactiver la vérification.

Consultez la documentation de référence sur le fichier de configuration Edge.

(DOS-4772)

Ajout d'une propriété permettant de sélectionner l'adresse IP utilisée par le programme d'installation sur un serveur doté de plusieurs cartes d'interface

Si un serveur possède plusieurs cartes d'interface, la commande "hostname -i" renvoie une liste d'adresses IP séparées par un espace. Par défaut, le programme d'installation Edge utilise la première adresse IP renvoyée, qui peut ne pas être correcte dans toutes les situations. Vous pouvez également définir la propriété suivante dans le fichier de configuration de l'installation :

ENABLE_DYNAMIC_HOSTIP=y

Si cette propriété est définie sur "y", le programme d'installation vous invite à sélectionner l'adresse IP à utiliser lors de l'installation. La valeur par défaut est "n".

Consultez la documentation de référence sur le fichier de configuration Edge.

(DOS-5117)

Nouvelles options d'UI et API disponibles pour configurer TLS

La version bêta de la nouvelle fonctionnalité TLS/SSL en libre-service pour le cloud est désormais disponible dans le Private Cloud en tant que fonctionnalité bêta. Cette version bêta vous permet de :

• Créer, modifier et supprimer des keystores et des truststores dans l'interface utilisateur et l'API
• Importer des certificats TLS au format PKCS12/PFX
• Générer des certificats autosignés à partir de l'UI ou de l'API
• Tester la validité d'un keystore ou d'un truststore dans l'UI

La documentation bêta (PDF) de ces fonctionnalités est disponible à l'adresse suivante :

• Utiliser l'interface utilisateur Edge Cloud pour créer des magasins de clés et des magasins de certificats de confiance
• Utiliser l'API Edge pour créer des magasins de clés et des magasins de confiance

Pour en savoir plus, consultez la documentation supplémentaire (PDF) :

• Options de configuration de TLS
• Configurer l'accès TLS à une API pour le cloud
• Configurer TLS d'Edge au backend
• Mettre à jour un certificat TLS pour le cloud

(EDGEUI-1058)

Ajout de la commande de mot de passe obscurci

Ajout d'une commande permettant de générer un mot de passe obscurci afin que n'importe quel composant puisse générer un mot de passe chiffré. Vous pouvez générer un mot de passe obscurci à l'aide de la commande suivante sur le serveur de gestion Edge :

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Saisissez le nouveau mot de passe, puis confirmez-le lorsque vous y êtes invité. Pour des raisons de sécurité, le texte du mot de passe n'est pas affiché. Cette commande renvoie le mot de passe au format suivant :

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Consultez Configurer TLS/SSL pour Edge On-Premises.

(TBD-250)

Ajout d'une nouvelle commande pour masquer le nouveau mot de passe lors de la modification du mot de passe d'un utilisateur de l'organisation

Pour réinitialiser le mot de passe d'un utilisateur de l'organisation, vous devez maintenant utiliser l'utilitaire apigee-service pour appeler apigee-openldap :

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Vous êtes invité à saisir le mot de passe de l'administrateur système, puis celui du nouvel utilisateur. Pour des raisons de sécurité, le texte des mots de passe ne s'affiche pas lorsque vous les saisissez.

Consultez Réinitialiser les mots de passe Edge.

(DBS-1733)

Ajouter une commande pour désactiver TLS dans l'interface utilisateur Edge

Vous pouvez maintenant utiliser la commande suivante pour désactiver TLS dans l'interface utilisateur Edge :

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

Consultez Configurer TLS pour l'interface utilisateur de gestion.

(EDGEUI-1114)

Ajout d'une propriété permettant de contrôler le format de l'horodatage dans les messages du journal

Par défaut, le code temporel des messages de journal créés par la règle de journalisation des messages se présente au format suivant :

yyyy-MM-dd'T'HH:mm:ss.sssZ

Exemple :

2017-05-08T13:33:00.000+0000

Vous pouvez utiliser la propriété conf_system_apigee.syslogger.dateFormat sur le processeur de messages Edge pour contrôler ce format.

Consultez la page Règle MessageLogging.

(APIRT-4196)

Ajout d'un nouveau paramètre de configuration SMTP requis pour l'installation d'API BaaS

Vous devez désormais utiliser le paramètre SMTPMAILFROM dans le fichier de configuration de l'installation de l'API BaaS. Ce paramètre spécifie l'adresse e-mail utilisée lorsque l'API BaaS envoie des e-mails automatiques, par exemple lorsqu'un utilisateur demande à réinitialiser un mot de passe.

Consultez la documentation de référence sur le fichier de configuration BaaS.

(APIBAAS-2103)

Ajout de la prise en charge pour permettre au routeur Edge et au serveur Web Nginx du portail d'accéder aux ports inférieurs à 1000

Vous pouvez désormais utiliser le routeur et le serveur Web Nginx pour le portail afin d'accéder aux ports inférieurs à 1000 sans avoir à les exécuter en tant qu'utilisateur différent. Dans les versions précédentes, le routeur et le serveur Web Nginx ne pouvaient pas accéder aux ports inférieurs à 1000 sans les exécuter en tant qu'utilisateur spécial.

Modification de la configuration du niveau de journalisation pour l'interface utilisateur Edge

Les propriétés utilisées pour configurer le niveau de journalisation de l'interface utilisateur Edge ont changé. Consultez Définir le niveau de journalisation pour un composant Edge pour connaître les nouvelles propriétés et la nouvelle procédure.

(EDGEUI-886)

Services d'API

Règles de dénomination personnalisées pour la clé et le code secret du client

Les règles de dénomination et la validation ont été mises à jour pour la création d'une clé et d'un secret client personnalisés pour une application de développeur. Les clés et les secrets client peuvent contenir des lettres, des chiffres, des traits de soulignement et des tirets. Aucun autre caractère spécial n'est autorisé.

Le processus de création de clés/secrets personnalisés est plus détaillé dans Importer des clés et des secrets client existants. (MGMT-3916)

Validation du nom du keystore et du serveur cible

Les noms des magasins de clés et des serveurs cibles ne peuvent pas dépasser 255 caractères. Ils peuvent contenir des lettres, des chiffres, des espaces, des traits d'union, des traits de soulignement et des points. Edge valide désormais cette valeur au moment de la création. (MGMT-4098)

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.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (gestion des API et exécution)

Cloud 17.07.31 (gestion des API)

Cloud 17.07.17 (gestion et exécution des API)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (Monétisation)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (gestion des API)

Cloud 17.05.08 (UI)

Cloud 17.04.22 (gestion des API)

Problèmes connus

Cette version présente les problèmes connus suivants :