Migrating Confluence to SharePoint in GCC, GCC High, and DoD Environments

WikiTraccs migrates Confluence to SharePoint Online in the Microsoft 365 government clouds as well. This works since release v1.18.10, where support was added and verified with a real GCC High migration.

The catch: WikiTraccs connects to the commercial Microsoft 365 cloud by default. For a government cloud you have to tell it which environment to use, via one small configuration setting. Without that setting the SharePoint connection will not work. This post shows what to configure.

Which environments are there?

Microsoft operates several isolated Microsoft 365 clouds. The ones relevant here:

There is also a setting value for the Microsoft 365 cloud operated by 21Vianet in China. The former Microsoft Cloud Germany has been retired by Microsoft.

Only the SharePoint side is affected by all this. The Confluence side of the migration is the same in every environment.

Which environment do I have?

The quickest tells:

• Look at your SharePoint URL: *.sharepoint.us means GCC High, *.sharepoint-mil.us means DoD, *.sharepoint.com means commercial or GCC.
• Look at the sign-in page when logging in to Microsoft 365: login.microsoftonline.us means GCC High or DoD.
• GCC (without “High”) looks like the commercial cloud from the outside, same sharepoint.com URLs. If you are unsure whether you are on GCC or commercial, your Microsoft 365 administrator or your Microsoft licensing partner can tell you.

What to configure in WikiTraccs

Create a file named appsettings.json in the folder where WikiTraccs.GUI.exe is located, with this content:

{
  "CustomSettings": {
    "CloudEnvironment": "USGovernmentHigh"
  }
}

Use the value that matches your environment:

Then restart WikiTraccs. It will now use the correct sign-in, SharePoint, and Microsoft Graph endpoints for your cloud.

Notes:

• Set the value explicitly, even if the environment looks auto-detectable from the URL. A .us URL alone does not tell WikiTraccs whether it is GCC High or DoD.
• The Entra ID app registration for WikiTraccs is created in your government tenant.
• More on the configuration file: Configuration file reference.

If it does not work: send me the logs

One thing I want to be transparent about: Microsoft does not provide me with a government cloud test tenant, I tried. So I cannot reproduce GCC-specific issues on my side and rely on log files from your environment.

The logs contain what I need, and this combination has been diagnosed and fixed successfully before, purely based on customer logs. So if the connection fails after configuring the environment:

1. Trigger the failing action once (for example the SharePoint connection test).
2. Grab the common log files.
3. Send them to [email protected], together with your CloudEnvironment value and the SharePoint URL you are targeting.

I will take a look and get back to you.

• ←Previous
Next→