Space Page load failure due to Custom Domain URLs

Am I affected?

If your site has been updated to use custom domain URL (https://support.atlassian.com/organization-administration/docs/add-a-custom-domain/), or a re-routing product URL for Confluence (https://support.atlassian.com/organization-administration/docs/update-a-product-url/), this may cause an unwanted side effect resulting in Space admins from being unable to load the Space Admin section of the app location in Space Settings.

 

  • You are affected if you try to render the Space page located in Space Settings, and the app attempts to load, but results in a blank screen:

image-20240611-195416.png

The following issue is derived from our internal ticket: https://thepluginpeople.atlassian.net/browse/CSUMC-121, and fixes app rendering for customers that have updated product URL or custom domains.

For other errors, please view our FAQ for more information on identified problems.

 

 How to resolve the issue

As a System admin, you can resolve this issue for all Space admins by performing the following steps:

  1. Update the CSUMCloud app to the latest version. Currently, 9.2.0 for the CSUMCloud addon, and 3.1.0 for the CSUM for DC and Cloud addon.

  2. Navigate to the System admin section of the app (See System Admin Documentation for more information).

  3. Export your current configuration to receive a json file.

  4. Using a text editor of your choice, open the file, and navigate to the csumDefaultName attribute. Screenshot from 2024-06-11 20-34-09.png. (If you do not see this attribute, please check step 1 and ensure you are on the latest version).

  5. Replace the existing URL with the original Atlassian site URL. Screenshot from 2024-06-11 20-46-15.png (If you are unsure of this, please read ‘How to retrieve my original site URL?’ below.)

  6. Save your changes and Import the updated json file using the Import option.

Note: It is important that your original site url is in the following format:

"https://<SITENAME>.atlassian.net"

The above example in step 5 shows the correct format to be used.

After changes have been saved, you can navigate to the Space admin view of our app from within the Space Settings page to validate changes have been applied and will now render the app correctly.

 

How to retrieve my original site URL?

When creating your Confluence instance, the site url provided is used to generate default groups.

E.g. The site mysite.atlassian.net will create default groups containing mysite, such as confluence-admins-mysite.

 

image-20240611-194921.png

You can navigate to the Atlassian Administration > Groups management section of your site to confirm the original site URL. By searching for admins or users, you should find the default created confluence-users-<SITENAME>.

 

Why did changing the URL break the app?

Due to limitations with the Confluence Cloud Rest API Group Search functionality, default access groups are exposed. In order to reduce exposure of these default groups, and to prevent Space Admins from being able to view, or edit memberships, of these groups, the CSUMCloud app attempts to filter out these groups from the space groups table and group search fields.

 

Some default groups are appended with the original site name. E.g. The site mysite.atlassian.net will create default groups containing mysite, such as confluence-admins-mysite. If the product URL changes, or a custom domain is applied, the CSUMCloud app is unable to filter these exposed groups. The default scenario was to prevent rendering in this scenario. After the above steps have been applied to resolve the issue, the CSUMCloud app should be able to continue filtering out the default groups when loading the space groups table.

We are currently discussing this issue with Atlassian on https://ecosystem.atlassian.net/servicedesk/customer/portal/34/ECOHELP-42134 to assess any further changes that can be made to improve performance without affecting customers that have updated their Site using custom domains.

 

After performing the above steps, subsequent changes to your product URL or custom domains should not affect how CSUMCloud filters default groups.