Falha na configuração do domínio personalizado devido a um erro de host virtual inválido no portal do desenvolvedor integrado

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Sintoma

Os usuários recebem um erro de valor de host virtual inválido ao configurar as informações do keystore, do alias e do domínio para um portal do desenvolvedor integrado: Publicar > Portais > Portal do desenvolvedor > Configurações > Domínios.

Mensagem de erro

A seguinte mensagem de erro é exibida:

Invalid virtual host value (id: <value>)

A mensagem de erro é mostrada na interface do Edge, conforme mostrado abaixo:

Portais > Portal do desenvolvedor > Configurações > Domínios" title="Domínios">

Causas possíveis

Causa: a cadeia de certificados TLS fornecida não está no formato PEM

Diagnóstico

1. Verifique se a cadeia de certificados TLS está no formato PEM.
2. Se a cadeia de certificados TLS específica não estiver no formato PEM, isso fará com que o processo de criação do host virtual falhe no portal do desenvolvedor integrado. Como resultado, a mensagem de erro acima é mostrada ao usuário na página de configuração de domínio personalizado da interface do Edge.

Resolução

Se você tiver determinado que a cadeia de certificados TLS não está no formato PEM, siga estas etapas para resolver o problema:

1. Converta a cadeia de certificados TLS para o formato PEM.
2. Valide se a cadeia de certificados TLS é válida.
3. Remova a cadeia de certificados TLS e a chave privada do keystore específico.
4. Faça upload do arquivo que contém a cadeia de certificados TLS no formato PEM e do arquivo que contém a chave privada para o keystore usando um alias de chave na interface do Edge ou na API Management.
5. Configure o keystore, o alias e o nome de domínio no portal do desenvolvedor integrado: Publicar > Portais > Portal do desenvolvedor > Configurações > Domínios.
6. Clique em Salvar.

Causa: o certificado e a chave TLS foram fornecidos em um único arquivo

Diagnóstico

1. Verifique se a cadeia de certificados TLS fornecida contém os certificados e a chave privada no mesmo arquivo enviado ao keystore.
2. Visualize o arquivo de origem original em um editor de texto no sistema que você usou para fazer upload da cadeia de certificados TLS e da chave privada para o keystore da Apigee.

3. Se o arquivo contiver os certificados TLS e a chave privada, cada certificado TLS na cadeia de certificados começará com a seguinte linha:

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

   e termina com a seguinte linha:

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

   Os certificados TLS são seguidos pela chave privada, que começa com a seguinte linha:

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

   e termina com a seguinte linha:

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

   como mostra o exemplo a seguir:

   -----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. Se você determinar que a cadeia de certificados TLS e a chave privada foram combinadas em um único arquivo e enviadas ao keystore, essa será a causa da falha na criação do host virtual no portal do desenvolvedor integrado. Como resultado, a mensagem de erro acima é mostrada ao usuário na página de configuração de domínio personalizado na interface do Edge.

Resolução

Se o arquivo PEM do certificado TLS contiver os certificados TLS e a chave privada, siga estas etapas para resolver o problema:

1. Mova a chave privada do arquivo PEM do certificado TLS para um arquivo de chave separado.
2. Remova o certificado TLS do keystore específico.
3. Verifique se a cadeia de certificados TLS está no formato PEM.
4. Se não estiver, converta a cadeia de certificados TLS para o formato PEM.
5. Valide se a cadeia de certificados TLS é válida.
6. Faça upload do arquivo que contém a cadeia de certificados TLS convertida para o formato PEM e do arquivo que contém a chave privada para o keystore usando um alias de chave na interface do Edge ou na API Management.
7. Configure o keystore, o alias e o nome de domínio no portal do desenvolvedor integrado: Publicar > Portais > Portal do desenvolvedor > Configurações > Domínios.
8. Clique em Salvar.

Se o problema persistir, acesse Precisa de informações de diagnóstico.

É necessário coletar informações de diagnóstico

Se o problema persistir depois de seguir as instruções acima, colete as seguintes informações de diagnóstico informações e compartilhe-as com o suporte do Apigee Edge:

• Nome da organização do Apigee Edge Cloud
• Nome do portal do desenvolvedor integrado do Apigee Edge Cloud
• Nome do keystore criado no ambiente do portal
• Nome do alias
• Nome de domínio personalizado
• Uma captura de tela da página de configuração de domínio personalizado que captura a mensagem de erro