Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Configurer TLS pour la nouvelle interface utilisateur Edge

Par défaut, vous accédez à la nouvelle interface utilisateur Edge via HTTP en utilisant l'adresse IP ou le nom DNS du nœud de la nouvelle interface utilisateur Edge et le port 3001. Exemple :

http://edge_UI_IP:3001

Vous pouvez également configurer l'accès TLS à la nouvelle interface utilisateur Edge afin d'y accéder sous la forme suivante :

https://edge_UI_IP:3001

Exigences TLS

La nouvelle interface utilisateur Edge est compatible avec TLS v1.2 et versions ultérieures. Si vous activez TLS sur la nouvelle interface utilisateur Edge, les utilisateurs doivent s'y connecter à l'aide d'un navigateur compatible avec TLS v1.2 ou version ultérieure.

Propriétés de configuration TLS

Exécutez la commande suivante pour configurer TLS pour la nouvelle interface utilisateur Edge :

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

où configFile est le fichier de configuration que vous avez utilisé pour installer ou configurer la nouvelle interface utilisateur Edge.

Avant d'exécuter cette commande, vous devez modifier le fichier de configuration pour définir les propriétés nécessaires qui contrôlent TLS. Le tableau suivant décrit les propriétés que vous utilisez pour configurer TLS pour la nouvelle interface utilisateur Edge :

Propriété	Description	Obligatoire ?
`MANAGEMENT_UI_SCHEME`	Définit le protocole ("http" ou "https") utilisé pour accéder à la nouvelle interface utilisateur Edge. La valeur par défaut est "http". Définissez-la sur "https" pour activer TLS : MANAGEMENT_UI_SCHEME=https	Oui
`MANAGEMENT_UI_TLS_OFFLOAD`	Si la valeur est "n", spécifie que les requêtes TLS adressées à la nouvelle interface utilisateur Edge sont arrêtées au niveau de cette interface. Vous devez définir `MANAGEMENT_UI_TLS_KEY_FILE` et `MANAGEMENT_UI_TLS_CERT_FILE`. Si la valeur est "y", spécifie que les requêtes TLS adressées à la nouvelle interface utilisateur Edge sont arrêtées sur un équilibreur de charge, et que l'équilibreur de charge transfère ensuite la requête à la nouvelle interface utilisateur Edge à l'aide de HTTP. Si vous arrêtez TLS sur l'équilibreur de charge, la nouvelle interface utilisateur Edge doit toujours savoir que la requête d'origine est arrivée via TLS. Par exemple, certains cookies ont un indicateur sécurisé défini. Vous devez définir `MANAGEMENT_UI_SCHEME` sur "https", sinon `MANAGEMENT_UI_TLS_OFFLOAD` est ignoré : MANAGEMENT_UI_SCHEME=https MANAGEMENT_UI_TLS_OFFLOAD=y	Oui
`MANAGEMENT_UI_TLS_KEY_FILE` `MANAGEMENT_UI_TLS_CERT_FILE`	Si `MANAGEMENT_UI_TLS_OFFLOAD=n`, spécifie le chemin absolu vers les fichiers de clé et de certificat TLS. Les fichiers doivent être au format PEM avec aucune phrase secrète et appartenir à l'utilisateur "apigee". L'emplacement recommandé pour ces fichiers est le suivant : /opt/apigee/customer/application/edge-management-ui Si ce répertoire n'existe pas, créez-le. Si `MANAGEMENT_UI_TLS_OFFLOAD=y`, omettez `MANAGEMENT_UI_TLS_KEY_FILE` et `MANAGEMENT_UI_TLS_CERT_FILE`. Ils sont ignorés, car les requêtes adressées à la nouvelle interface utilisateur Edge arrivent via HTTP.	Oui si `MANAGEMENT_UI_TLS_OFFLOAD=n`
`MANAGEMENT_UI_PUBLIC_URIS`	Si `MANAGEMENT_UI_TLS_OFFLOAD=n`, spécifie l'URL de la nouvelle interface utilisateur Edge. Définissez cette propriété en fonction d'autres propriétés du fichier de configuration. Exemple : MANAGEMENT_UI_PUBLIC_URIS=`$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT` Où : `MANAGEMENT_UI_SCHEME` spécifie le protocole ("http" ou "https"), comme décrit ci-dessus. `MANAGEMENT_UI_IP` spécifie l'adresse IP ou le nom DNS de la nouvelle interface utilisateur Edge. `MANAGEMENT_UI_PORT` spécifie le port utilisé par la nouvelle interface utilisateur Edge. Pour en savoir plus sur ces propriétés, consultez Configurer la nouvelle interface utilisateur Edge. Si `MANAGEMENT_UI_TLS_OFFLOAD=y` : `MANAGEMENT_UI_IP` spécifie l'adresse IP ou le nom DNS de l'équilibreur de charge, et non de la nouvelle interface utilisateur Edge. L'équilibreur de charge et la nouvelle interface utilisateur Edge doivent utiliser le même numéro de port pour les requêtes, par exemple 3001. Utilisez `MANAGEMENT_UI_PORT` pour spécifier le numéro de port sur l'équilibreur de charge et sur la nouvelle interface utilisateur Edge.	Oui
`MANAGEMENT_UI_TLS_ALLOWED_CIPHERS`	Définit la liste des algorithmes de chiffrement TLS disponibles sous forme de chaîne séparée par des virgules ou des espaces. Chaîne séparée par des virgules : MANAGEMENT_UI_TLS_ALLOWED_CIPHERS=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 Chaîne séparée par des espaces et placée entre guillemets doubles : MANAGEMENT_UI_TLS_ALLOWED_CIPHERS="TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"

Configurer TLS

