Tutorial: Check data source readiness at scale

To scan data sources, Microsoft Purview requires access to them. It uses credentials to obtain this access. A credential is the authentication information that Microsoft Purview can use to authenticate to your registered data sources. There are a few ways to set up the credentials for Microsoft Purview, including:

• The managed identity assigned to the Microsoft Purview account.
• Secrets stored in Azure Key Vault.
• Service principals.

In this two-part tutorial series, we'll help you verify and configure required Azure role assignments and network access for various Azure data sources across your Azure subscriptions at scale. You can then register and scan your Azure data sources in Microsoft Purview.

Run the Microsoft Purview data sources readiness checklist script after you deploy your Microsoft Purview account and before you register and scan your Azure data sources.

In part 1 of this tutorial series, you'll:

• Locate your data sources and prepare a list of data source subscriptions.
• Run the readiness checklist script to find any missing role-based access control (RBAC) or network configurations across your data sources in Azure.
• In the output report, review missing network configurations and role assignments required by Microsoft Purview Managed Identity (MSI).
• Share the report with data Azure subscription owners so they can take suggested actions.

Prerequisites

• Azure subscriptions where your data sources are located. If you don't have an Azure subscription, create a free account before you begin.
• A Microsoft Purview account.
• An Azure Key Vault resource in each subscription that has data sources like Azure SQL Database, Azure Synapse Analytics, or Azure SQL Managed Instance.
• The Microsoft Purview data sources readiness checklist script.

Note

The Microsoft Purview data sources readiness checklist is available only for Windows. This readiness checklist script is currently supported for Microsoft Purview MSI.

Prepare Azure subscriptions list for data sources

Before running the script, create a .csv file (for example, C:\temp\Subscriptions.csv) with four columns:

Column name	Description	Example
SubscriptionId	Azure subscription IDs for your data sources.	12345678-aaaa-bbbb-cccc-1234567890ab
KeyVaultName	Name of existing key vault that’s deployed in the data source subscription.	ContosoDevKeyVault
SecretNameSQLUserName	Name of an existing Azure Key Vault secret that contains a Microsoft Entra user name that can sign in to Azure Synapse, Azure SQL Database, or Azure SQL Managed Instance by using Microsoft Entra authentication.	ContosoDevSQLAdmin
SecretNameSQLPassword	Name of an existing Azure Key Vault secret that contains a Microsoft Entra user password that can sign in to Azure Synapse, Azure SQL Database, or Azure SQL Managed Instance by using Microsoft Entra authentication.	ContosoDevSQLPassword

Sample .csv file:

Note

You can update the file name and path in the code, if you need to.

Run the script and install the required PowerShell modules

Follow these steps to run the script from your Windows computer:

1. Download the Microsoft Purview data sources readiness checklist script to the location of your choice.

2. On your computer, enter PowerShell in the search box on the Windows taskbar. In the search list, select and hold (or right-click) Windows PowerShell and then select Run as administrator.

3. In the PowerShell window, enter the following command. (Replace <path-to-script> with the folder path of the extracted script file.)

   dir -Path <path-to-script> | Unblock-File
   

4. Enter the following command to install the Azure cmdlets:

   Install-Module -Name Az -AllowClobber -Scope CurrentUser
   

5. If you see the prompt NuGet provider is required to continue, enter Y, and then select Enter.

6. If you see the prompt Untrusted repository, enter A, and then select Enter.

7. Repeat the previous steps to install the Az.Synapse and AzureAD modules.

It might take up to a minute for PowerShell to install the required modules.

Collect other data needed to run the script

Before you run the PowerShell script to verify the readiness of data source subscriptions, obtain the values of the following arguments to use in the scripts:

• AzureDataType: Choose any of the following options as your data-source type to check the readiness for the data type across your subscriptions:

  • BlobStorage

  • AzureSQLMI

  • AzureSQLDB

  • ADLSGen2

  • ADLSGen1

  • Synapse

  • All

• PurviewAccount: Your existing Microsoft Purview account resource name.

• PurviewSub: Subscription ID where the Microsoft Purview account is deployed.

Verify your permissions

Make sure your user has the following roles and permissions:

Role or permission	Scope
Global Reader	Microsoft Entra tenant
Reader	Azure subscriptions where your Azure data sources are located
Reader	Subscription where your Microsoft Purview account was created
SQL Admin (Microsoft Entra authentication)	Azure Synapse dedicated pools, Azure SQL Database instances, Azure SQL managed instances
Access to your Azure key vault	Access to get/list key vault's secret or Azure Key Vault secret user

Run the client-side readiness script

Run the script by completing these steps:

1. Use the following command to go to the script's folder. Replace <path-to-script> with the folder path of the extracted file.

   cd <path-to-script>
   

2. Run the following command to set the execution policy for the local computer. Enter A for Yes to All when you're prompted to change the execution policy.

   Set-ExecutionPolicy -ExecutionPolicy Unrestricted
   

