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

La nouvelle fonctionnalité la plus importante de cette version est la prise en charge de la sécurité SAML 2.0 (Assertion Markup Language) comme mécanisme d'authentification pour Edge, l'API BaaS et le Portail de services pour les développeurs En utilisant SAML avec Edge, vous pouvez prendre en charge l'authentification unique pour l'interface utilisateur et l'API Edge en plus de tous les autres services que vous fournissez et qui prennent également en charge le protocole 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 déprovisionné de manière centralisée, l'accès à Edge est automatiquement refusé.
• Contrôlez la façon dont les utilisateurs s'authentifient pour accéder à Edge. Vous pouvez choisir différentes méthodes d'authentification pour les différentes organisations Edge.
• Contrôler les règles d'authentification Votre fournisseur SAML est peut-être compatible avec les règles d'authentification davantage 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 en périphérie.
• Notez que SAML n'est utilisé que pour l'authentification. L'autorisation est toujours contrôlée par Edge de rôles utilisateur spécifiques.

Reportez-vous à la section Compatibilité avec SAML sur Edge pour Private Cloud pour plus d'informations.

Cette version inclut un certain nombre d'autres fonctionnalités notables:

• 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é client et le secret
• Compatibilité avec Red Hat/CentOS version 7.4

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.

Abandons

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

La solution Apigee ou de "coffre-forts", est en cours d'abandon et sera supprimé en avril 2018. Les coffres-forts, qui permettent de stocker des paires clé/valeur de manière chiffrée, sont créés avec l'API de gestion. et accessibles au moment de l'exécution avec des fonctions dans le module Node.js apigee-access.

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)

Abandon 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 "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)

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é

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

Edge prend désormais en charge le langage SAML (Security Assertion Markup Language) 2.0 comme protocole d'authentification pour Edge, API BaaS et le portail de services pour les développeurs. SAML prend en charge l'authentification unique (SSO). En utilisant SAML, vous pouvez prendre en charge le SSO pour Edge en plus de tout autre service que vous fournissez et qui sont également compatibles SAML.

Reportez-vous à la section Compatibilité avec SAML sur Edge pour Private Cloud.

Ajout de l'utilitaire apigee-ssoadminapi.sh

Après avoir activé le protocole SAML, vous utilisez le nouveau fichier apigee-ssoadminapi.sh pour effectuer de nombreuses opérations tâches administratives, telles que la création d'utilisateurs et d'organisations.

Reportez-vous à la section Utilisation apigee-ssoadminapi.sh.

(DOS-5118)

Possibilité de migrer le portail de services pour les développeurs d'Apache/MySQL/MariaDB vers Nginx/postgres

Une installation du portail de services pour les développeurs au format .tar utilise Apache et MySQL ou MariaDB. Vous pouvez maintenant migrer votre installation existante du portail pour utiliser Nginx et Postgres. Ce la migration est requise si vous souhaitez passer à la version du portail 4.17.09.

Reportez-vous à la section Convertir un tar vers un portail basé sur RPM.

Ajout de la prise en charge de Red Hat/CentOS version 7.4

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

Consultez la section Logiciels et assistances compatibles version.

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 du processeur et de la mémoire pour d'un composant en cours d'installation. Consultez la section Conditions d'installation pour les exigences de chaque composant. La valeur par défaut est "n" pour désactiver la vérification.

Voir Edge Documentation de référence du fichier de configuration

(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 plusieurs cartes d'interface

Si un serveur possède plusieurs cartes d'interface, le "nom d'hôte -i" renvoie des valeurs séparées par un espace liste d'adresses IP. Par défaut, le programme d’installation Edge utilise la première adresse IP renvoyée, qui peuvent ne pas être correctes 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 comme de l'installation. La valeur par défaut est "n".

Voir Edge Documentation de référence du fichier de configuration

(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 la Cloud privé en version bêta. Grâce à cette version bêta, vous pouvez:

• 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) sur ces fonctionnalités est disponible à l'adresse suivante:

• Utiliser l'interface utilisateur Edge Cloud pour créer des keystores et des Truststores
• Utiliser l'API Edge pour créer des keystores et des Truststores

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 obscurcie

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é mot de passe. Vous pouvez générer un mot de passe obscurci à l'aide de la commande suivante sur le périphérique Serveur de gestion:

> /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 le mot de passe ne s'affiche pas. Cette commande renvoie le mot de passe au format suivant:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Voir la section Configuration de TLS/SSL pour Edge On Premises.

(À déterminer – 250)

Ajout d'une commande pour obscurcir le nouveau mot de passe lorsque vous modifiez le nom d'utilisateur d'une organisation mot de passe

Pour réinitialiser le mot de passe d'un utilisateur de l'organisation, vous utilisez maintenant 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 ne s'affiche pas au fur et à mesure que vous les saisissez.

Voir Réinitialisation du bord Mots de passe.

(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

Voir Configuration de TLS pour l'UI 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, le code temporel des messages de journal créés par la règle de journalisation des messages est associé au paramètre format:

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

Exemple :

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

Vous pouvez utiliser 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 maintenant utiliser le paramètre SMTPMAILFROM dans l'API BaaS fichier de configuration d'installation. 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.

Voir BaaS Documentation de référence du fichier de configuration

(APIBAAS-2103).

Ajout de la possibilité d'autoriser le routeur Edge et le serveur Web Nginx pour le portail à accéder aux ports inférieure à 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 Nginx web serveur ne pouvait 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 pour l'interface utilisateur Edge ont été modifiées. Voir Le fait de définir le niveau de journalisation un composant Edge pour les nouvelles propriétés et la nouvelle procédure.

(EDGEUI-886)

Services d'API

Règles d'attribution de noms personnalisées pour la clé client et le secret

Les règles d'attribution de noms et la validation ont été mises à jour pour Créer une clé et un code secret client personnalisés pour une application de développeur Les clés et secrets des clients peuvent contenir des lettres, des chiffres, des traits de soulignement et des traits d'union. Aucun autre caractère spécial n'est autorisé.

Pour en savoir plus sur le processus de création d'une clé et d'un code secret personnalisés, consultez l'article Importer un client existant clés et secrets. (MGMT-3916)

Validation du nom du keystore et du serveur cible

Les noms des keystores et des serveurs cibles ne peuvent pas comporter plus de 255 caractères et 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 d'exécution)

Cloud 17.07.31 (gestion des API)

Cloud 17.07.17 (gestion des API et d'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: