При настройке пользовательского домена в интегрированном портале для разработчиков возникает ошибка "Недопустимый виртуальный хост"

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация

Symptom

При настройке хранилища ключей, псевдонима и информации о домене для интегрированного портала для разработчиков (Publish > Portals > Developer Portal > Settings > Domains) пользователи получают сообщение об ошибке Invalid virtual host value (Недействительное значение виртуального хоста).

Сообщение об ошибке

Появляется следующее сообщение об ошибке:

Invalid virtual host value (id: <value>)

Сообщение об ошибке будет показано в интерфейсе Edge, как показано ниже.

Порталы > Портал разработчика > Настройки > Домены" title="Домены">

Возможные причины

Причина: цепочка сертификатов TLS предоставлена не в формате PEM

диагностика;

1. Убедитесь, что цепочка сертификатов TLS имеет формат PEM.
2. Если определенная цепочка сертификатов TLS не в формате PEM, то процесс создания виртуального хоста в интегрированном портале для разработчиков завершится неудачно. В результате пользователь увидит указанное выше сообщение об ошибке на странице конфигурации специального домена в интерфейсе Edge.

Разрешение

Если вы выяснили, что цепочка сертификатов TLS не в формате PEM, выполните следующие действия, чтобы устранить проблему:

1. Преобразуйте цепочку сертификатов TLS в формат PEM.
2. Убедитесь, что цепочка сертификатов TLS действительна.
3. Удалите существующую цепочку сертификатов TLS и закрытый ключ из определенного хранилища ключей.
4. Загрузите файл, содержащий цепочку сертификатов TLS в формате PEM, и файл, содержащий закрытый ключ, в хранилище ключей, используя псевдоним ключа в интерфейсе Edge или Management API.
5. Настройте хранилище ключей, псевдоним и доменное имя на интегрированном портале для разработчиков: Опубликовать > Порталы > Портал разработчика > Настройки > Домены.
6. Нажмите Сохранить.

Причина: сертификат TLS и ключ были предоставлены в одном файле

диагностика;

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 и закрытый ключ были объединены в один файл и загружены в хранилище ключей, то именно это является причиной сбоя при создании виртуального хоста на встроенном портале для разработчиков. В результате пользователь увидит указанное выше сообщение об ошибке на странице конфигурации специального домена в интерфейсе Edge.

Разрешение

Если PEM-файл сертификата TLS содержал как сертификаты TLS, так и закрытый ключ, выполните следующие действия, чтобы устранить проблему:

1. Переместите закрытый ключ из файла PEM сертификата TLS в отдельный файл ключа.
2. Удалите существующий сертификат TLS из определенного хранилища ключей.
3. Убедитесь, что цепочка сертификатов TLS имеет формат PEM.
4. Если нет, преобразуйте цепочку сертификатов TLS в формат PEM.
5. Убедитесь, что цепочка сертификатов TLS действительна.
6. Загрузите файл, содержащий цепочку сертификатов TLS, преобразованную в формат PEM, и файл, содержащий закрытый ключ, в хранилище ключей, используя псевдоним ключа в интерфейсе Edge или Management API.
7. Настройте хранилище ключей, псевдоним и доменное имя на интегрированном портале для разработчиков: Опубликовать > Порталы > Портал разработчика > Настройки > Домены.
8. Нажмите Сохранить.

Если проблема не устранена, перейдите к разделу Обязательная диагностическая информация.

Необходимо собрать диагностическую информацию

Если после выполнения описанных выше инструкций проблема не будет устранена, соберите указанную ниже диагностическую информацию и отправьте ее в службу поддержки Apigee Edge.

• Название организации Apigee Edge Cloud
• Название интегрированного портала для разработчиков Apigee Edge Cloud
• Название хранилища ключей, созданного в среде портала
• Название псевдонима
• Пользовательское доменное имя
• Скриншот страницы настройки собственного домена с сообщением об ошибке.