[Документация Yandex Cloud](../../index.md) > [Yandex API Gateway](../index.md) > [Пошаговые инструкции](index.md) > Управление API-шлюзом > Подключить домен

# Подключить домен

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

{% note warning %}

Если вашим доменом управляет сторонний DNS-провайдер, домен должен быть ниже второго уровня. Например, можно подключить домен `www.example.com`, а `example.com` — нельзя. Это связано с особенностями обработки CNAME-записей на DNS-хостингах. Подробнее в [RFC 1912, пункт 2.4](https://www.ietf.org/rfc/rfc1912.txt).

Чтобы использовать домен второго уровня (`example.com`), делегируйте его [Yandex Cloud DNS](../../dns/index.md) и создайте [ANAME-запись](../../dns/concepts/resource-record.md#aname) в зоне DNS.

{% endnote %}

На домене должен быть установлен [X.509‑сертификат](https://ru.wikipedia.org/wiki/X.509), соответствующий требованиям [IETF](https://www.ietf.org/) (RFC [2459](https://www.ietf.org/rfc/rfc2459.txt)/[3280](https://www.ietf.org/rfc/rfc3280.txt)/[5280](https://www.ietf.org/rfc/rfc5280.txt)). Для сертификатов с алгоритмом [ECDSA](https://ru.wikipedia.org/wiki/ECDSA) поддерживается только кривая P‑256.

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

{% list tabs group=instructions %}

- Консоль управления {#console}

    1. Разместите у своего DNS-провайдера или на собственном DNS-сервере CNAME-запись:
    
        ```text
        <домен> IN CNAME <служебный_домен_API-шлюза>
        ```

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

       1. Перейдите в [консоль управления](https://kz.console.yandex.cloud).
       1. Выберите каталог, в котором находится API-шлюз, и Перейдите в сервис **API Gateway**.
       1. Выберите API-шлюз.
       1. Служебный домен будет в поле **Служебный домен**.

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

        Чтобы использовать домен выше второго уровня, делегируйте его [Yandex Cloud DNS](../../dns/index.md) и [создайте](../../dns/operations/resource-record-create.md) ANAME-запись в зоне DNS. Создать запись в Yandex Cloud DNS можно не только до, но и после создания домена. Смотрите шаг 6.

    1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором находится API-шлюз.

    1. Перейдите в сервис **Certificate Manager** и в нем:

        1. Добавьте [сертификат от Let's Encrypt<sup>®</sup>](../../certificate-manager/operations/managed/cert-create.md) или [пользовательский сертификат](../../certificate-manager/operations/import/cert-create.md) для подключаемого домена.

            {% note info %}

            Сертификаты необходимо своевременно обновлять. Подробнее о том, как обновить [сертификат от Let's Encrypt<sup>®</sup>](../../certificate-manager/operations/managed/cert-update.md) и [пользовательский сертификат](../../certificate-manager/operations/import/cert-update.md).

            {% endnote %}

        1. Дождитесь, когда сертификат перейдет в статус `Issued`.
    
    1. Вернитесь на страницу каталога.

    1. Перейдите в сервис **API Gateway** и в нем:

        1. Выберите API-шлюз.
        1. Перейдите на вкладку **Домены**.
        1. Нажмите **Подключить**, выберите сертификат и введите имя домена ([FQDN](../../glossary/fqdn.md)).           

    1. Если вы пропустили шаг 1 и не разместили CNAME-запись, создайте ANAME-запись в Yandex Cloud DNS:

        1. В строке с доменом нажмите кнопку **Создать запись**.
        1. Если у вас нет DNS-зоны, имя которой совпадает с доменом, создайте ее. Для этого нажмите **Создать зону**.
        1. Если необходимо, в поле **TTL (в секундах)** выберите другое значение.
        1. Нажмите кнопку **Создать**.
        
- API {#api}

  Чтобы подключить домен к API-шлюзу, воспользуйтесь методом REST API [addDomain](../apigateway/api-ref/ApiGateway/addDomain.md) для ресурса [ApiGateway](../apigateway/api-ref/ApiGateway/index.md) или вызовом gRPC API [ApiGatewayService/AddDomain](../apigateway/api-ref/grpc/ApiGateway/addDomain.md).

{% endlist %}