Connecting a domain
You can connect your own domain to access the API gateway. You can connect multiple domains to a single API gateway. In this case, the domain is identified by the Host header.
Warning
It must be a third-level domain or lower. For example, you can connect the www.example.com domain but not example.com. This has to do with how CNAME records are processed on DNS hosting. Learn more in RFC 1912, Section 2.4.
To connect a domain to an API gateway:
-
Host a CNAME record with your DNS provider or on your own DNS server:
<domain> IN CNAME <API gateway service domain>To find out an API gateway's service domain:
- Go to the management console.
- Select the folder where the API gateway is located, and in the service list, select API Gateway.
- Select the API gateway.
- You can see the service domain under General information.
Domain names must end in a dot.
-
In the management console, select the folder containing the API gateway.
-
In the list of services, select Certificate Manager and:
- Create a certificate from Let's Encrypt®.
- Confirm your domain privileges.
- When the certificate status changes to
Issued, create your domain. In the Certificate field, select the certificate that you created in Step 3.1.
Note
The Let's Encrypt® certificate is valid for 90 days. You need to update. In some cases, domain rights checks are performed automatically.
-
Go back to the folder page.
-
In the list of services, select API Gateway and:
- Select the API gateway.
- In the window that opens, go to Domains.
- Click Connect and select the domain.