Skip to content

Commit c651e7e

Browse files
authored
Merge pull request #207797 from inward-eye/main
created include file for Azure SQL DB config
2 parents 5df2f4f + f3ff3ba commit c651e7e

File tree

3 files changed

+52
-42
lines changed

3 files changed

+52
-42
lines changed

articles/purview/how-to-data-owner-policies-azure-sql-db.md

Lines changed: 4 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -19,53 +19,17 @@ This how-to guide describes how a data owner can delegate authoring policies in
1919

2020
## Prerequisites
2121
[!INCLUDE [Access policies generic pre-requisites](./includes/access-policies-prerequisites-generic.md)]
22-
- Create a new Azure SQL DB or use an existing one in one of the currently available regions for this preview feature. You can [follow this guide to create a new Azure SQL DB](/azure/azure-sql/database/single-database-create-quickstart).
23-
24-
**Enforcement of Microsoft Purview policies is available only in the following regions for Azure SQL DB**
25-
- East US2
26-
- West US3
27-
- South Central US
28-
- West Central US
29-
- Canada Central
30-
- Brazil South
31-
- North Europe
32-
- West Europe
33-
- France Central
34-
- UK South
35-
- Central India
36-
- Australia East
37-
38-
## Configuration
39-
[!INCLUDE [Access policies generic configuration](./includes/access-policies-configuration-generic.md)]
40-
41-
### Azure SQL Database configuration
42-
Each Azure SQL Database server needs a Managed Identity assigned to it. You can do this from Azure Portal by navigating to the Azure SQL Server that hosts the Azure SQL DB, navigating to Identity on the side menu, checking status to *On* and then saving. See screenshot:
43-
![Screenshot shows how to assign system managed identity to Azure SQL Server.](./media/how-to-data-owner-policies-sql//assign-identity-azure-sql-db.png)
44-
45-
46-
You will also need to enable external policy based authorization on the server. You can do this in Power Shell
47-
48-
```powershell
49-
Connect-AzAccount
22+
[!INCLUDE [Access policies Azure SQL DB pre-requisites](./includes/access-policies-prerequisites-azure-sql-db.md)]
5023

51-
$context = Get-AzSubscription -SubscriptionId xxxx-xxxx-xxxx-xxxx
52-
Set-AzContext $context
53-
54-
$server = Get-AzSqlServer -ResourceGroupName "RESOURCEGROUPNAME" -ServerName "SERVERNAME"
55-
56-
#Initiate the call to the REST API to set externalPolicyBasedAuthorization to true
57-
Invoke-AzRestMethod -Method PUT -Path "$($server.ResourceId)/externalPolicyBasedAuthorizations/MicrosoftPurview?api-version=2021-11-01-preview" -Payload '{"properties":{"externalPolicyBasedAuthorization":true}}'
58-
59-
#Verify that the propery has been set
60-
Invoke-AzRestMethod -Method GET -Path "$($server.ResourceId)/externalPolicyBasedAuthorizations/MicrosoftPurview?api-version=2021-11-01-preview"
61-
```
24+
## Microsoft Purview Configuration
25+
[!INCLUDE [Access policies generic configuration](./includes/access-policies-configuration-generic.md)]
6226

6327
### Register the data sources in Microsoft Purview
6428
The Azure SQL DB resources need to be registered first with Microsoft Purview to later define access policies. You can follow these guides:
6529

6630
[Register and scan Azure SQL DB](./register-scan-azure-sql-database.md)
6731

68-
After you've registered your resources, you'll need to enable *Data Use Management*. Data Use Management can affect the security of your data, as it delegates to certain Microsoft Purview roles to manage access to the data sources. Secure practices related to Data Use Management are described in this guide:
32+
After you've registered your resources, you'll need to enable Data Use Management. Data Use Management can affect the security of your data, as it delegates to certain Microsoft Purview roles to manage access to the data sources. **Go through the secure practices related to Data Use Management in this guide**:
6933

7034
[How to enable Data Use Management](./how-to-enable-data-use-management.md)
7135

articles/purview/how-to-data-owner-policy-authoring-generic.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,8 @@ Access policies allow a data owner to delegate in Microsoft Purview access manag
2626

2727
Before authoring data policies in the Microsoft Purview governance portal, you'll need to configure the data sources so that they can enforce those policies.
2828

29-
1. Follow any policy-specific prerequisites for your source. Check the [Microsoft Purview supported data sources table](azure-purview-connector-overview.md) and select the link in the **Access Policy** column for sources where access policies are available. Follow any steps listed in the Access policy or Prerequisites sections.
30-
1. Register the data source in Microsoft Purview. Follow the **Prerequisites** and **Register** sections of the [source pages](azure-purview-connector-overview.md) for your resources.
29+
1. Follow any policy-specific prerequisites for your source. Check the [Microsoft Purview supported data sources table](microsoft-purview-connector-overview.md) and select the link in the **Access Policy** column for sources where access policies are available. Follow any steps listed in the Access policy or Prerequisites sections.
30+
1. Register the data source in Microsoft Purview. Follow the **Prerequisites** and **Register** sections of the [source pages](microsoft-purview-connector-overview.md) for your resources.
3131
1. [Enable the Data Use Management toggle on the data source](how-to-enable-data-use-management.md#enable-data-use-management). Additional permissions for this step are described in the linked document.
3232

3333
## Create a new policy
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
author: inward-eye
3+
ms.author: vlrodrig
4+
ms.service: purview
5+
ms.subservice: purview-data-policies
6+
ms.topic: include
7+
ms.date: 08/11/2022
8+
ms.custom:
9+
---
10+
11+
- Create a new Azure SQL DB or use an existing one in one of the currently available regions for this preview feature. You can [follow this guide to create a new Azure SQL DB](/azure/azure-sql/database/single-database-create-quickstart).
12+
13+
**Enforcement of Microsoft Purview policies is available only in the following regions for Azure SQL DB**
14+
- East US2
15+
- West US3
16+
- South Central US
17+
- West Central US
18+
- Canada Central
19+
- Brazil South
20+
- North Europe
21+
- West Europe
22+
- France Central
23+
- UK South
24+
- Central India
25+
- Australia East
26+
27+
### Azure SQL Database configuration
28+
Each Azure SQL Database server needs a Managed Identity assigned to it. In Azure portal navigate to the Azure SQL Server that hosts the Azure SQL DB and then navigate to Identity on the side menu. Under System assigned managed identity check status to *On* and save. See screenshot:
29+
![Screenshot shows how to assign system managed identity to Azure SQL Server.](../media/how-to-data-owner-policies-sql/assign-identity-azure-sql-db.png)
30+
31+
You'll also need to enable external policy based authorization on the server. You can do this in PowerShell:
32+
33+
```powershell
34+
Connect-AzAccount
35+
36+
$context = Get-AzSubscription -SubscriptionId xxxx-xxxx-xxxx-xxxx
37+
Set-AzContext $context
38+
39+
$server = Get-AzSqlServer -ResourceGroupName "RESOURCEGROUPNAME" -ServerName "SERVERNAME"
40+
41+
#Initiate the call to the REST API to set externalPolicyBasedAuthorization to true
42+
Invoke-AzRestMethod -Method PUT -Path "$($server.ResourceId)/externalPolicyBasedAuthorizations/MicrosoftPurview?api-version=2021-11-01-preview" -Payload '{"properties":{"externalPolicyBasedAuthorization":true}}'
43+
44+
#Verify that the propery has been set
45+
Invoke-AzRestMethod -Method GET -Path "$($server.ResourceId)/externalPolicyBasedAuthorizations/MicrosoftPurview?api-version=2021-11-01-preview"
46+
```

0 commit comments

Comments
 (0)