僅適用於:Azure Synapse Analytics 專用 SQL 集區 (原為 SQL DW)
Tip
Microsoft Fabric Data Warehouse 是一個企業規模的關聯式倉庫,建立在資料湖基礎上,具備未來準備架構、內建 AI 及新功能。 如果你是資料倉儲新手,建議先從Fabric Data Warehouse開始。 現有的 專用 SQL 工作負載可升級至 Fabric,以取得資料科學、即時分析與報告等多項新功能。
本文將逐步說明如何在 Azure Synapse Analytics 上使用 Azure Key Vault 的金鑰進行透明資料加密(TDE)。 若要深入了解 Azure Key Vault 整合的 TDE—使用自帶金鑰 (BYOK) 的支援,請參閱 Azure Key Vault 中客戶管理金鑰的 TDE。
註
本文介紹獨立專用 SQL 池(前稱 SQL DW)。
- 對於 Azure Synapse Analytics 專用的 SQL 池(前稱 SQL DW),請在伺服器層設定 TDE 保護器。 所有與該伺服器相關的加密資料庫都會繼承 TDE 保護器。
- 在 Synapse 工作區中,使用客戶管理的金鑰在工作區層級設定,將專用 SQL 池和無伺服器 SQL 池的資料加密。 如需 Synapse 工作區內專用 SQL 集區透明資料加密的詳細資訊,請參閱 Azure Synapse Analytics 加密。
PowerShell 的先決條件
- 您必須具有 Azure 訂用帳戶,並且是該訂用帳戶的系統管理員。
- [建議執行的選擇性作業] 備妥硬體安全性模組 (HSM) 或本機金鑰存放區,用來建立 TDE 保護裝置金鑰內容的本機複本。
- 您必須安裝並執行 Azure PowerShell。
- 建立要用於 TDE 的 Azure Key Vault 和金鑰。
-
使用硬體安全性模組 (HSM) 和 Azure Key Vault 的指示
- 金鑰保存庫必須具有下列屬性才能用於 TDE:
- 虛刪除和清除保護
-
使用硬體安全性模組 (HSM) 和 Azure Key Vault 的指示
- 金鑰必須具有下列屬性才能用於 TDE:
- 啟用日期 (若已設定) 必須是過去的日期和時間
- 期間屆滿日 (若已設定) 必須是未來的日期和時間
- 金鑰必須處於「已啟用」狀態
- 能夠執行取得、封裝金鑰、解封裝金鑰作業
- 要使用 Azure Key Vault 受管 HSM 金鑰,請依照指示使用 Azure CLI 建立並啟用受管型 HSM
如需 Az PowerShell 模組安裝指示,請參閱安裝 Azure PowerShell。
如需 Azure Key Vault 的詳細資訊,請參閱 Azure Key Vault 的 PowerShell 指示 和 如何使用 PowerShell 操作 Azure Key Vault 的軟刪除。
將 Microsoft Entra 身分識別指派給您的伺服器
如果你已有伺服器,請依照以下步驟為你的伺服器新增 Microsoft Entra 身份:
$server = Set-AzSqlServer -ResourceGroupName <SQLDatabaseResourceGroupName> -ServerName <LogicalServerName> -AssignIdentity
如果你正在建立伺服器,請使用 New-AzSqlServer Cmdlet 搭配 -Identity 標記,在建立伺服器時新增 Microsoft Entra 身分識別:
$server = New-AzSqlServer -ResourceGroupName <SQLDatabaseResourceGroupName> -Location <RegionName> `
-ServerName <LogicalServerName> -ServerVersion "12.0" -SqlAdministratorCredentials <PSCredential> -AssignIdentity
將 Azure Key Vault 許可權授與伺服器
請先使用 Set-AzKeyVaultAccessPolicy Cmdlet 將金鑰保存庫的存取權授與您的伺服器,再使用金鑰保存庫中的金鑰進行 TDE。
Set-AzKeyVaultAccessPolicy -VaultName <KeyVaultName> `
-ObjectId $server.Identity.PrincipalId -PermissionsToKeys get, wrapKey, unwrapKey
若要在受控 HSM 上為您的伺服器新增權限,請將 Managed HSM Crypto Service Encryption User 本機 RBAC 角色指派給伺服器。 此角色使伺服器能對受管理 HSM 中的金鑰執行 get、 wrap key及 unwrap key 操作。 欲了解更多資訊,請參閱 受管理型 HSM 角色管理。
將 Azure Key Vault 金鑰新增至伺服器並設定 TDE 保護裝置
- 使用 Get-AzKeyVaultKey Cmdlet 從密鑰保存庫擷取密鑰標識碼。
- 使用 Add-AzSqlServerKeyVaultKey Cmdlet,將密鑰從 Azure Key Vault 新增至伺服器。
- 使用 Set-AzSqlServerTransparentDataEncryptionProtector Cmdlet,將金鑰設定為所有伺服器資源的 TDE 保護裝置。
- 使用 Get-AzSqlServerTransparentDataEncryptionProtector Cmdlet,確認已依預期設定 TDE 保護裝置。
註
針對受控 HSM 金鑰,請使用 Az.Sql 2.11.1 版的 PowerShell 或更高版本。
註
金鑰庫名稱與金鑰名稱的總長度不得超過 94 個字元。
Tip
使用已版本化的 Azure Key Vault 金鑰進行 TDE
設定 TDE 保護裝置時,請使用特定的金鑰版本來參考 Azure Key Vault 金鑰。
Example:
包含特定版本的金鑰識別碼
https://<key-vault-name>.vault.azure.net/keys/<key-name>/<key-version>
# add the key from Azure Key Vault to the server
Add-AzSqlServerKeyVaultKey -ResourceGroupName <SQLDatabaseResourceGroupName> -ServerName <LogicalServerName> -KeyId <KeyVaultKeyId>
# set the key as the TDE protector for all resources under the server
Set-AzSqlServerTransparentDataEncryptionProtector -ResourceGroupName <SQLDatabaseResourceGroupName> -ServerName <LogicalServerName> `
-Type AzureKeyVault -KeyId <KeyVaultKeyId>
# confirm the TDE protector was configured as intended
Get-AzSqlServerTransparentDataEncryptionProtector -ResourceGroupName <SQLDatabaseResourceGroupName> -ServerName <LogicalServerName>
開啟 TDE
使用 Set-AzSqlDatabaseTransparentDataEncryption Cmdlet 以開啟 TDE。
Set-AzSqlDatabaseTransparentDataEncryption -ResourceGroupName <SQLDatabaseResourceGroupName> `
-ServerName <LogicalServerName> -DatabaseName <DatabaseName> -State "Enabled"
現在,資料庫或數據倉儲已在 Azure Key Vault 中使用加密密鑰來啟用 TDE。
檢查加密狀態和加密活動
使用 Get-AzSqlDatabaseTransparentDataEncryption,取得資料庫或資料倉儲的加密狀態。
# get the encryption state of the database
Get-AzSqlDatabaseTransparentDataEncryption -ResourceGroupName <SQLDatabaseResourceGroupName> `
-ServerName <LogicalServerName> -DatabaseName <DatabaseName> `
有用的 PowerShell Cmdlet
使用 Set-AzSqlDatabaseTransparentDataEncryption Cmdlet 以關閉 TDE。
Set-AzSqlDatabaseTransparentDataEncryption -ServerName <LogicalServerName> -ResourceGroupName <SQLDatabaseResourceGroupName> ` -DatabaseName <DatabaseName> -State "Disabled"使用 Get-AzSqlServerKeyVaultKey Cmdlet 傳回新增至伺服器的 Azure Key Vault 密鑰清單。
# KeyId is an optional parameter, to return a specific key version Get-AzSqlServerKeyVaultKey -ServerName <LogicalServerName> -ResourceGroupName <SQLDatabaseResourceGroupName>使用 Remove-AzSqlServerKeyVaultKey 從伺服器移除 Azure Key Vault 密鑰。
# the key set as the TDE Protector cannot be removed Remove-AzSqlServerKeyVaultKey -KeyId <KeyVaultKeyId> -ServerName <LogicalServerName> -ResourceGroupName <SQLDatabaseResourceGroupName>
Troubleshooting
如果找不到金鑰庫,請確保你使用的是正確的訂閱。
Get-AzSubscription -SubscriptionId <SubscriptionId>
如果你無法將新金鑰加入伺服器,或無法將新金鑰更新為 TDE 保護器,請檢查以下條件:
- 金鑰不應該有有效期限。
- 金鑰必須已啟用取得、封裝金鑰和解封金鑰作業。
相關內容
- 欲了解如何輪替伺服器的 TDE 保護器以符合安全要求,請參閱「使用 PowerShell 輪替 透明資料加密 保護器」。
- 如要了解如何移除可能遭洩漏的 TDE 保護裝置,請參閱移除可能遭洩漏的金鑰。