You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/logto-cloud/custom-domain.mdx
+29Lines changed: 29 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,6 +18,7 @@ Your custom domains are used for several functions:
18
18
- Callback URIs for [social connectors](/connectors/social-connectors) or [enterprise SSO connectors](/connectors/enterprise-connectors).
19
19
-[Passkey](/end-user-flows/mfa/webauthn) and [passkey sign-in](/end-user-flows/sign-up-and-sign-in/passkey-sign-in) related URLs (Changing the domain after users have linked Passkeys may block both MFA and sign-in with those credentials).
20
20
-[SDK endpoint](/integrate-logto/application-data-structure#openid-provider-configuration-endpoint) for integrating Logto with your application.
21
+
- Domain ownership verification files for third-party platforms (for example WeChat, Apple, or other services that require a static file on your domain).
Some third-party platforms require you to host a small text or JSON file on your domain to prove ownership before you can use their OAuth, SSO, or other integrations. Because a Logto custom domain points to Logto Cloud, you cannot upload that file to your own origin. Logto can host those files for you.
64
+
65
+
After a custom domain is **Active**, open the domain card in <CloudLinkto="/tenant-settings/domains">Console > Settings > Domains</CloudLink> and use the **Domain verification files** section to add, update, or remove files.
66
+
67
+
**Supported paths**
68
+
69
+
- Root-level filenames with an extension, such as `/MP_verify_xxx.txt` or `/apple-developer-domain-association.txt`
70
+
- Paths under `/.well-known/`, such as `/.well-known/apple-developer-domain-association.txt`
71
+
72
+
Only letters, numbers, dots, hyphens, and underscores are allowed in path segments. Nested paths outside `/.well-known/` are not supported.
73
+
74
+
**Limits**
75
+
76
+
- Up to **10** verification files per custom domain
77
+
- Content size up to **16,384** characters per file
78
+
- Content type: plain text (`text/plain`) or JSON (`application/json`)
79
+
80
+
Once saved, Logto serves an exact match for `GET` and `HEAD` requests on the custom domain, for example:
0 commit comments