---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Set up Azure service accounts

# Set up Azure service accounts {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Create and configure cloud service accounts at ServiceNow AI Platform for the corresponding Microsoft Azure accounts.

## Verify the REST API Permissions {#setup-azure-service-accounts__section_onh_dcp_v2c}

Download the [Cloud Discovery patterns spreadsheet](https://downloads.docs.servicenow.com/resource/enus/api/servicenow-discovery-patterns-api-details.xlsx) so you can grant user permissions required for running the Discovery patterns. In addition to permissions, the spreadsheet also includes useful information such as pattern names, types, CI Classes, and links to vendor documentation. New patterns are available
quarterly, so check periodically to be sure you have the latest version of the spreadsheet.{#setup-azure-service-accounts__cloud-discovery-api-paragraph}

## Before you begin

Ensure the configuration of Azure credentials
:   For more information, see [Create Azure cloud credentials](https://servicenow-prod.fluidtopics.net/S0rTUg4IoSKTvPVjSkCBwQ "If your cloud resources are in an Azure cloud, create credentials that can access the Azure account. This procedure requires configuration in your Azure account.") and [Configuration steps for Azure Service Principal User and Credentials (KB2202765)](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB2202765)

Ensure that you are familiar with the hierarchy of the Azure service accounts in your environment.
:
    Set up the service accounts at ServiceNow AI Platform to reflect the hierarchy of your environment. You can set up the Azure service accounts for the following Azure account types:

    * Management group.
    * Subscription.
    {#setup-azure-service-accounts__ul_hnd_pkb_5hb}

Role required: discovery_admin

## About this task

A service account is a secure record on your instance that stores the credentials and access information for your provider account. Discovery uses the information to access your provider account to get data on each resource in each specified datacenter. A cloud account is the logical representation in cloud management of all or part of your
managed cloud infrastructure. A cloud account can include multiple service accounts---even service accounts from different providers. For each service account, you specify which datacenter to include in the cloud account.

## Procedure

1. In the navigation filter, enter <kbd class="ph userinput">cmdb_ci_cloud_service_account.list</kbd>.
2. Select New.
3. Fill in the fields by the following order:  
   1. Select the datacenter.
   2. Select the check box of the Is management account if your are creating a service account for a management group.
   3. Select Should pull events to preform event-based discovery. For more information, see [Microsoft Azure Alert driven discovery](https://servicenow-prod.fluidtopics.net/lHXJClXQGbinwpoNOhYIqw#microsoft-azure-alert-driven-discovery "The Microsoft Azure Alert service can raise alerts for any changes in the life-cycle state or the configuration of a cloud resource. You can configure the service to auto-update the latest resource information in the Configuration Management Database (CMDB) without waiting for the next scheduled Cloud Discovery to run.")

   {#setup-azure-service-accounts__ol_gyg_zwg_xfc} {#setup-azure-service-accounts__table-azure-service-acct-form__entry__2}

   | Field | Description |
   |-|-|
   | Name | The unique and meaningful name for this service account. |
   | Account ID | If you are creating a service account for a management group, fill in the Azure management group ID that belongs to the management group. If you are creating a service account for a subscription, fill in the Azure subscription ID. |
   | Discovery credentials | The credentials needed for ServiceNow applications to access this account. |
   | Datacenter URL | URL of the datacenter. Configuring this field is required for Azure Gov Cloud (US) accounts. For example, <https://management.usgovcloudapi.net/.> |
   | Datacenter type | Type of the datacenter where the account is hosted. Select Azure datacenter. |
   | Datacenter discovery status | Auto-generated value: Status and timestamp of the last execution of discovery on the datacenter. |
   | Parent account | When setting up a service account for an Azure subscription, fill in the management group ID. When the Is management account check box is selected, the Parent account field is not applicable |
   | Accessor account | Not applicable for Azure service accounts. |
   [Table 1. Cloud Service Account form]

   {#setup-azure-service-accounts__table-azure-service-acct-form}
4. Select Submit.
**Related concepts**   

* [Discovery for Microsoft Azure Cloud](https://servicenow-prod.fluidtopics.net/iMXKXsU7K2dnNRjDU4ObTg "If your cloud resources are in an Azure cloud, you must create a user identity called a service principal that grants permissions to the MID Server to access selected resources.")