ここに表示されているのは Apigee Edge のドキュメントです。
Go to the
Apigee X のドキュメントに移動します。 info
症状
統合デベロッパー ポータルのキーストア、エイリアス、ドメイン情報を構成しているときに、[公開] > [ポータル] > [デベロッパー ポータル] > [設定] > [ドメイン] で、仮想ホストの値が無効です というエラーが表示されます。
エラー メッセージ
次のエラー メッセージが表示されます。
Invalid virtual host value (id: <value>)
Edge UI に次のようなエラー メッセージが表示されます。
ポータル > デベロッパー ポータル > 設定 > ドメイン" title="ドメイン">
考えられる原因
| 原因 | 説明 | トラブルシューティング手順の適用対象 |
|---|---|---|
| 指定された TLS 証明書チェーンが PEM 形式ではない | 仮想ホストで使用される TLS 証明書チェーンは PEM 形式にする必要があります。PEM 形式でない TLS 証明書 チェーンを使用すると、カスタム ドメインの構成が失敗します。 | Edge Public Cloud ユーザー |
| TLS 証明書と鍵が 1 つのファイルで指定されている | キーストアにアップロードする場合は、TLS 証明書チェーンと秘密鍵を個別のファイルで指定する必要があります。そうしないと、カスタム ドメインの構成が失敗します。 | Edge Public Cloud ユーザー |
原因: 指定された TLS 証明書チェーンが PEM 形式ではない
診断
- TLS 証明書チェーンが PEM 形式であることを確認します。
- 特定の TLS 証明書チェーンが PEM 形式でない場合、統合デベロッパー ポータルで仮想 ホストの作成プロセスが失敗します。その結果、Edge UI のカスタム ドメイン構成ページに上記のエラー メッセージが表示されます。
解決策
TLS 証明書チェーンが PEM 形式でないことが判明した場合は、次の手順でこの問題を解決します。
- TLS 証明書チェーンを PEM 形式に変換します。
- TLS 証明書チェーンが有効であることを 確認します。
- 特定のキーストアから既存の TLS 証明書チェーンと秘密鍵を削除します。
- Edge UI または Management API の鍵エイリアスを使用して、PEM 形式の TLS 証明書チェーンを含むファイルと秘密鍵を含むファイルをキーストアにアップロードします。
- 統合デベロッパー ポータルでキーストア、エイリアス、ドメイン名を構成します: [公開] > [ポータル] > [デベロッパー ポータル] > [設定] > [ドメイン]。
- [保存] をクリックします。
原因: TLS 証明書と鍵が 1 つのファイルで指定されている
診断
- 指定された TLS 証明書チェーンに、キーストアにアップロードされた同じファイルに証明書と秘密鍵の両方が含まれていることを確認します。
- 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 証明書チェーンと秘密鍵がすべて 1 つのファイルに結合されてキーストアにアップロードされていることが判明した場合、統合デベロッパー ポータルで仮想ホストの作成が失敗する原因となります。その結果、Edge UI のカスタム ドメイン構成ページに上記のエラー メッセージがユーザーに表示されます。
解決策
TLS 証明書 PEM ファイルに TLS 証明書と秘密鍵の両方が含まれている場合は、次の手順で問題を解決します。
- TLS 証明書 PEM ファイルから秘密鍵を別の鍵ファイルに移動します。
- 特定のキーストアから既存の TLS 証明書を削除します。
- TLS 証明書チェーンが PEM 形式であることを確認します。
- そうでない場合は、 TLS 証明書チェーンを PEM 形式に変換します。
- TLS 証明書チェーンが有効であることを 確認します。
- Edge UI または Management API の鍵エイリアスを使用して、PEM 形式に変換された TLS 証明書チェーンを含むファイルと秘密鍵を含むファイルをキーストアにアップロードします。
- 統合デベロッパー ポータルでキーストア、エイリアス、ドメイン名を構成します: [公開] > [ポータル] > [デベロッパー ポータル] > [設定] > [ドメイン]。
- [保存] をクリックします。
問題が解決しない場合は、 診断情報の収集が必要な場合をご覧ください。
診断情報の収集が必要な場合
上記の手順を行っても問題が解決しない場合は、次の診断情報 を収集してApigee Edge サポートにご提供ください。
- Apigee Edge Cloud 組織名
- Apigee Edge Cloud 統合デベロッパー ポータルの名前
- ポータル環境で作成されたキーストアの名前
- エイリアス名
- カスタム ドメイン名
- エラー メッセージが表示されているカスタム ドメイン構成ページのスクリーンショット