De forma predeterminada, accedes a la IU de New Edge a través de HTTP con la dirección IP o el nombre de DNS del nodo de la IU de New Edge y el puerto 3001. Por ejemplo:
http://edge_UI_IP:3001
Como alternativa, puedes configurar el acceso TLS a la IU de New Edge para que puedas acceder a ella de la siguiente manera:
https://edge_UI_IP:3001
Requisitos de TLS
La IU de New Edge admite TLS v1.2 y versiones posteriores. Si habilitas TLS en la IU de New Edge, los usuarios deben conectarse a la IU de New Edge con un navegador compatible con TLS v1.2 o versiones posteriores.
Propiedades de configuración de TLS
Ejecuta el siguiente comando para configurar TLS para la IU de New Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
En el ejemplo anterior, configFile es el archivo de configuración que usaste para instalar o configurar la IU de New Edge.
Antes de ejecutar este comando, debes editar el archivo de configuración para establecer las propiedades necesarias que controlan TLS. En la siguiente tabla, se describen las propiedades que usas para configurar TLS para la IU de New Edge:
| Propiedad | Descripción | ¿Obligatorio? |
|---|---|---|
MANAGEMENT_UI_SCHEME
|
Establece el protocolo, "http" o "https", que se usa para acceder a la IU de New Edge. El valor predeterminado es "http". Establécelo en "https" para habilitar TLS: MANAGEMENT_UI_SCHEME=https |
Sí |
MANAGEMENT_UI_TLS_OFFLOAD
|
Si es "n", especifica que las solicitudes TLS a la IU de New Edge finalizan
en la IU de New Edge. Debes establecer Si es "y", especifica que las solicitudes TLS a la IU de New Edge finalizan en un balanceador de cargas y que el balanceador de cargas reenvía la solicitud a la IU de New Edge mediante HTTP. Si finalizas TLS en el balanceador de cargas, la IU de New Edge aún debe saber que la solicitud original llegó a través de TLS. Por ejemplo, algunas cookies tienen establecida una marca segura. Debes establecer MANAGEMENT_UI_SCHEME=https MANAGEMENT_UI_TLS_OFFLOAD=y |
Sí |
MANAGEMENT_UI_TLS_KEY_FILE
|
Si MANAGEMENT_UI_TLS_OFFLOAD=n, especifica la ruta de acceso absoluta
a los archivos de clave y certificado TLS. Los archivos deben tener el formato de archivos PEM con
sin frase de contraseña y deben ser propiedad del usuario "apigee".
La ubicación recomendada para estos archivos es la siguiente:
/opt/apigee/customer/application/edge-management-ui Si ese directorio no existe, créalo. Si |
Sí, si MANAGEMENT_UI_TLS_OFFLOAD=n
|
MANAGEMENT_UI_PUBLIC_URIS
|
Si Establece esta propiedad en función de otras propiedades del archivo de configuración. Por ejemplo: MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT Donde:
Consulta Cómo configurar la IU de New Edge para obtener más información sobre estas propiedades. Si
|
Sí |
MANAGEMENT_UI_TLS_ALLOWED_CIPHERS
|
Define la lista de cifrados TLS disponibles como una cadena separada por comas o espacios. Cadena separada por comas: MANAGEMENT_UI_TLS_ALLOWED_CIPHERS=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 Cadena separada por espacios entre comillas dobles:
MANAGEMENT_UI_TLS_ALLOWED_CIPHERS="TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256" |
Configura TLS
Para configurar el acceso TLS a la IU de New Edge, haz lo siguiente:
Genera el certificado y la clave TLS como archivos PEM sin frase de contraseña. Por ejemplo:
mykey.pem mycert.pem
Hay muchas formas de generar un certificado y una clave TLS. Por ejemplo, puedes ejecutar el siguiente comando para generar un certificado y una clave sin firma:
openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'
- Copia los archivos de clave y certificado en el directorio
/opt/apigee/customer/application/edge-management-ui. Si ese directorio no existe, créalo. Asegúrate de que el certificado y la clave sean propiedad del usuario "apigee":
chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem
Edita el archivo de configuración que usaste para instalar la IU de New Edge para establecer las siguientes propiedades de TLS:
# 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
Ejecuta el siguiente comando para configurar TLS:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
En el ejemplo anterior, configFile es el nombre del archivo de configuración.
La secuencia de comandos reinicia la IU de New Edge. Después del reinicio, la IU de New Edge admite el acceso a través de HTTPS. Si no puedes acceder a la IU de New Edge después de habilitar TLS, borra la caché del navegador y vuelve a intentarlo.
Configura la IU de New Edge cuando la finalización de TLS se produce en el balanceador de cargas
Si tienes un balanceador de cargas que reenvía solicitudes a la IU de New Edge, puedes finalizar la conexión TLS en el balanceador de cargas y, luego, hacer que el balanceador de cargas reenvíe las solicitudes a la IU de New Edge a través de HTTP:
Esta configuración es compatible, pero debes configurar el balanceador de cargas y la IU de New Edge en consecuencia.
Para configurar la IU de New Edge cuando la finalización de TLS se produce en el balanceador de cargas, haz lo siguiente:
Edita el archivo de configuración que usaste para instalar la IU de New Edge para establecer las siguientes propiedades de TLS:
# 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 estableces
MANAGEMENT_UI_TLS_OFFLOAD=y, omiteMANAGEMENT_UI_TLS_KEY_FILEyMANAGEMENT_UI_TLS_CERT_FILE. Se ignoran porque las solicitudes a la IU de New Edge llegan a través de HTTP.Ejecuta el siguiente comando para configurar TLS:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
En el ejemplo anterior, configFile es el nombre del archivo de configuración.
La secuencia de comandos reinicia la IU de New Edge. Después del reinicio, la IU de New Edge admite el acceso a través de HTTPS a través del balanceador de cargas. Si no puedes acceder a la IU de New Edge después de habilitar TLS, borra la caché del navegador y vuelve a intentarlo.
Inhabilita TLS en la IU de New Edge
Para inhabilitar TLS en la IU de New Edge, haz lo siguiente:
Edita el archivo de configuración que usaste para instalar la IU de New Edge para establecer la siguiente propiedad de TLS:
# 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
Ejecuta el siguiente comando para inhabilitar TLS:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
En el ejemplo anterior, configFile es el nombre del archivo de configuración.
La secuencia de comandos reinicia la IU de New Edge. Ahora puedes acceder a la IU de New Edge a través de HTTP. Si no puedes acceder a la IU de New Edge después de inhabilitar TLS, borra la caché del navegador y vuelve a intentarlo.