3. Run the script with the following parameters. Replace the DataType, PurviewName, and SubscriptionID placeholders.

   .\purview-data-sources-readiness-checklist.ps1 -AzureDataType <DataType> -PurviewAccount <PurviewName> -PurviewSub <SubscriptionID>
   

   When you run the command, a pop-up window might appear twice prompting you to sign in to Azure and Microsoft Entra ID by using your Microsoft Entra credentials.

It can take several minutes to create the report, depending on the number of Azure subscriptions and resources in the environment.

After the process completes, review the output report, which demonstrates the detected missing configurations in your Azure subscriptions or resources. The results can appear as Passed, Not Passed, or Awareness. You can share the results with the corresponding subscription admins in your organization so they can configure the required settings.

More information

What data sources are supported by the script?

Currently, the following data sources are supported by the script:

• Azure Blob Storage (BlobStorage)
• Azure Data Lake Storage Gen2 (ADLSGen2)
• Azure Data Lake Storage Gen1 (ADLSGen1)
• Azure SQL Database (AzureSQLDB)
• Azure SQL Managed Instance (AzureSQLMI)
• Azure Synapse (Synapse) dedicated pool

You can choose all or any of these data sources as the input parameter when you run the script.

What checks are included in the results?

Azure Blob Storage (BlobStorage)

• RBAC. Check whether Microsoft Purview MSI is assigned the Storage Blob Data Reader role in each of the subscriptions below the selected scope.
• RBAC. Check whether Microsoft Purview MSI is assigned the Reader role on the selected scope.
• Service endpoint. Check whether service endpoint is on, and check whether Allow trusted Microsoft services to access this storage account is enabled.
• Networking: Check whether private endpoint is created for storage and enabled for Blob Storage.

Azure Data Lake Storage Gen2 (ADLSGen2)

• RBAC. Check whether Microsoft Purview MSI is assigned the Storage Blob Data Reader role in each of the subscriptions below the selected scope.
• RBAC. Check whether Microsoft Purview MSI is assigned the Reader role on the selected scope.
• Service endpoint. Check whether service endpoint is on, and check whether Allow trusted Microsoft services to access this storage account is enabled.
• Networking: Check whether private endpoint is created for storage and enabled for Blob Storage.

Azure Data Lake Storage Gen1 (ADLSGen1)

• Networking. Check whether service endpoint is on, and check whether Allow all Azure services to access this Data Lake Storage Gen1 account is enabled.
• Permissions. Check whether Microsoft Purview MSI has Read/Execute permissions.

Azure SQL Database (AzureSQLDB)

• SQL Server instances:

  • Network. Check whether public endpoint or private endpoint is enabled.
  • Firewall. Check whether Allow Azure services and resources to access this server is enabled.
  • Microsoft Entra administration. Check whether Azure SQL Server has Microsoft Entra authentication.
  • Microsoft Entra administration. Populate the Azure SQL Server Microsoft Entra admin user or group.

• SQL databases:

  • SQL role. Check whether Microsoft Purview MSI is assigned the db_datareader role.

Azure SQL Managed Instance (AzureSQLMI)

• SQL Managed Instance servers:

  • Network. Check whether public endpoint or private endpoint is enabled.
  • ProxyOverride. Check whether Azure SQL Managed Instance is configured as Proxy or Redirect.
  • Networking. Check whether NSG has an inbound rule to allow AzureCloud over required ports:
    • Redirect: 1433 and 11000-11999
      or
    • Proxy: 3342
  • Microsoft Entra administration. Check whether Azure SQL Server has Microsoft Entra authentication.
  • Microsoft Entra administration. Populate the Azure SQL Server Microsoft Entra admin user or group.

• SQL databases:

  • SQL role. Check whether Microsoft Purview MSI is assigned the db_datareader role.

Azure Synapse (Synapse) dedicated pool

• RBAC. Check whether Microsoft Purview MSI is assigned the Storage Blob Data Reader role in each of the subscriptions below the selected scope.

• RBAC. Check whether Microsoft Purview MSI is assigned the Reader role on the selected scope.

• SQL Server instances (dedicated pools):

  • Network: Check whether public endpoint or private endpoint is enabled.
  • Firewall: Check whether Allow Azure services and resources to access this server is enabled.
  • Microsoft Entra administration: Check whether Azure SQL Server has Microsoft Entra authentication.
  • Microsoft Entra administration: Populate the Azure SQL Server Microsoft Entra admin user or group.

• SQL databases:

  • SQL role. Check whether Microsoft Purview MSI is assigned the db_datareader role.

Next steps

In this tutorial, you learned how to:

• Run the Microsoft Purview readiness checklist to check, at scale, whether your Azure subscriptions are missing configuration, before you register and scan them in Microsoft Purview.

Go to the next tutorial to learn how to identify the required access and set up required authentication and network rules for Microsoft Purview across Azure data sources:

Configure access to data sources for Microsoft Purview MSI at scale