diff --git a/docs/docs/recipes/custom-domain/configure-custom-domain-in-console.md b/docs/docs/recipes/custom-domain/configure-custom-domain-in-console.md index 5f0b5bd05ed..bc8ec8aeec6 100644 --- a/docs/docs/recipes/custom-domain/configure-custom-domain-in-console.md +++ b/docs/docs/recipes/custom-domain/configure-custom-domain-in-console.md @@ -12,3 +12,9 @@ To add a new custom domain in the Logto Console, follow these steps: 4. Wait for the verification and SSL process. 1. We will auto-verify your records every 10 seconds until the custom domain is added. Just ensure that the entered domain name or DNS Records are accurate. 2. Verification typically takes a few minutes but can take up to 24 hours, depending on the DNS provider. Feel free to navigate away during the process. + +## Troubleshooting SSL Certificate Issues + +If you encounter SSL certificate issues when setting up your custom domain, it may be related to CAA records in your DNS configuration. CAA records specify which Certificate Authorities (CAs) are authorized to issue certificates for your domain. + +To troubleshoot and resolve SSL certificate issues related to CAA records, refer to [Cloudflare's documentation](https://developers.cloudflare.com/ssl/edge-certificates/caa-records/) on CAA Records. diff --git a/docs/docs/recipes/custom-domain/use-custom-domain.md b/docs/docs/recipes/custom-domain/use-custom-domain.md index 6e483d352b3..4959712b51f 100644 --- a/docs/docs/recipes/custom-domain/use-custom-domain.md +++ b/docs/docs/recipes/custom-domain/use-custom-domain.md @@ -38,9 +38,3 @@ https://auth.example.com/oidc/.well-known/openid-configuration The social connector's callback URI will be updated automatically if your users are using the custom domain. You need to go to the social provider's developer console to update the callback URI. When your users are using the custom domain, the social connector's callback URI will be using the new domain. Therefore, you need to navigate to the social provider's developer console to manually update the callback URI. - -## Troubleshooting SSL Certificate Issues - -If you encounter SSL certificate issues when setting up your custom domain, it may be related to CAA records in your DNS configuration. CAA records specify which Certificate Authorities (CAs) are authorized to issue certificates for your domain. - -To troubleshoot and resolve SSL certificate issues related to CAA records, refer to [Cloudflare's documentation](https://developers.cloudflare.com/ssl/edge-certificates/caa-records/) on CAA Records.