La configuración del dominio personalizado falla con un error de host virtual no válido en el portal integrado para desarrolladores

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Síntoma

Los usuarios reciben un error de Invalid virtual host value cuando configuran la información del almacén de claves, el alias y el dominio para un portal para desarrolladores integrado: Publicar > Portales > Portal para desarrolladores > Configuración > Dominios.

Mensaje de error

Se muestra el siguiente mensaje de error: 

Invalid virtual host value (id: <value>)

El mensaje de error se muestra en la IU de Edge como se muestra a continuación:

Portales > Portal para desarrolladores > Configuración > Dominios" title="Dominios">

Causas posibles

Causa Descripción Instrucciones de solución de problemas aplicables para
La cadena de certificados TLS proporcionada no está en formato PEM Las cadenas de certificados TLS que se usan en los hosts virtuales deben estar en formato PEM. Si se usa una cadena de certificados TLS en formato no PEM, fallará la configuración del dominio personalizado. Usuarios de la nube pública de Edge
Se proporcionaron el certificado y la clave TLS en un solo archivo La cadena de certificados TLS y la clave privada deben proporcionarse en archivos individuales cuando se suben al almacén de claves. De lo contrario, fallará la configuración del dominio personalizado. Usuarios de la nube pública de Edge

Causa: La cadena de certificados TLS proporcionada no está en formato PEM

Diagnóstico

  1. Verifica que la cadena de certificados TLS esté en formato PEM.
  2. Si la cadena de certificados TLS específica no está en formato PEM, se producirá un error en el proceso de creación del host virtual en el portal para desarrolladores integrado. Como resultado, se muestra el mensaje de error anterior al usuario en la página de configuración del dominio personalizado de la IU de Edge.

Solución

Si determinaste que la cadena de certificados TLS no está en formato PEM, sigue los pasos que se indican a continuación para resolver este problema:

  1. Convierte la cadena de certificados TLS al formato PEM.
  2. Valida que la cadena de certificados TLS sea válida.
  3. Quita la cadena de certificados TLS existente y la clave privada del almacén de claves específico.
  4. Sube el archivo que contiene la cadena de certificados TLS en formato PEM y el archivo que contiene la clave privada al almacén de claves con un alias de clave en la IU de Edge o la API de Management.
  5. Configura el almacén de claves, el alias y el nombre de dominio en el portal para desarrolladores integrado: Publicar > Portales > Portal para desarrolladores > Configuración > Dominios.
  6. Haz clic en Guardar.

Causa: Se proporcionaron el certificado y la clave TLS en un solo archivo

Diagnóstico

  1. Verifica que la cadena de certificados TLS determinada contenga los certificados y la clave privada en el mismo archivo subido al almacén de claves.
  2. Visualiza el archivo fuente original en un editor de texto en tu sistema que usaste para subir la cadena de certificados TLS y la clave privada al almacén de claves de Apigee.

  3. Si el archivo contiene los certificados TLS y la clave privada, cada certificado TLS en la cadena de certificados comienza con la siguiente línea:

    -----BEGIN CERTIFICATE-----

    y termina con la siguiente línea:

    -----END CERTIFICATE-----

    Los certificados TLS están seguidos por la clave privada que comienza con la siguiente línea:

    -----BEGIN RSA PRIVATE KEY-----

    y termina con la siguiente línea:

    -----END RSA PRIVATE KEY-----

    como se muestra en el siguiente ejemplo:

    -----BEGIN CERTIFICATE-----
CzAJBgNVBAYTAkJCMQswCQYDVQQIDAJCQjELMAkGA1UEBwwCQkIxDzANBgNVBAoM
BkJCIEx0ZDELMAkGA1UECwwCQkIxEDAOBgNVBAMMB2Zvby5vcmcxGjAYBgkqhkiG
9w0BCQEWC2FiY0Bmb28ub3JnMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEA8IN15+8HrfeSVf4NIj7mM4jjms89EUX4HKrey+lm1+ljv3OGw+NK7BCHvoV3
vZ+KXMHTtFeeFd1NgQZnDdbmuD0jTvvF7YoC/h6bLPytJquQJZykm9DyszsmACI8
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIDbjCCAlYCCQCrcuwFhXCcujANBgkqhkiG9w0BAQsFADB5MQswCQYDVQQGEwJB
QTELMAkGA1UECAwCQUExCzAJBgNVBAcMAkFBMQ8wDQYDVQQKDAZBQSBMdGQxCzA
BgNVBAsMAkFBMRMwEQYDVQQDDApjYS5mb28ub3JnMR0wGwYJKoZIhvcNAQkBFg5h
YmNAY2EuZm9vLm9yZzAeFw0xOTEwMDQwNTA0MzVaFw0yOTEwMDEwNTA0MzVaMHk
CzAJBgNVBAYTAkFBMQswCQYDVQQIDAJBQTELMAkGA1UEBwwCQUExDzANBgNVBAo
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
YcJpTL5yNyQE3NIXPGCiTrrSEBSX5X9ae8C/URlyWPbJ3jBE7GH4u6id5qEcgx6I
/6QHDyPIhFcwfdU3nZbzZfwCYfH9SI5hQPscfGTotNxZxDwNIzuqqrIhari4e6lc
mlEa/CDzOzvdYTX7RT1MmBY9US8JY5xhUKk0gQbhCfB7TcpvySldTbiUGQVn8h62
/fJDhNQlzV7Maogc7te9DWW/HhYfGTFKOwIDAQABMA0GCSqGSIb3DQEBCwUAA4IB
AQAT/5FCiKJ/Pv62bl+GYuuc0gXXeumW2205dN5cXBAVZ3kRqHjR9tMCx3u+F2Td
...
-----END CERTIFICATE-----
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEA8IN15+8HrfeSVf4NIj7mM4jjms89EUX4HKrey+lm1+ljv3OG
w+NK7BCHvoV3vZ+KXMHTtFeeFd1NgQZnDdbmuD0jTvvF7YoC/h6bLPytJquQJZyk
m9DyszsmACI8hK4azrd7zZqTETVZN+mxOiYBfa1E1pE8v/bdIqnLTICmFbIQ2PVF
zc0anobltRRI4/OcRb7QPQUk+dBxU7XyyAhcACROwaeT8yqksnYNANBcnMiS5qH+
sucJFNJ9bGIuWIwhsYVxzrANe9ttVvie38Cj6Go+UiIzF3VAyRkIE7MvW9Qc5m0O
...
-----END RSA PRIVATE KEY-----
  4. Si determinas que la cadena de certificados TLS y la clave privada se combinaron en un solo archivo y se subieron al almacén de claves, esa es la causa por la que falla la creación del host virtual en el portal para desarrolladores integrado. Como resultado, se muestra el mensaje de error anterior al usuario en la página de configuración del dominio personalizado de la IU de Edge.

Solución

Si el archivo PEM del certificado TLS contenía los certificados TLS y la clave privada, sigue los pasos que se indican a continuación para resolver el problema:

  1. Mueve la clave privada del archivo PEM del certificado TLS a un archivo de claves independiente.
  2. Quita el certificado TLS existente del almacén de claves específico.
  3. Verifica que la cadena de certificados TLS esté en formato PEM.
  4. Si no lo está, convierte la cadena de certificados TLS al formato PEM.
  5. Valida que la cadena de certificados TLS sea válida.
  6. Sube el archivo que contiene la cadena de certificados TLS convertida al formato PEM y el archivo que contiene la clave privada al almacén de claves con un alias de clave en la IU de Edge o la API de Management.
  7. Configura el almacén de claves, el alias y el nombre de dominio en el portal para desarrolladores integrado: Publicar > Portales > Portal para desarrolladores > Configuración > Dominios.
  8. Haz clic en Guardar.

Si el problema persiste, consulta Recopila información de diagnóstico.

Se debe recopilar información de diagnóstico

Si el problema persiste después de seguir las instrucciones anteriores, recopila la siguiente información de diagnóstico y compártela con Asistencia de Apigee Edge:

  • Nombre de la organización de la nube de Apigee Edge
  • Nombre del portal para desarrolladores integrado de la nube de Apigee Edge
  • Nombre del almacén de claves creado en el entorno del portal
  • Alias
  • Nombre de dominio personalizado
  • Una captura de pantalla de la página de configuración del dominio personalizado que capture el mensaje de error
    •