統合デベロッパー ポータルで仮想ホストエラーによりカスタム ドメインの構成が失敗する

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント
詳細

症状

ユーザーに「Invalid virtual host value」というエラーが表示される 統合デベロッパー ポータルのキーストア、エイリアス、ドメイン情報: 公開 >ポータル >デベロッパー ポータル >設定 >ドメイン

エラー メッセージ

次のエラー メッセージが表示されます。

Invalid virtual host value (id: <value>)

エラー メッセージは、次のように Edge UI に表示されます。

ポータル >デベロッパー ポータル >設定 >ドメインtitle="ドメイン">

考えられる原因

原因 説明 トラブルシューティング手順の適用対象
指定した TLS 証明書チェーンが PEM 形式ではありません 仮想ホストで使用される TLS 証明書チェーンは PEM 形式にする必要があります。TLS 証明書が PEM 以外の形式のチェーンを使用すると、カスタム ドメインの構成は失敗します。 Edge Public Cloud ユーザー
TLS 証明書と鍵は 1 つのファイルで提供されました TLS 証明書チェーンと秘密鍵は、 作成します。そうしないと、カスタム ドメインの構成は失敗します。 Edge Public Cloud ユーザー

原因: 指定された TLS 証明書チェーンが PEM 形式ではない

診断

  1. <ph type="x-smartling-placeholder"></ph> TLS 証明書チェーンが PEM 形式であることを確認する。 <ph type="x-smartling-placeholder">
  2. 特定の TLS 証明書チェーンが PEM 形式でない場合、 ホスト作成プロセスが統合デベロッパー ポータルで失敗します。その結果、上記のエラーは というメッセージが Edge UI のカスタム ドメイン構成ページでユーザーに表示されます。

解決策

TLS 証明書チェーンが PEM 形式ではないことを確認した場合は、次の手順を実施します。 次の手順で問題を解決できます。

  1. <ph type="x-smartling-placeholder"></ph> TLS 証明書チェーンを PEM 形式に変換する
  2. 検証する TLS 証明書チェーンが有効である。
  3. 特定のキーストアから既存の TLS 証明書チェーンと秘密鍵を削除します。
  4. PEM 形式の TLS 証明書チェーンを含むファイルと、 Edge UI または Management API でキー エイリアスを使用して、秘密鍵をキーストアに追加します。
  5. 統合デベロッパー ポータルでキーストア、エイリアス、ドメイン名を構成します。 公開 >ポータル >デベロッパー ポータル >設定 >ドメイン
  6. [保存] をクリックします。

原因: TLS 証明書と鍵が 1 つのファイルで指定されている

診断

  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 証明書チェーンと秘密鍵がすべて 1 つの その場合、仮想ホストの作成に失敗します。 統合デベロッパー ポータルで確認できます。その結果、上記のエラー メッセージが ユーザー(Edge UI のカスタム ドメイン構成ページ)が表示されます。

解決策

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 UI または Management API です。
  7. 統合デベロッパー ポータルでキーストア、エイリアス、ドメイン名を構成します。 公開 >ポータル >デベロッパー ポータル >設定 >ドメイン
  8. [保存] をクリックします。

問題が解決しない場合は、診断情報の収集が必要な場合をご覧ください。

診断情報の収集が必要な場合

上記の手順でも問題が解決しない場合は、次の診断情報を収集してください。 Apigee Edge サポートと共有してください。

  • Apigee Edge Cloud 組織名
  • Apigee Edge Cloud 統合デベロッパー ポータルの名前
  • ポータル環境で作成されたキーストアの名前
  • エイリアス名
  • カスタム ドメイン名
  • エラー メッセージをキャプチャしているカスタム ドメイン構成ページのスクリーンショット
  •