Skip to content

Commit 84bde84

Browse files
Merge pull request #247335 from dlepow/docs-editor/configure-custom-domain-1691110486
Update configure-custom-domain.md
2 parents 7bd9aca + 59db0be commit 84bde84

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

articles/api-management/configure-custom-domain.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,10 @@ If you already have a private certificate from a third-party provider, you can u
7575

7676
We recommend using Azure Key Vault to [manage your certificates](../key-vault/certificates/about-certificates.md) and setting them to `autorenew`.
7777

78-
If you use Azure Key Vault to manage a custom domain TLS certificate, make sure the certificate is inserted into Key Vault [as a _certificate_](/rest/api/keyvault/certificates/create-certificate/create-certificate), not a _secret_.
78+
If you use Azure Key Vault to manage a custom domain TLS certificate, make sure the certificate is inserted into Key Vault [as a ](/rest/api/keyvault/certificates/create-certificate/create-certificate)_[certificate](/rest/api/keyvault/certificates/create-certificate/create-certificate)_, not a _secret_.
79+
80+
> [!CAUTION]
81+
> When using a key vault certificate in API Management, be careful not to delete the certificate, key vault, or managed identity used to access the key vault.
7982
8083
To fetch a TLS/SSL certificate, API Management must have the list and get secrets permissions on the Azure Key Vault containing the certificate.
8184
* When you use the Azure portal to import the certificate, all the necessary configuration steps are completed automatically.
@@ -106,6 +109,8 @@ API Management offers a free, managed TLS certificate for your domain, if you do
106109
* Does not support root domain names (for example, `contoso.com`). Requires a fully qualified name such as `api.contoso.com`.
107110
* Can only be configured when updating an existing API Management instance, not when creating an instance
108111

112+
113+
109114
---
110115
## Set a custom domain name - portal
111116

@@ -162,6 +167,8 @@ Choose the steps according to the [domain certificate](#domain-certificate-optio
162167
> [!NOTE]
163168
> The process of assigning the certificate may take 15 minutes or more depending on size of deployment. Developer tier has downtime, while Basic and higher tiers do not.
164169
170+
171+
165172
---
166173

167174
## DNS configuration
@@ -199,3 +206,4 @@ You can also get a domain ownership identifier by calling the [Get Domain Owners
199206

200207
[Upgrade and scale your service](upgrade-and-scale.md)
201208

209+

0 commit comments

Comments
 (0)