由于集成的开发者门户中存在虚拟主机错误，自定义网域配置失败

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

问题

用户在配置配置文件时收到虚拟主机值无效的错误消息 集成开发者门户的密钥库、别名和域信息： 发布 >门户 >开发者门户 >设置 >网域。

错误消息

系统会显示以下错误消息： 

Invalid virtual host value (id: <value>)

Edge 界面中会显示错误消息，如下所示：

门户 >开发者门户 >设置 >网域”title="域名">

可能的原因

起因 说明 适用的问题排查说明
提供的 TLS 证书链不是 PEM 格式 虚拟主机中使用的 TLS 证书链必须为 PEM 格式。如果 TLS 证书 链，则自定义网域配置将失败。 Edge 公有云用户
TLS 证书和密钥在单个文件中提供 在上传到 密钥库。否则，自定义网域配置将失败。 Edge 公有云用户

原因：提供的 TLS 证书链不是 PEM 格式

诊断

  1. <ph type="x-smartling-placeholder"></ph> 验证 TLS 证书链是否为 PEM 格式。 <ph type="x-smartling-placeholder">
  2. 如果指定的 TLS 证书链不是 PEM 格式，则会导致 主机创建流程在集成开发者门户中失败。因此，上述错误会导致 消息。

分辨率

如果您已确定 TLS 证书链未采用 PEM 格式，请执行以下操作： 请按照以下步骤解决此问题：

  1. <ph type="x-smartling-placeholder"></ph> 将 TLS 证书链转换为 PEM 格式。
  2. 验证 TLS 证书链有效。
  3. 从特定密钥库中移除现有的 TLS 证书链和私钥。
  4. 上传包含 PEM 格式的 TLS 证书链的文件，以及包含 在 Edge 界面或 Management API 中使用密钥别名将私钥上传到密钥库。
  5. 在集成式开发者门户中配置密钥库、别名和域名： 发布 >门户 >开发者门户 >设置 >网域。
  6. 点击保存。

原因：在单个文件中提供了 TLS 证书和密钥

诊断

  1. 验证给定的 TLS 证书链是否包含 相同的文件上传到密钥库。
  2. 在您系统上用于上传 TLS 的文本编辑器中查看原始源文件 证书链和私钥添加到 Apigee 密钥库。

  3. 如果该文件同时包含 TLS 证书和私钥，则每个 TLS 证书 都以以下行开头：

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

    并以以下代码行结尾：

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

    TLS 证书后跟以如下行开头的私钥：

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

    并以以下代码行结尾：

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

    如下例所示：

    -----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. 如果您确定 TLS 证书链和私钥都已合并到单个 文件并将其上传到密钥库，则这会导致虚拟主机创建失败 。因此，上述错误消息将会显示在 用户。

分辨率

如果 TLS 证书 PEM 文件同时包含 TLS 证书和私钥，则执行以下操作： 请按照以下步骤解决此问题：

  1. 将私钥从 TLS 证书 PEM 文件中移至单独的密钥文件中。
  2. 从特定密钥库中移除现有的 TLS 证书。
  3. <ph type="x-smartling-placeholder"></ph> 验证 TLS 证书链是否为 PEM 格式。
  4. 否则， 将 TLS 证书链转换为 PEM 格式。
  5. 验证 TLS 证书链有效。
  6. 上传包含已转换为 PEM 格式的 TLS 证书链的文件和该文件 包含密钥库的私钥，在 Edge 界面中使用密钥别名，或 Management API。
  7. 在集成式开发者门户中配置密钥库、别名和域名： 发布 >门户 >开发者门户 >设置 >网域。
  8. 点击保存。

如果问题仍然存在，请转到必须收集诊断信息。

必须收集的诊断信息

如果按照上述说明操作后问题仍然存在，请收集以下诊断信息。 信息并与 Apigee Edge 支持团队分享：

  • Apigee Edge Cloud 组织名称
  • Apigee Edge Cloud 集成开发者门户名称
  • 在门户环境中创建的密钥库的名称
  • 别名
  • 自定义域名
  • 捕获错误消息的自定义网域配置页面的屏幕截图
    •