Часто задаваемые вопросы о настройке виртуальных хостов

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

Клиенты Edge Cloud теперь могут создавать, изменять и удалять виртуальные хосты. Раньше эти действия выполняла служба поддержки Apigee Edge.

Кто может настроить виртуальный хост в Edge Cloud?

Создавать, изменять и удалять виртуальный хост может только клиент Cloud с платным аккаунтом. Пользователь, создающий виртуальный хост, должен иметь роль администратора организации или специальную роль с разрешениями на изменение виртуального хоста. У пользователей с другими ролями нет разрешения на создание виртуальных хостов.

Для специальной роли требуются разрешения GET, PUT и DELETE для /environments/*/virtualhosts или любого из его родительских ресурсов. Подробнее о том, как создавать роли с помощью API…

Что делать, если у меня уже есть виртуальный хост, созданный Apigee?

У существующих клиентов Edge Cloud уже есть виртуальные хосты, созданные Apigee. Теперь вы можете изменять эти виртуальные хосты.

Однако перед тем, как вносить изменения, ознакомьтесь с требованиями к изменению виртуального хоста в разделе Настройка виртуальных хостов для облака. Например, если существующий виртуальный хост настроен на использование порта, отличного от 443, вы не сможете изменить номер порта или настройки TLS. Это означает, что вы не можете изменить настройку TLS с включенной на отключенную или наоборот.

Какой порт можно использовать в виртуальном хосте в облаке?

В виртуальном хосте в облаке можно использовать только порт 443. Нельзя использовать порт 80 или любой другой порт.

Почему я не могу использовать порт 80 в виртуальном хосте в облаке?

Мы рекомендуем клиентам Apigee не использовать виртуальные хосты порта 80 для трафика среды выполнения API, поскольку порт 80 не является безопасным. Во-вторых, поскольку мы не можем подтвердить право собственности на домены, виртуальные хосты порта 80 не могут быть самообслуживаемыми для облака. Изменения виртуальных хостов порта 80 считаются нестандартными, поэтому служба поддержки Apigee Edge оставляет за собой право отклонять такие изменения.

Требуется ли TLS для всех новых виртуальных хостов в облаке?

Чтобы создать виртуальный хост, необходимо включить на нем TLS. Это означает, что сначала нужно создать хранилище ключей с сертификатом и ключом TLS, а затем – виртуальный хост.

У вас должен быть сертификат, подписанный надежной организацией, например Symantec или VeriSign. Нельзя использовать самозаверяющие сертификаты или конечные сертификаты, подписанные самозаверяющим центром сертификации.

Подробнее о том, как настроить виртуальные хосты для облака…

Можно ли закрепить сертификат бесплатной пробной версии Apigee?

В целях безопасности бесплатные пробные сертификаты Apigee истекают каждые три месяца. По истечении этого срока Apigee заменяет сертификат на новый. Поэтому Apigee не рекомендует и не поддерживает закрепление сертификата бесплатной пробной версии.

Можно ли обновить сертификат TLS, используемый виртуальным хостом?

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

Что такое цифровой отпечаток

Ссылка – это переменная, содержащая название хранилища ключей. Чтобы изменить хранилище ключей, используемое виртуальным хостом, обновите переменную ссылки, а не сам виртуальный хост.

Более старые виртуальные хосты в Apigee Edge могут быть не настроены на использование ссылок. В этом случае вам необходимо запросить у службы поддержки Apigee Edge обновление виртуального хоста, чтобы он использовал ссылку. Не изменяйте виртуальный хост самостоятельно, чтобы использовать ссылку.

Как узнать, использует ли мой виртуальный хост ссылку?

Чтобы посмотреть информацию об определенном виртуальном хосте, используйте API Get Virtual Host (Получить виртуальный хост):

curl -X GET -H "accept:application/xml" \
  https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/virtualhosts/{vhost_name} \
  -u orgAdminEmail:pWord

где vhost_name – название виртуального хоста. Например, вы можете указать vhost_name как "secure", чтобы посмотреть конфигурацию виртуального хоста по умолчанию:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>orgname-prod.apigee.net</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>443</Port>
    <Properties/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

Обратите внимание, что в этом примере значение элемента <KeyStore> в ответе начинается с ref://. Этот префикс означает, что хранилище ключей использует ссылку.

Если значение элемента <KeyStore> является строковым литералом, то ссылка не используется. Пример:

<KeyStore>mykeystore</KeyStore>

Не изменяйте виртуальный хост самостоятельно, чтобы использовать ссылку. Чтобы виртуальный хост использовал ссылку, вам необходимо обратиться в службу поддержки Apigee Edge. После того как Apigee обновит виртуальный хост, чтобы использовать ссылку, вы сможете изменить хранилище ключей, обновив переменную ссылки.

Подробнее о том, как настроить виртуальные хосты для облака…

Как создать виртуальный хост?

Чтобы создать виртуальный хост, выполните следующие действия:

  1. Создайте запись DNS и запись CNAME для общедоступного домена, указывающую на [org]-[environment].apigee.net. Подробнее о виртуальных хостах…
  2. Создайте и настройте хранилище ключей, следуя инструкциям в разделе Создание хранилищ ключей и доверенных хранилищ с помощью интерфейса Edge.
  3. Загрузите сертификат и ключ в хранилище ключей.
  4. Создайте ссылку на хранилище ключей, как описано в разделе Настройка виртуальных хостов для облака.
  5. Создайте виртуальный хост с помощью API Create a Virtual Host (Создать виртуальный хост), как описано в разделе Настройка виртуальных хостов для облака. Убедитесь, что указана правильная ссылка на хранилище ключей.
  6. Если у вас есть прокси API, добавьте виртуальный хост в элемент <HTTPConnection> в ProxyEndpoint. Виртуальный хост автоматически добавляется ко всем новым прокси API. Подробнее о том, как настроить прокси-сервер API для использования виртуального хоста…

Можно ли попросить Apigee заблокировать TCP-порты 80, 443 или 15999 в Apigee Edge Cloud?

Поскольку наши клиенты настраивают виртуальные хосты на TCP-порту 443, а иногда и на TCP-порту 80 (хотя использовать порт 80 не рекомендуется), мы не можем заблокировать эти порты, так как это приведет к сбою всего трафика API.

Порт TCP 15999 используется внутри облака, чтобы определить, исправны ли маршрутизаторы. Поэтому его также не следует блокировать, так как это может привести к непредвиденным проблемам при выполнении API.