Custom domains
Technical requirements for securing Confluence instances with custom domains.
Last updated
Was this helpful?
Technical requirements for securing Confluence instances with custom domains.
Custom domains in Confluence allow organizations to use a branded URL instead of the default *.atlassian.net address. Even if a Confluence instance has a custom domain configured, proper protection requires adding the instance to GitProtect using the original Atlassian URL.
Confluence instances that use custom domains can be integrated with GitProtect, but must use their original Atlassian URL instead of the custom domain. This limitation results from how Atlassian identifies and authorizes organizations.
Atlassian security and administration APIs are bound to the organization's original Atlassian-managed URL (e.g., yourcompany.atlassian.net), not the custom domain. The custom domain serves as a user-facing alias for access and branding purposes.
Internally, Atlassian recognizes, authenticates, and grants permissions only through the original URL registered in Atlassian Administration (https://admin.atlassian.com). Therefore, GitProtect must use the original Atlassian URL to identify the organization and its applications, authenticate API requests, and enforce security and access controls.
Using the custom domain would prevent proper authorization and could lead to failed connections or incomplete protection, which is why the original Atlassian URL is required even when a custom domain is configured.
You can find organization's original URL in https://admin.atlassian.com > Apps > App URLs > Custom domains > Actions > Show details.

The original URL is listed in the Details section under Default URL (fallback).

Last updated
Was this helpful?
Was this helpful?