Pour configurer l'accès TLS à la nouvelle interface utilisateur Edge :

Générez le certificat et la clé TLS sous forme de fichiers PEM sans phrase secrète. Exemple :
```
mykey.pem
mycert.pem
```
Il existe de nombreuses façons de générer un certificat et une clé TLS. Par exemple, vous pouvez exécuter la commande suivante pour générer un certificat et une clé non signés :
```
openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'
```
Remarque : En règle générale, vous n'utilisez pas de certificat ni de clé non signés dans un environnement de production.
Copiez les fichiers de clé et de certificat dans le répertoire /opt/apigee/customer/application/edge-management-ui. Si ce répertoire n'existe pas, créez-le.
Assurez-vous que le certificat et la clé appartiennent à l'utilisateur "apigee" :
```
chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem
```

Modifiez le fichier de configuration que vous avez utilisé pour installer la nouvelle interface utilisateur Edge afin de définir les propriétés TLS suivantes :

# Set to https to enable TLS.
MANAGEMENT_UI_SCHEME=https 
# Do NOT terminate TLS on a load balancer.
MANAGEMENT_UI_TLS_OFFLOAD=n

# Specify the key and cert. 
MANAGEMENT_UI_TLS_KEY_FILE=/opt/apigee/customer/application/edge-management-ui/mykey.pem
MANAGEMENT_UI_TLS_CERT_FILE=/opt/apigee/customer/application/edge-management-ui/mycert.pem

# Leave these properties set to the same values as when you installed the New Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

Exécutez la commande suivante pour configurer TLS :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
```
où configFile est le nom du fichier de configuration.

Le script redémarre la nouvelle interface utilisateur Edge. Après le redémarrage, la nouvelle interface utilisateur Edge est compatible avec l'accès via HTTPS. Si vous ne parvenez pas à vous connecter à la nouvelle interface utilisateur Edge après avoir activé TLS, effacez le cache du navigateur, puis réessayez de vous connecter.

Configurer la nouvelle interface utilisateur Edge lorsque la terminaison TLS s'effectue sur l'équilibreur de charge

Si vous disposez d'un équilibreur de charge qui transfère les requêtes à la nouvelle interface utilisateur Edge, vous pouvez choisir d'arrêter la connexion TLS sur l'équilibreur de charge, puis de faire en sorte que l' équilibreur de charge transfère les requêtes à la nouvelle interface utilisateur Edge via HTTP :

Schéma d'architecture montrant la terminaison TLS sur un équilibreur de charge transférant les requêtes HTTP vers la nouvelle interface utilisateur Edge (edge-management-ui) sur le port 3001

Cette configuration est compatible, mais vous devez configurer l'équilibreur de charge et la nouvelle interface utilisateur Edge en conséquence.

Pour configurer la nouvelle interface utilisateur Edge lorsque la terminaison TLS s'effectue sur l'équilibreur de charge :

Modifiez le fichier de configuration que vous avez utilisé pour installer la nouvelle interface utilisateur Edge pour définir les propriétés TLS suivantes :

REMARQUE : Lorsque vous activez TLS, vous devez transmettre le fichier de configuration complet que vous avez utilisé pour installer la nouvelle interface utilisateur Edge.
```
# Set to https to enable TLS
MANAGEMENT_UI_SCHEME=https
# Terminate TLS on a load balancer
MANAGEMENT_UI_TLS_OFFLOAD=y
# Set to the IP address or DNS name of the load balancer.
MANAGEMENT_UI_IP=LB_IP_DNS
# Set to the port number for the load balancer and New Edge UI.
# The load balancer and the New Edge UI must use the same port number.
MANAGEMENT_UI_PORT=3001

# Leave these properties set to the same values as when you installed the New Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
```
Si vous définissez MANAGEMENT_UI_TLS_OFFLOAD=y, omettez MANAGEMENT_UI_TLS_KEY_FILE et MANAGEMENT_UI_TLS_CERT_FILE. Ils sont ignorés, car les requêtes adressées à la nouvelle interface utilisateur Edge arrivent via HTTP.
Exécutez la commande suivante pour configurer TLS :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
```
où configFile est le nom du fichier de configuration.

Le script redémarre la nouvelle interface utilisateur Edge. Après le redémarrage, la nouvelle interface utilisateur Edge est compatible avec l'accès via HTTPS via l'équilibreur de charge. Si vous ne parvenez pas à vous connecter à la nouvelle interface utilisateur Edge après avoir activé TLS, effacez le cache du navigateur, puis réessayez de vous connecter.

Désactiver TLS sur la nouvelle interface utilisateur Edge

Pour désactiver TLS sur la nouvelle interface utilisateur Edge :

Modifiez le fichier de configuration que vous avez utilisé pour installer la nouvelle interface utilisateur Edge afin de définir la propriété TLS suivante :

REMARQUE : Lorsque vous désactivez TLS, vous devez transmettre le fichier de configuration complet que vous avez utilisé pour installer la nouvelle interface utilisateur Edge.
```
# Set to http to disable TLS.
MANAGEMENT_UI_SCHEME=http

# Only if you had terminated TLS on a load balancer,
# reset to the IP address or DNS name of the New Edge UI.
MANAGEMENT_UI_IP=edge_UI_IP_DNS
```
Exécutez la commande suivante pour désactiver TLS :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
```
où configFile est le nom du fichier de configuration.

Le script redémarre la nouvelle interface utilisateur Edge. Vous pouvez désormais accéder à la nouvelle interface utilisateur Edge via HTTP. Si vous ne parvenez pas à vous connecter à la nouvelle interface utilisateur Edge après avoir désactivé TLS, effacez le cache du navigateur, puis réessayez de vous connecter.