Подключиться
Yandex API Gateway

Подключение домена

Статья создана

    Вы можете подключить собственный домен для обращения к API-шлюзу. К одному API-шлюзу можно подключить несколько доменов. В таком случае домен будет идентифицироваться по заголовку Host.

    Важно

    Домен должен быть ниже второго уровня. Например, можно подключить домен www.example.com, а example.com — нельзя. Это связано с особенностями обработки CNAME-записей на DNS-хостингах. Подробнее в RFC 1912, пункт 2.4.

    Чтобы подключить домен к API-шлюзу:

    1. Разместите у своего DNS-провайдера или на собственном DNS-сервере CNAME-запись:

      <домен> IN CNAME <служебный домен API-шлюза>

      Чтобы узнать служебный домен API-шлюза:

      1. Перейдите в консоль управления.
      2. Выберите каталог, в котором находится API-шлюз, и в списке сервисов — API Gateway.
      3. Выберите API-шлюз.
      4. Служебный домен будет в блоке Общая информация.

      Доменные имена должны заканчиваться точкой.

    2. В консоли управления выберите каталог, в котором находится API-шлюз.

    3. В списке сервисов выберите Certificate Manager и в нем:

      1. Создайте сертификат от Let's Encrypt®.
      2. Подтвердите права на домен.
      3. Когда сертификат перейдет в статус Issued, создайте домен. В поле Сертификат выберите сертификат, который создали на Шаге 3.1.

      Примечание

      Срок действия сертификата от Let's Encrypt® — 90 дней. Его нужно своевременно обновлять. В некоторых случаях процедура проверки прав на домен проходит автоматически.

    4. Вернитесь на страницу каталога.

    5. В списке сервисов выберите API Gateway и в нем:

      1. Выберите API-шлюз.
      2. В открывшемся окне перейдите в раздел Домены.
      3. Нажмите Подключить и выберите домен.