PowerShell 和 Azure CLI:使用 Azure Key Vault 中的客戶自控金鑰來啟用透明資料加密

僅適用於: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 和金鑰。
  • 金鑰必須具有下列屬性才能用於 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 保護裝置

註

針對受控 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 保護器,請檢查以下條件:

    • 金鑰不應該有有效期限。
    • 金鑰必須已啟用取得、封裝金鑰和解封金鑰作業。