Skip to content

Commit a0b1fc5

Browse files
committed
add-warning-of-academy
Signed-off-by: Zihan Kuang <zihan_kuang@outlook.com>
1 parent 3de54b9 commit a0b1fc5

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

  • content/en/cloud/self-hosted/white-labeling

content/en/cloud/self-hosted/white-labeling/_index.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,10 @@ A subdomain is the part of a URL before the root domain. You can configure your
118118

119119
Subdomains are configured with a CNAME record through your DNS provider.
120120

121+
{{< alert title="Changing Custom Domain May Break Academy Integration" color="warning" >}}
122+
Changing your custom domain name after configuring an external Academy can break the content integration. If you change your domain, you **must** also update the organizational folder name (`/content/learning-paths/<your-org-name>`) in your Academy content repository to match.
123+
{{< /alert >}}
124+
121125
### Configuring a subdomain
122126

123127
To set up a www or custom subdomain, such as `www.example.com` or `meshery.example.com`, you must add your domain in the repository settings. After that, configure a CNAME record with your DNS provider.
@@ -132,7 +136,7 @@ Under "Custom domain", type your custom domain, then click Save. This will creat
132136

133137
Navigate to your DNS provider and create a CNAME record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `hub.cncf.io` for your user site, create a CNAME record that points `hub.cncf.io` to `cloud.layer5.io`. For more information about how to create the correct record, see your DNS provider's documentation.
134138

135-
{{< alert title="Warning" color="warning" >}}
139+
{{< alert title="Risks of Using Wildcard DNS Records" color="warning" >}}
136140
Warning: We strongly recommend that you do not use wildcard DNS records, such as `*.example.com`. These records put you at an immediate risk of domain takeovers, even if you verify the domain. For example, if you verify example.com this prevents someone from using `a.example.com`, but they could still take over `b.a.example.com` (which is covered by the wildcard DNS record).
137141
{{< /alert >}}
138142

0 commit comments

Comments
 (0)