Skip to content

Commit ea8f141

Browse files
sravanisalururwestMSFT
authored andcommitted
Update auditing-managed-identity.md
updates about synapse
1 parent 3f4a1aa commit ea8f141

File tree

1 file changed

+22
-11
lines changed

1 file changed

+22
-11
lines changed

azure-sql/database/auditing-managed-identity.md

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Auditing using managed identity
3-
description: How to use managed identity with storage accounts for Auditing
3+
description: How to use managed identity with storage accounts for auditing
44
author: sravanisaluru
55
ms.author: srsaluru
66
ms.reviewer: randolphwest
@@ -28,11 +28,14 @@ By default, the identity used is the primary user identity assigned to the serve
2828

2929
Select the retention period by opening the **Advanced properties**. Then select **Save**. Logs older than the retention period are deleted.
3030

31+
> [!NOTE]
32+
> To set up managed identity-based auditing on Azure Synapse Analytics, see the [Configure system-assigned managed identity for Azure Synapse Analytics auditing](#configure-system-assigned-managed-identity-for-azure-synapse-analytics-auditing) section later in this article.
33+
3134
## User-assigned managed identity
3235

3336
UMI gives users flexibility to create and maintain their own UMI for a given tenant. UMI can be used as server identities for Azure SQL. UMI is managed by the user, compared to a system-assigned managed identity, which identity is uniquely defined per server, and assigned by the system.
3437

35-
For more information about UMI, see [Managed identities in Azure AD for Azure SQL](authentication-azure-ad-user-assigned-managed-identity.md)
38+
For more information about UMI, see [Managed identities in Azure AD for Azure SQL](authentication-azure-ad-user-assigned-managed-identity.md).
3639

3740
## Configure user-assigned managed identity for Azure SQL Database auditing
3841

@@ -101,27 +104,35 @@ For more information, see [Server Auditing Settings - Create Or Update](/rest/ap
101104

102105
---
103106

104-
## Configure user-assigned managed identity for Azure Synapse Analytics auditing
107+
## Configure system-assigned managed identity for Azure Synapse Analytics auditing
105108

106-
You can't use UMI based authentication to a storage account. Only SMI can be used on Azure Synapse.
109+
You can't use UMI based authentication to a storage account for auditing. Only system-assigned managed identity (SMI) can be used for Azure Synapse Analytics. For SMI authentication to work, the managed identity must have the **Storage Blob Data Contributor** role assigned to it, in the storage account's **Access Control** settings. This role is automatically added if Azure portal is used to configure auditing.
107110

108-
In the Azure portal for an Azure Synapse workspace, there is no option to explicitly choose SAS key or managed identity-based authentication, as is the case for Azure SQL Database.
111+
In the Azure portal for Azure Synapse Analytics, there is no option to explicitly choose SAS key or SMI authentication, as is the case for Azure SQL Database.
109112

110-
- If the storage account is behind a VNet or firewall, auditing is automatically configured using managed identity-based authentication.
113+
- If the storage account is behind a VNet or firewall, auditing is automatically configured using SMI authentication.
111114

112115
- If the storage account isn't behind a VNet or firewall, then auditing is automatically configured using SAS key based authentication.
113116

114-
To force the use of managed identity-based authentication, regardless of whether the storage account is behind a firewall, use the REST API or PowerShell, as follows:
117+
To force the use of SMI authentication, regardless of whether the storage account is behind a VNet or firewall, use REST API or PowerShell, as follows:
118+
119+
- If using the REST API, omit the `StorageAccountAccessKey` field explicitly in the request body.
120+
121+
For more information, reference:
122+
123+
- [Server Blob Auditing Policies - Create Or Update - REST API (Azure SQL Database)](/rest/api/sql/2022-08-01-preview/server-blob-auditing-policies/create-or-update?tabs=HTTP)
124+
- [Database Blob Auditing Policies - Create Or Update - REST API (Azure SQL Database](/rest/api/sql/2021-02-01-preview/database-blob-auditing-policies/create-or-update?tabs=HTTP)
115125

116-
- If using the REST API, reference [Database Blob Auditing Policies - Create Or Update - REST API (Azure SQL Database](/rest/api/sql/2021-02-01-preview/database-blob-auditing-policies/create-or-update?tabs=HTTP), or [Server Blob Auditing Policies - Create Or Update - REST API (Azure SQL Database)](/rest/api/sql/2022-08-01-preview/server-blob-auditing-policies/create-or-update?tabs=HTTP). You must omit the `StorageAccountAccessKey` field explicitly in the request body.
126+
- If using PowerShell, pass the `UseIdentity` parameter as `true`.
117127

118-
- If using PowerShell APIs, reference [Set-AzSqlServerAudit (Az.Sql)](/powershell/module/az.sql/set-azsqlserveraudit) or [Set-AzSqlDatabaseAudit (Az.Sql)](/powershell/module/az.sql/set-azsqldatabaseaudit), and pass the `UseIdentity` parameter as `true`.
128+
For more information, reference:
119129

120-
For managed identity-based authentication to work, the managed identity must have the **Storage Blob Data Contributor** role assigned to it, in the storage account's **Access Control Settings**. This role is automatically added if Azure portal is used to configure auditing.
130+
- [Set-AzSqlServerAudit (Az.Sql)](/powershell/module/az.sql/set-azsqlserveraudit)
131+
- [Set-AzSqlDatabaseAudit (Az.Sql)](/powershell/module/az.sql/set-azsqldatabaseaudit)
121132

122133
## Next steps
123134

124135
- [Auditing overview](auditing-overview.md)
125136
- Data Exposed episode: [What's New in Azure SQL Auditing](/Shows/Data-Exposed/Whats-New-in-Azure-SQL-Auditing)
126137
- [Auditing for SQL Managed Instance](../managed-instance/auditing-configure.md)
127-
- [Auditing for SQL Server](/sql/relational-databases/security/auditing/sql-server-audit-database-engine)
138+
- [Auditing for SQL Server](/sql/relational-databases/security/auditing/sql-server-audit-database-engine)

0 commit comments

Comments
 (0)