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:
- Azure Government site
- Microsoft Azure Technical Library on MSDN
- Microsoft Azure Trust Center
- Azure Documentation Center
- 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 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.
Navigate through the links below to get started using Azure Government.
- Login to Azure Government Portal
- Connect with Visual Studio
- Connect with PowerShell
- Connect with CLI
- Connect to Azure Storage
- Connect with Azure SDK for Python
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.
The following table shows the mapping between some Azure services and Azure Government endpoints.
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||Azure Commercial endpoint|
|Active Directory Endpoint and Authority||https://login.microsoftonline.us||https://login.microsoftonline.com
|Active Directory tenant names||[yourtenantname].onmicrosoft.com||[yourtenantname].onmicrosoft.com|
|Active Directory Graph API||https://graph.windows.net/||https://graph.windows.net/|
|Microsoft Graph API||https://graph.microsoft.us/||https://graph.microsoft.com/|
|SQL Database DNS Suffix||*.database.usgovcloudapi.net||*.database.windows.net|
|Storage DNS Suffix||*.core.usgovcloudapi.net||*.core.windows.net|
|Traffic Manager DNS Suffix||*.usgovtrafficmanager.net||*.trafficmanager.net|
|Key Vault DNS Suffix||*.vault.usgovcloudapi.net||*.vault.azure.net|
|Service Bus DNS Suffix||*.servicebus.usgovcloudapi.net||*.servicebus.windows.net|
|Classic Deployment Model Url||https://management.core.usgovcloudapi.net/||https://management.core.windows.net/|
|Publish Settings File Url||https://portal.azure.us#blade/Microsoft_Azure_ClassicResources/PublishingProfileBlade||https://portal.azure.com/#blade/Microsoft_Azure_ClassicResources/PublishingProfileBlade|
For more information about Azure Government, see the following resources:
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.