Облачная платформаEvolution

Управлять доменами


По умолчанию при создании шлюза создается системный домен вида <uuid>.apigw.cloud.ru, где uuid — это идентификатор шлюза.

Чтобы обращаться к шлюзу по адресу пользовательского домена, вы можете добавить домен, подтвержденный SSL-сертификатом.

В API Gateway поддерживаются сертификаты, выпущенные авторизованным центром сертификации, самоподписанные сертификаты и сертификаты Let’s Encrypt.

Перед началом работы

Убедитесь, что в проекте подключен сервис Certificate Manager. Если сервис не подключен, обратитесь в техническую поддержку.

Добавить домен

  1. В личном кабинете перейдите в Разработка → API Gateway.

  2. Перейдите в раздел Shared → Шлюзы.

  3. Выберите нужный шлюз.

  4. Перейдите в раздел Информация.

  5. Нажмите Добавить домен.

  6. В окне Добавить домен укажите следующие параметры:

    • Домен.

      Укажите любой домен в формате example.com или www.example.com.

    • Сертификат.

      В окне Добавить домен вы можете добавить:

      • сертификат, выпущенный в центре сертификации;

      • сертификат Let’s Encrypt;

      • самоподписанный сертификат.

      Выберите сертификат из уже существующих в сервисе Certificate Manager или добавьте новый сертификат, нажав Создать сертификат.

  7. Нажмите Добавить.

Каждый домен вы сможете добавить только для одного шлюза в организации. Добавление одинаковых доменов в разных проектах не допускается.

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

Чтобы домен можно было использовать для доступа к шлюзу, добавьте CNAME-запись.

Добавить CNAME-запись для домена

Чтобы подтвердить права на домен, в публичной зоне DNS вашего DNS-провайдера добавьте CNAME-запись вида:

<added domain> CNAME <uuid>.apigw.cloud.ru

Где:

  • <added domain> — добавленный домен;

  • <uuid>.apigw.cloud.ru — системный домен шлюза по умолчанию.

Например, если системный домен вашего шлюза — 42e0235068244545b8aac739d3283286.apigw.cloud.ru и вы добавили домен test.com, добавьте CNAME-запись:

test.com CNAME 42e0235068244545b8aac739d3283286.apigw.cloud.ru

После успешного прохождения проверки прав на домен вы сможете использовать адрес добавленного домена для обращения к шлюзу.

Удалить пользовательский домен

Вы можете удалить пользовательский домен. Системный домен не может быть удален.

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

  1. В личном кабинете перейдите в раздел Разработка → API Gateway.

  2. Перейдите в раздел Shared → Шлюзы.

  3. Выберите нужный шлюз.

  4. В личном кабинете перейдите в Разработка → API Gateway в раздел Шлюзы и выберите нужный шлюз.

  5. На вкладке Информация в области Домены рядом с нужным доменом нажмите Удалить.

Пользовательский домен будет удален.