4.17.09 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation d'Apigee Edge.
Accéder à la documentation sur Apigee X en savoir plus

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

Consultez la section À propos de la numérotation des versions pour comprendre comment déterminer si une version cloud spécifique est incluse dans votre version d'Edge pour 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 en tant que mécanisme d'authentification pour Edge, l'API BaaS et le portail des services pour les développeurs. En utilisant SAML avec Edge, vous pouvez activer l'authentification unique pour l'UI et l'API Edge, ainsi que pour 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 :

• Prenez le contrôle total de la gestion des utilisateurs. Lorsque des utilisateurs quittent votre organisation et que leur provisionnement est déprovisionné de manière centralisée, l'accès à Edge leur est automatiquement refusé.
• 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ôler 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 d'utilisateur Edge.

Pour en savoir plus, consultez la section Compatibilité SAML sur Edge pour Private Cloud.

Cette version inclut un certain nombre d'autres fonctionnalités notables, y compris 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 d'Edge
• Règles de dénomination des clés et secrets client personnalisés
• Compatibilité avec Red Hat/CentOS version 7.4

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

Abandons et suppressions

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

Abandons

Abandon du store sécurisé Apigee (coffres-forts)

Le store sécurisé Apigee, également appelé "vaults", est en cours d'abandon et sera supprimé en avril 2018. Les vaults, 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 les 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 la section Travailler avec des mappages clé-valeur. Les KVM chiffrées sont tout aussi sécurisées que les coffres-forts et offrent plus d'options de création et de récupération. (MGMT-3848)

Abandon de l'ajout de chemins dans l'onglet "Performances" du proxy d'API

Avant cette version, vous pouviez accéder à un proxy d'API dans l'UI 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 une alternative à cette fonctionnalité, consultez l'article suivant de la communauté Apigee: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html. (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 plusieurs améliorations de l'usabilité, des performances, de la sécurité et de la stabilité.

Cloud privé

Prise en charge SAML ajoutée à Edge, API BaaS et portail de services pour les développeurs

Edge accepte désormais le langage SAML (Security Assertion Markup Language) 2.0 comme mécanisme d'authentification pour Edge, l'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 prendre en charge l'authentification unique 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é le protocole SAML, vous allez maintenant utiliser le nouveau fichier apigee-ssoadminapi.sh pour effectuer de nombreuses tâches administratives, telles que la création d'utilisateurs et d'organisations.

Consultez Utiliser apigee-ssoadminapi.sh.

(DOS-5118).

Vous pouvez désormais migrer le portail des services pour les développeurs d'Apache/MySQL/MariaDB vers Nginx/Postgres.

Une installation du portail de services dédiés aux développeurs basée sur un fichier .tar utilise Apache et MySQL ou MariaDB. Vous pouvez désormais migrer votre installation existante du portail vers 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 RPM.

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

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

Consultez la section Logiciels compatibles et versions compatibles.

Ajout d'une propriété permettant au programme d'installation de vérifier les exigences de processeur et de mémoire lors de l'installation

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

ENABLE_SYSTEM_CHECK=y 

Si la valeur est "y", le programme d'installation vérifie que le système répond aux exigences de processeur et de mémoire du composant en cours d'installation. Consultez la section Conditions requises pour l'installation pour connaître les conditions requises pour 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é pour vous permettre de sélectionner l'adresse IP utilisée par le programme d'installation sur un serveur comportant 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 des espaces. Par défaut, l'installateur d'Edge utilise la première adresse IP renvoyée, ce qui peut ne pas être correct dans toutes les situations. Vous pouvez également définir la propriété suivante dans le fichier de configuration d'installation:

ENABLE_DYNAMIC_HOSTIP=y

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

Consultez la section Documentation de référence sur les fichiers de configuration Edge.

(DOS-5117)

Nouvelles options d'interface utilisateur 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 cloud privé en tant que fonctionnalité bêta. Grâce à cette version bêta, vous pouvez:

• Créer, modifier et supprimer des keystores et des truststores dans l'UI 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 sur:

• Utiliser l'interface utilisateur Edge Cloud pour créer des keystores et des truststores
• Créer des keystores et des truststores à l'aide de l'API Edge

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
• Configuration du protocole TLS de 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 pour 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 à l'invite. 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 sur site.

(À déterminer – 250)

Ajout d'une commande pour obscurcir 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 d'une organisation, vous devez désormais 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 le nouveau mot de passe utilisateur. Pour des raisons de sécurité, le texte des mots de passe n'est pas affiché 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 d'Edge

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

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

Consultez la section Configurer TLS pour l'interface utilisateur de gestion.

(EDGEUI-1114)

Ajout d'une propriété pour contrôler le format du code temporel dans les messages de journal

Par défaut, l'horodatage des messages de journal créés par la règle de journalisation des messages est 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 obligatoire à l'installation de l'API BaaS

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

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

(APIBAAS-2103)

Prise en charge ajoutée pour permettre au routeur Edge et au serveur Web Nginx du portail d'accéder aux ports inférieurs à 1 000.

Vous pouvez désormais utiliser le routeur et le serveur Web Nginx pour que le portail accède aux ports inférieurs à 1 000 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 à 1 000 sans les exécuter en tant qu'utilisateur spécial.

Modification de la méthode de 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é. Pour connaître les nouvelles propriétés et la procédure, consultez Définir le niveau de journalisation pour un composant Edge.

(EDGEUI-886)

Services d'API

Règles de dénomination des clés et secrets client personnalisés

Les règles d'attribution de noms 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 de consommateur existants. (MGMT-3916)

Validation du nom du magasin de clés et du serveur cible

Les noms des keystores et des serveurs cibles ne doivent 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 cela 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 des API et exécution)

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: