整合開發人員入口網站中的虛擬主機錯誤無效，導致自訂網域設定失敗

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

問題

使用者在設定 整合式開發人員入口網站的 KeyStore、別名和網域資訊： 發布 >入口網站 >開發人員入口網站 >設定 >網域。

錯誤訊息

系統會顯示下列錯誤訊息： 

Invalid virtual host value (id: <value>)

Edge UI 會顯示錯誤訊息，如下所示：

入口網站 >開發人員入口網站 >設定 >Domainstitle="網域">

可能原因

原因 說明 適用的疑難排解操作說明
提供的傳輸層安全標準 (TLS) 憑證鏈結不是 PEM 格式 在虛擬主機中使用的 TLS 憑證鏈結必須採用 PEM 格式。如果 TLS 憑證 使用非 PEM 格式的鏈結，自訂網域設定將會失敗。 Edge Public Cloud 使用者
在單一檔案中提供了傳輸層安全標準 (TLS) 憑證和金鑰 上傳至 KeyStore。否則自訂網域設定將會失敗。 Edge Public Cloud 使用者

原因：提供的 TLS 憑證鏈結並非採用 PEM 格式

診斷

  1. 確認 TLS 憑證鏈結採用 PEM 格式。
  2. 如果特定 TLS 憑證鏈結不是 PEM 格式，就會導致 無法在整合式開發人員入口網站進行主機建立程序。因此，上述錯誤 訊息，向使用者顯示於 Edge UI 的自訂網域設定頁面。

解析度

如果您確定 TLS 憑證鏈結不是 PEM 格式，則 請按照下列步驟解決這個問題：

  1. 將 TLS 憑證鏈結轉換為 PEM 格式。
  2. 驗證 傳輸層安全標準 (TLS) 憑證鏈結有效。
  3. 從特定 KeyStore 移除現有的傳輸層安全標準 (TLS) 憑證鏈結和私密金鑰。
  4. 上傳含有 TLS 憑證鏈結的檔案 (PEM 格式)，以及含有 使用 Edge UI 或 Management API 中的金鑰別名，將私密金鑰傳送至 KeyStore。
  5. 在整合式開發人員入口網站中設定 KeyStore、別名和網域名稱： 發布 >入口網站 >開發人員入口網站 >設定 >網域。
  6. 按一下「儲存」。

原因：在單一檔案中提供 TLS 憑證和金鑰

診斷

  1. 驗證指定的 TLS 憑證鏈結是否同時包含憑證和私密金鑰 就是上傳到 KeyStore 的檔案
  2. 在您用來上傳 TLS 的系統中，使用文字編輯器查看原始來源檔案 憑證鏈結和私密金鑰。

  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 憑證鏈結和私密金鑰已全部合併為單一 檔案並上傳至 KeyStore，導致虛擬主機建立失敗 。因此，上述錯誤訊息會顯示在 的 App Engine 應用程式。

解析度

如果 TLS 憑證 PEM 檔案同時包含 TLS 憑證和私密金鑰，請 請按照下列步驟解決問題：

  1. 將私密金鑰從 TLS 憑證 PEM 檔案移至另一個金鑰檔案。
  2. 從特定 KeyStore 移除現有的 TLS 憑證。
  3. 確認 TLS 憑證鏈結採用 PEM 格式。
  4. 如果不是， 將 TLS 憑證鏈結轉換為 PEM 格式。
  5. 驗證 傳輸層安全標準 (TLS) 憑證鏈結有效。
  6. 上傳內含傳輸層安全標準 (TLS) 憑證鏈結的檔案，並轉換為 PEM 格式。 包含 KeyStore 的私密金鑰 (在 Edge UI 中使用金鑰別名) Management API
  7. 在整合式開發人員入口網站中設定 KeyStore、別名和網域名稱： 發布 >入口網站 >開發人員入口網站 >設定 >網域。
  8. 按一下「儲存」。

如果問題仍未解決，請前往 必須收集診斷資訊。

必須收集診斷資訊

如果按照上述說明操作後問題仍未解決，請收集下列診斷資訊 資訊，並與 Apigee Edge 支援分享：

  • Apigee Edge Cloud 機構名稱
  • Apigee Edge Cloud 整合式開發人員入口網站名稱
  • 在入口網站環境中建立的 KeyStore 名稱
  • 別名名稱
  • 自訂網域名稱
  • 自訂網域設定頁面擷取錯誤訊息的螢幕截圖
    •