Konfigurasi domain kustom gagal dengan error host virtual yang tidak valid di portal developer terintegrasi

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Gejala

Pengguna mendapatkan error Invalid virtual host value saat mengonfigurasi informasi keystore, alias, dan domain untuk portal developer terintegrasi: Publish > Portals > Developer Portal > Settings > Domains.

Pesan error

Pesan error berikut akan muncul:

Invalid virtual host value (id: <value>)

Pesan error ditampilkan di UI Edge seperti yang ditunjukkan di bawah:

Portals > Developer Portal > Settings > Domains" title="Domains">

Kemungkinan penyebab

Penyebab: Rantai sertifikat TLS yang diberikan tidak dalam format PEM

Diagnosis

1. Pastikan rantai sertifikat TLS dalam format PEM.
2. Jika rantai sertifikat TLS tertentu tidak dalam format PEM, proses pembuatan host virtual akan gagal di portal developer terintegrasi. Akibatnya, pesan error di atas akan ditampilkan kepada pengguna di halaman konfigurasi domain kustom UI Edge.

Resolusi

Jika Anda telah memastikan bahwa rantai sertifikat TLS tidak dalam format PEM, lakukan langkah-langkah berikut untuk mengatasi masalah ini:

1. Konversi rantai sertifikat TLS ke format PEM.
2. Pastikan rantai sertifikat TLS valid.
3. Hapus rantai sertifikat TLS yang ada dan kunci pribadi dari keystore tertentu.
4. Upload file yang berisi rantai sertifikat TLS dalam format PEM dan file yang berisi kunci pribadi ke keystore menggunakan alias kunci di UI Edge atau Management API.
5. Konfigurasi keystore, alias, dan nama domain di portal developer terintegrasi: Publish > Portals > Developer Portal > Settings > Domains.
6. Klik Save.

Penyebab: Sertifikat dan kunci TLS diberikan dalam satu file

Diagnosis

1. Pastikan rantai sertifikat TLS yang diberikan berisi sertifikat dan kunci pribadi dalam file yang sama yang diupload ke keystore.
2. Lihat file sumber asli di editor teks di sistem Anda yang digunakan untuk mengupload rantai sertifikat TLS dan kunci pribadi ke keystore Apigee.

3. Jika file berisi sertifikat TLS dan kunci pribadi, setiap sertifikat TLS dalam rantai sertifikat akan dimulai dengan baris berikut:

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

   dan diakhiri dengan baris berikut:

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

   Sertifikat TLS diikuti oleh kunci pribadi yang dimulai dengan baris berikut:

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

   dan diakhiri dengan baris berikut:

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

   seperti yang ditunjukkan contoh berikut:

   -----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. Jika Anda memastikan bahwa rantai sertifikat TLS dan kunci pribadi digabungkan dalam satu file dan diupload ke keystore, hal tersebut akan menyebabkan pembuatan host virtual gagal di portal developer terintegrasi. Akibatnya, pesan error di atas akan ditampilkan kepada pengguna di halaman konfigurasi domain kustom di UI Edge.

Resolusi

Jika file PEM sertifikat TLS berisi sertifikat TLS dan kunci pribadi, lakukan langkah-langkah berikut untuk mengatasi masalah ini:

1. Pindahkan kunci pribadi dari file PEM sertifikat TLS dan ke file kunci terpisah.
2. Hapus sertifikat TLS yang ada dari keystore tertentu.
3. Pastikan rantai sertifikat TLS dalam format PEM.
4. Jika tidak, konversi rantai sertifikat TLS ke format PEM.
5. Pastikan rantai sertifikat TLS valid.
6. Upload file yang berisi rantai sertifikat TLS yang dikonversi ke format PEM dan file yang berisi kunci pribadi ke keystore menggunakan alias kunci di UI Edge atau Management API.
7. Konfigurasi keystore, alias, dan nama domain di portal developer terintegrasi: Publish > Portals > Developer Portal > Settings > Domains.
8. Klik Save.

Jika masalah masih berlanjut, buka Mengumpulkan informasi diagnostik.

Mengumpulkan informasi diagnostik

Jika masalah berlanjut setelah mengikuti petunjuk di atas, kumpulkan informasi diagnostik berikut dan bagikan kepada Dukungan Apigee Edge:

• Nama organisasi Apigee Edge Cloud
• Nama portal developer terintegrasi Apigee Edge Cloud
• Nama keystore yang dibuat di lingkungan portal
• Nama alias
• Nama domain kustom
• Screenshot halaman konfigurasi domain kustom yang berisi pesan error