Skip to content

Commit 0bd24ac

Browse files
authored
[All Hosts] (DevX) GCC now has a special URL (#5007)
* [All Hosts] (DevX) GCC now has a special URL * heading fix * review changes
1 parent aec1b01 commit 0bd24ac

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

docs/publish/government-cloud-guidance.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Guidance for deploying Office Add-ins on government clouds
33
description: Learn how to deploy your Office Add-in to secure, government cloud environments
44
ms.topic: best-practice
5-
ms.date: 10/10/2023
5+
ms.date: 1/28/2025
66
ms.localizationpriority: medium
77
---
88

@@ -24,22 +24,25 @@ For all government cloud (i.e. Sovereign Cloud) environments, the public Microso
2424

2525
[Centralized deployment](/microsoft-365/admin/manage/centralized-deployment-of-add-ins) of add-ins outside of the store is still supported.
2626

27-
## US Government Community Cloud (GCC)
27+
In addition to requirements applicable to all Sovereign Clouds, each Sovereign Cloud environment has its own considerations that may affect Office Add-ins targeting the environment. These requirements and recommendations are described in the following sections.
2828

29-
In addition to requirements applicable to all Sovereign Clouds, each Sovereign Cloud environment has its own considerations that may affect Office Add-ins targeting the environment. GCC is the least restrictive of the government cloud environments and some of the resources required by the add-in are available from their usual production endpoints in this environment. One such resource is the Office JavaScript API library. Solution partners can continue to reference the public Office.js resource as they do with their public production solution.
29+
### US Government Community Cloud (GCC)
3030

31-
## GCC High (GCCH), US Department of Defense (DOD), or other sovereign managed clouds
31+
GCC is the least restrictive of the government cloud environments. Solution partners are permitted to reference the public Office JavaScript API library (office.js) resource as they do with their public production solution. However, we recommend that partners reference the library from the following URL.
3232

33-
These government clouds remain internet-connected, but the set of public endpoints made available is severely restricted. One such restricted endpoint is the public endpoint for loading the Office JavaScript API library. The public CDN location for Office.js will not be accessible from within these environments. However, there will be an internal, per-cloud Microsoft Office CDN provisioned with the same resource. This means the endpoint URL to access Office.js will be different and your Office Add-in may need some level of customization to run. Given the additional restrictions, it's likely that any solution provided to customers will require hosting provider services within the environment as well, necessitating additional customizations. You'll need to determine the best way to provide your solution to customers, such that it conforms to the additional restrictions imposed on services running within the boundaries of these environments. The Office JavaScript Library CDN URLs are as follows:
33+
- **GCC**: `https://appsforoffice.gcc.cdn.office.net/appsforoffice/lib/1/hosted/office.js`
3434

35-
- **GCC High**: https://appsforoffice.gcch.cdn.office.net/appsforoffice/lib/1/hosted/office.js
36-
- **DOD**: https://appsforoffice.dod.cdn.office.net/appsforoffice/lib/1/hosted/office.js
35+
### GCC High (GCCH), US Department of Defense (DOD), or other sovereign managed clouds
3736

37+
These government clouds remain internet-connected, but the set of public endpoints made available is severely restricted. One such restricted endpoint is the public endpoint for loading the Office JavaScript API library. The public CDN location for Office.js won't be accessible from within these environments. However, there'll an internal, per-cloud Microsoft Office CDN provisioned with the same resource. This means the endpoint URL to access Office.js will be different and your Office Add-in may need some level of customization to run. Given the additional restrictions, it's likely that any solution provided to customers will require hosting provider services within the environment as well, necessitating additional customizations. You'll need to determine the best way to provide your solution to customers, such that it conforms to the additional restrictions imposed on services running within the boundaries of these environments. The Office JavaScript Library CDN URLs are as follows:
3838

39-
## Airgapped Sovereign Clouds
39+
- **GCC High**: `https://appsforoffice.gcch.cdn.office.net/appsforoffice/lib/1/hosted/office.js`
40+
- **DOD**: `https://appsforoffice.dod.cdn.office.net/appsforoffice/lib/1/hosted/office.js`
41+
42+
### Airgapped Sovereign Clouds
4043

4144
These government clouds are essentially disconnected from the public internet entirely. Any resource that would normally be accessed from public resources must instead be custom-provisioned inside these cloud environments. In the GCCH and DOD clouds mentioned previously, most (if not all) solution providers will need to provision their services and resources inside the cloud. There is an option to make firewall exceptions that allows access to public services and resources. However, this bypass is not possible in airgapped clouds. As with the GCCH and DOD clouds, there will be a Microsoft Office CDN provisioned inside each cloud environment that hosts required resources such as the Office.js library. You'll need to work closely with customer tenant administrators to determine the best way to provide your services and resources in a way that conforms to the strict access requirements for airgapped Sovereign Clouds.
4245

43-
## Office 365 operated by 21Vianet
46+
### Office 365 operated by 21Vianet
4447

4548
[!INCLUDE [Information about the China-specific CDN](../includes/21Vianet-CDN.md)]

0 commit comments

Comments
 (0)