您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
問題
使用者在為整合式開發人員入口網站設定金鑰儲存區、別名和網域資訊時，會收到「虛擬主機值無效」錯誤訊息：依序點選「發布」>「入口網站」>「開發人員入口網站」>「設定」>「網域」。
錯誤訊息
系統會顯示下列錯誤訊息：
Invalid virtual host value (id: <value>)
Edge 使用者介面會顯示錯誤訊息，如下所示：
入口網站 > 開發人員入口網站 > 設定 > 網域" title="網域">
可能原因
| 原因 | 說明 | 適用於以下裝置的疑難排解操作說明： |
|---|---|---|
| 提供的 TLS 憑證鏈結不是 PEM 格式 | 虛擬主機中使用的 TLS 憑證鏈結必須採用 PEM 格式。如果使用非 PEM 格式的 TLS 憑證鏈結，自訂網域設定就會失敗。 | Edge Public Cloud 使用者 |
| TLS 憑證和金鑰以單一檔案提供 | 上傳至金鑰儲存區時，TLS 憑證鏈結和私密金鑰必須分別提供在個別檔案中。否則自訂網域設定會失敗。 | Edge Public Cloud 使用者 |
原因：提供的 TLS 憑證鏈結不是 PEM 格式
診斷
- 確認 TLS 憑證鏈結採用 PEM 格式。
- 如果特定 TLS 憑證鏈結不是 PEM 格式，整合式開發人員入口網站的虛擬主機建立程序就會失敗。因此，Edge 使用者介面的自訂網域設定頁面會向使用者顯示上述錯誤訊息。
解析度
如果確認 TLS 憑證鏈不是 PEM 格式，請按照下列步驟解決問題：
- 將 TLS 憑證鏈結轉換為 PEM 格式。
- 確認 TLS 憑證鏈結有效。
- 從特定金鑰儲存區移除現有的 TLS 憑證鏈結和私密金鑰。
- 使用 Edge UI 或 Management API 中的金鑰別名，將含有 PEM 格式 TLS 憑證鏈結的檔案，以及含有私密金鑰的檔案上傳至金鑰儲存區。
- 在整合式開發人員入口網站中設定金鑰儲存區、別名和網域名稱： 依序點選「發布」>「入口網站」>「開發人員入口網站」>「設定」>「網域」。
- 按一下「儲存」。
原因：TLS 憑證和金鑰是在單一檔案中提供
診斷
- 確認提供的 TLS 憑證鏈結包含憑證和私密金鑰，且兩者位於上傳至 KeyStore 的相同檔案中。
- 在系統的文字編輯器中查看原始來源檔案，您就是使用這個編輯器將 TLS 憑證鏈結和私密金鑰上傳至 Apigee 金鑰儲存區。
-
如果檔案同時包含 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-----
- 如果您確認 TLS 憑證鏈和私密金鑰都已合併在單一檔案中，並上傳至金鑰儲存區，那麼這就是導致整合式開發人員入口網站無法建立虛擬主機的原因。因此，Edge UI 的自訂網域設定頁面會向使用者顯示上述錯誤訊息。
解析度
如果 TLS 憑證 PEM 檔案同時包含 TLS 憑證和私密金鑰，請按照下列步驟解決問題：
- 將私密金鑰從 TLS 憑證 PEM 檔案移至個別金鑰檔案。
- 從特定金鑰儲存區移除現有的 TLS 憑證。
- 確認傳輸層安全標準 (TLS) 憑證鏈結採用 PEM 格式。
- 如果不是，請 將 TLS 憑證鏈結轉換為 PEM 格式。
- 確認 TLS 憑證鏈結有效。
- 使用 Edge 使用者介面或 Management API 中的金鑰別名，將含有轉換為 PEM 格式的 TLS 憑證鏈的檔案，以及含有私密金鑰的檔案上傳至金鑰儲存區。
- 在整合式開發人員入口網站中設定金鑰儲存區、別名和網域名稱： 依序點選「發布」>「入口網站」>「開發人員入口網站」>「設定」>「網域」。
- 按一下「儲存」。
如果問題仍未解決，請參閱「必須收集診斷資訊」。
必須收集診斷資訊
如果按照上述指示操作後問題仍未解決，請收集下列診斷資訊，並提供給 Apigee Edge 支援團隊：
- Apigee Edge Cloud 機構名稱
- Apigee Edge Cloud 整合式開發人員入口網站名稱
- 在入口網站環境中建立的 KeyStore 名稱
- 別名
- 自訂網域名稱
- 自訂網域設定頁面的螢幕截圖，並擷取錯誤訊息