Сбой конфигурации пользовательского домена из-за ошибки недопустимого виртуального хоста на интегрированном портале разработчика

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

Симптом

Пользователи получают сообщение об ошибке «Недопустимое значение виртуального хоста» при настройке хранилища ключей, псевдонима и информации о домене для интегрированного портала разработчика: Публикация > Порталы > Портал разработчика > Настройки > Домены .

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

Отображается следующее сообщение об ошибке:

Invalid virtual host value (id: <value>)

Сообщение об ошибке отображается в пользовательском интерфейсе Edge, как показано ниже:

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

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

Причина Описание Инструкции по устранению неполадок применимы для
Предоставленная цепочка сертификатов TLS не имеет формата PEM. Цепочки сертификатов TLS, используемые на виртуальных хостах, должны быть в формате PEM. Если используется цепочка сертификатов TLS в формате, отличном от PEM, настройка личного домена завершится неудачно. Пользователи Edge Public Cloud
Сертификат и ключ TLS были предоставлены в одном файле. Цепочка сертификатов TLS и закрытый ключ должны быть предоставлены в отдельных файлах при загрузке в хранилище ключей. В противном случае настройка личного домена завершится неудачно. Пользователи Edge Public Cloud

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

Диагностика

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

Разрешение

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

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

Если проблема не устранена, перейдите к разделу «Необходимо собрать диагностическую информацию» .

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

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

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