Set up Microsoft Azure Government Cloud on Cloud Provisioning and Governance

Set up Microsoft Azure Government Cloud on Cloud Provisioning and Governance for the first time. You can discover, provision, and manage Microsoft Azure Government Cloud resources using Cloud Provisioning and Governance, thereafter.

Before you begin

To set up Microsoft Azure Government cloud on Cloud Provisioning and Governance, you must:

• Set up a Microsoft Azure Service Principal on the Azure Government Portal and register the service account on the Cloud Provisioning and Governance application.
• Configure a MID Server with the required properties to enable Microsoft Azure Government and the ServiceNow instance to communicate correctly.
• Use the Microsoft Azure Service Principal credentials to discover associated service accounts and cloud resources.

• In the base system Terraform template, set the environment variable to usgovernment. For information on where to find the template to modify, see Discover the Infrastructure as Code (IaC) templates.

  provider "azurerm" {
       subscription_id = "<REPLACE_WITH_ACCOUNT_ID»"
       client_id = "<REPLACE_WITH_APP_ID»"
       client_secret = "<REPLACE_WITH_PASSWORD»"
       tenant_id = "<REPLACE_WITH_TENANT_ID»"
       environment = "usgovernment"
    }
  

Role required: admin

Note: ServiceNow® ITOM products are not officially certified or supported for Germany and China regions.

About this task

Be sure to perform the procedures in order. After you have performed the Day 1 setup, you can perform the optional Day 2 setup and configuration procedures as needed and in any order. Detailed instructions for each procedure follow this overview.

Procedure

1. Create a Microsoft Azure service principal on the Microsoft Azure Government portal.

   Note: Navigate to App registrations > Register an application > Supported account types section. Then, select the Accounts in this organizational directory only (Single tenant) option to ensure that the Active Directory that is configured for the Microsoft Azure Government cloud is used for authentication.

   For more information, see Create an Azure AD application and service principal that can access resources.

2. Configure MID Servers to connect Cloud Provisioning and Governance to a Microsoft Azure Government cloud account.

   1. Navigate to MID server > Capabilities.

   2. Click Edit and add the following options:

      • Azure
      • Cloud Management
        1. Click Save.

   3. Navigate to MID server > Supported Applications.

      Skip the next step if ALL applications are selected.

   4. Click Edit and add the following applications to the Supported Applications List:

      • Discovery
      • Cloud Management
      • Orchestration
        1. Click Save.

      Note: For more information, see:

      • MID server selection
      • MID server capabilities
      • Navigate to MID server > Properties.

   5. Click New and add new records for each of the following name-value pairs:

      MID Server properties

      Name	Value
      mid.cmp.azure_api.base_endpoint	https://management.usgovcloudapi.net/${apiPath}
      mid.cmp.azure_api.storage.container.path	https://${accountName}.blob.core.usgovcloudapi.net/?comp=list
      mid.property.azure_token_manager.endpoint	https://login.microsoftonline.us/${tenantId}/oauth2/token
      mid.property.azure_token_manager.endpoint_content	grant_type=client_credentials&client_id=${clientId}&resource=https%3A%2F%2Fmanagement.usgovcloudapi.net%2F&client_secret=${clientSecret}
      mid.cmp.azure_api.storage.blob.path	https://${accountName}.blob.core.usgovcloudapi.net/${containerName}?restype=container&include=snapshots&comp=list

   6. Click Submit.

3. Store the Azure service principal credentials in the instance.

4. In the Cloud Admin Portal, navigate to Manage > Credentials, and select the Azure Service principal record.

5. To discover service accounts associated to the Azure subscriptions that are available to this Service principal, click the Discover Subscriptions related link.

Result

The Azure Subscriptions related list displays all subscriptions that are associated with the Azure service principal.

What to do next

Define the schedule for downloading Microsoft Azure billing data.