Azure Government developer guide

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
  • Deploying 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 through the following sources:

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 DoD East, US DoD Central, US Gov Virginia, US Gov Arizona, US Gov Texas and US Gov Iowa are the datacenters that support Azure Government. For current datacenters and available services, see Products available by region.

Quickstarts

Navigate through the links below to get started using Azure Government.

Azure Government Video Library

The Azure Government video library contains many helpful videos to get you up and running with Azure Government.

Compliance - Azure Blueprint

The Azure Blueprint program is designed to facilitate the secure and compliant use of Azure for government agencies and third-party providers building on behalf of government.

For more information on Azure Government Compliance, refer to the compliance documentation and watch this video.

Endpoint mapping

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

Note

The Active Directory Authority for Azure Government has changed from https://login-us.microsoftonline.com to https://login.microsoftonline.us. The original URL will continue to work but all applications should be updated to the new authority URL.

Name Azure Government endpoint
Portal https://portal.azure.us
Active Directory Endpoint https://login-us.microsoftonline.com/
Active Directory Authority https://login.microsoftonline.us
Active Directory Graph API https://graph.windows.net/
Azure API https://management.usgovcloudapi.net/
SQL Database DNS Suffix *.database.usgovcloudapi.net
Storage Endpoint Suffix *.core.usgovcloudapi.net
Traffic Manager DNS Suffix *.usgovtrafficmanager.net
Key Vault DNS Suffix *.vault.usgovcloudapi.net
Classic Portal https://manage.windowsazure.us
Gallery Url https://gallery.usgovcloudapi.net/
Classic Deployment Model Url https://management.core.usgovcloudapi.net/
Publish Settings File Url https://manage.windowsazure.us/publishsettings/index

Next steps

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