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.
Ve a la Documentación de Apigee X. información

Síntoma

Los usuarios reciben un error Valor de host virtual no válido durante la configuración información sobre el almacén de claves, el alias y el dominio para un portal integrado para desarrolladores: 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 indica 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 que se proporcionó no está en formato PEM Las cadenas de certificados TLS que se usan en hosts virtuales deben estar en formato PEM. Si un certificado TLS sin formato PEM, la configuración del dominio personalizado fallará. Usuarios de la nube pública perimetral
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 suban a la el almacén de claves. De lo contrario, fallará la configuración del dominio personalizado. Usuarios de la nube pública perimetral

Causa: La cadena de certificados TLS que se proporcionó 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 generarán que el proceso de creación del host falle en el portal integrado para desarrolladores. Como resultado, el error anterior se muestra al usuario en la página de configuración del dominio personalizado de la IU de Edge.

Solución

Si verificaste que la cadena de certificados TLS no está en formato PEM, haz lo siguiente: sigue estos pasos para resolver este problema:

  1. Convierte la cadena de certificados TLS a formato PEM.
  2. Valide que si la cadena de certificados TLS es 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 en el almacén de claves con un alias de clave en la IU de Edge o en la API de Management.
  5. Configura el almacén de claves, el alias y el nombre de dominio en el portal integrado para desarrolladores: Publicar > Portales > Portal para desarrolladores > Configuración > Dominios.
  6. Haz clic en Guardar.

Causa: La clave y el certificado TLS se proporcionaron en un solo archivo

Diagnóstico

  1. Verifica que la cadena de certificados TLS dada contenga los certificados y la clave privada en el mismo archivo subido al almacén de claves.
  2. Ver el archivo fuente original en un editor de texto del sistema que usaste para subir la 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 de la cadena de certificados comienza con la siguiente línea:

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

    y termina con la siguiente línea:

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

    Después de los certificados TLS, sigue 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 determina que la cadena de certificados TLS y la clave privada se combinaron en un solo y se sube al almacén de claves, esa es la causa de que falle la creación del host virtual. en el portal integrado para desarrolladores. Como resultado, se muestra el mensaje de error anterior al usuario en la página de configuración de dominio personalizado en la IU de Edge.

Solución

Si el archivo PEM del certificado TLS contenía los certificados TLS y la clave privada, sigue estos pasos para resolver el problema:

  1. Mueve la clave privada del archivo PEM del certificado TLS y a un archivo de claves separado.
  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. De lo contrario, convertir la cadena de certificados TLS a formato PEM.
  5. Valide que si la cadena de certificados TLS es válida.
  6. Sube el archivo que contiene la cadena de certificados TLS convertida a formato PEM y el archivo que contenga la clave privada en el almacén de claves mediante un alias de clave en la IU de Edge o en el API de Cloud Management.
  7. Configura el almacén de claves, el alias y el nombre de dominio en el portal integrado para desarrolladores: 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, realiza el siguiente diagnóstico y compartirla con el equipo de asistencia de Apigee Edge:

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