Azure Government developer guide

The Azure Government environment is a physical instance that is separate from the rest of the Microsoft network. This guide discusses the differences that application developers and administrators must understand to interact and work with the different national clouds.


Azure Government is a separate instance of the Microsoft Azure service. It addresses the security and compliance needs of United States federal agencies, state and local governments, and their solution providers. Azure Government offers physical isolation from non-US government deployments and provides screened US personnel.

Microsoft provides various tools to help developers create and deploy cloud applications to the global Microsoft Azure service (“global service”) and Microsoft Azure Government services.

When developers create and deploy applications to Azure Government services, as opposed to the global service, they need to know the key differences between the two services. The specific areas to understand are: setting up and configuring their programming environment, configuring endpoints, writing applications, and deploying the applications as services to Azure Government.

The information in this document summarizes the differences between the two services. It supplements the information that's available on the Azure Government site and the Microsoft Azure Technical Library on MSDN. Official information might also be available in other locations, such as the Microsoft Azure Trust Center, Azure Documentation Center, and Azure Blogs.

This content is intended for partners and developers who are deploying to Microsoft Azure Government.

Guidance for developers

Most of the currently available technical content assumes that applications are being developed for the global service rather than for Azure Government. For this reason, it’s important to be aware of two key differences in applications that you develop for hosting in Azure Government.

  • Certain services and features that are in specific regions of the global service might not be available in Azure Government.
  • Feature configurations in Azure Government might differ from those in the global service. Therefore, it's important to review your sample code, configurations, and steps to ensure that you are building and executing within the Azure Government Cloud Services environment.

Currently, US GOV Iowa and US GOV Virginia are the datacenters that support Azure Government. For current datacenters and available services, see Products available by region.

Endpoint mapping

To learn about mapping public Azure and SQL Database endpoints to Azure Government-specific endpoints, see the following table:


The Active Directory Authority for Azure Government has changed from to The original URL will continue to work but all applications should be updated to the new authority URL.

Name Azure Government endpoint
Active Directory Endpoint
Active Directory Authority
Active Directory Graph API
Azure API
SQL Database DNS Suffix
Storage Endpoint Suffix
Traffic Manager Dns Suffix
Key Vault Dns Suffix
Classic Portal
Gallery Url
Service Management Url
Publish Settings File Url

Next steps

For more information about Azure Government, see the following resources: