✔️ 適用於: 使用 Microsoft.Storage 資源提供者建立的經典 SMB 和 NFS 檔案共享。
✖️ 不適用於:使用 Microsoft.FileShares 資源提供者建立的檔案共用
Azure 透過 AES-256 加密,加密儲存體帳戶中所有靜態資料,包括 Azure 檔案儲存體 資料。 預設情況下,Microsoft 會管理儲存帳號的加密金鑰。 為了更好地控制加密金鑰,建議使用客戶管理金鑰(CMK),而非 Microsoft 管理金鑰,以保護並控制對用來加密您資料的加密金鑰的存取。 本文說明如何為 Azure 檔案儲存體 工作負載配置客戶管理的金鑰。 如需待用資料加密與金鑰選項的概覽,請參閱 Azure 檔案儲存體的待用資料加密。
當你為儲存帳號設定客戶管理金鑰時,該儲存帳號中的 Azure 檔案儲存體 資料會自動使用客戶金鑰加密。 不需要針對每個共用個別選擇加入。
要在與儲存帳號相同的 Microsoft Entra 租戶中使用 Azure Key Vault 中的金鑰,請依序完成以下部分:
-
建立或設定金鑰保存庫
-
建立或匯入加密金鑰
-
建立受控身分識別並指派權限
-
在儲存帳戶上設定客戶管理的金鑰
-
確認設定
其他重要地點請參見以下章節:
要啟用客戶管理的金鑰,你需要一個 Azure 儲存帳號,以及啟用清除保護的 Azure Key Vault。 您可以使用現有的金鑰保存庫,或建立新的金鑰保存庫。 儲存帳號和金鑰庫可以位於同一 Microsoft Entra 租戶內的不同區域或訂閱中。 關於跨租戶情境,請參見 「關於跨租戶客戶管理金鑰」。
要透過 Azure 入口建立新的金鑰保險庫,請遵循以下步驟:
- 在Azure入口網站中,搜尋 Key vaults,並選擇 Create。
- 填寫所需欄位(訂閱、資源群組、名稱、地區)。
- 在 復原選項中,選擇 啟用清除保護。
- 選取 審核 + 建立,然後選取 建立。
如果你想使用現有的金鑰保險庫,請依照以下步驟操作:
- 前往 Azure 入口網站中的你的金鑰庫。
- 在服務選單中,在 設定中選擇 屬性。
- 在 清除保護 區塊中,選擇 啟用清除保護,然後選擇 儲存。
- 確保你的金鑰保險庫啟用軟刪除功能。 新金鑰保存庫預設會啟用此功能。
要建立一個啟用清除保護的新金鑰保險庫,請執行以下 cmdlet。 將 <key-vault-name>、<resource-group> 和 <region> 取代為您自己的值。
$vaultParams = @{
Name = "<key-vault-name>"
ResourceGroupName = "<resource-group>"
Location = "<region>"
EnablePurgeProtection = $true
}
New-AzKeyVault @vaultParams
要啟用已有的金鑰保存庫的清除保護,請執行下列 cmdlet。 將<key-vault-name> 和 <resource-group> 取代為您自己的值。
$vaultParams = @{
VaultName = "<key-vault-name>"
ResourceGroupName = "<resource-group>"
EnablePurgeProtection = $true
}
Update-AzKeyVault @vaultParams
要建立啟用清除保護的新金鑰保險庫,請執行以下指令。 將 <key-vault-name>、<resource-group> 和 <region> 取代為您自己的值。
az keyvault create \
--name <key-vault-name> \
--resource-group <resource-group> \
--location <region> \
--enable-purge-protection true
要啟用現有金鑰保險庫的清除保護,請執行以下指令。 將<key-vault-name> 和 <resource-group> 取代為您自己的值。
az keyvault update \
--name <key-vault-name> \
--resource-group <resource-group> \
--enable-purge-protection true
指派 金鑰保存庫 加密官角色
要在key vault中建立和管理金鑰,你需要在key vault上擔任金鑰保存庫 Crypto Officer 角色。 你可以用 Azure 入口網站、PowerShell 或 Azure CLI 來指定這個角色給自己。 如果您在金鑰保存庫上已有此角色,請略過本節,並前往建立或匯入加密金鑰。
你需要在 金鑰保存庫 範圍內擁有Owner或User Access Administrator 的 RBAC 角色,才能指派金鑰保存庫 Crypto Officer 角色。 如有需要,請聯絡你的行政人員。
若要透過Azure入口網站自行指派金鑰保存庫加密官員職務,請依照以下步驟操作:
- 移至您的金鑰保存庫。
- 從服務選單中,選擇存取控制(IAM)。
- 在授與此資源的存取權下方,選取新增角色指派。
- 搜尋並選擇 金鑰保存庫 Crypto Officer,然後選擇 Next。
- 在 [指派存取權] 底下,選取 [使用者、群組或服務主體]。
- 在 「會員」中,選擇 +選擇成員。
- 搜尋並選擇你自己的帳號,然後選擇 「選擇」。
- 選擇 Review + assign,然後再選擇 Review + assign。
要用 Azure PowerShell 來指派 金鑰保存庫 Crypto Officer 角色,請執行以下 cmdlet。 以您自己的值取代 <key-vault-name>。
$keyVault = Get-AzKeyVault -VaultName "<key-vault-name>"
$currentUser = (Get-AzADUser -SignedIn).Id
$roleParams = @{
ObjectId = $currentUser
RoleDefinitionName = "Key Vault Crypto Officer"
Scope = $keyVault.ResourceId
}
New-AzRoleAssignment @roleParams
要用 Azure CLI 來指派 金鑰保存庫 Crypto Officer 角色,請執行以下指令。 以您自己的值取代 <key-vault-name>。
KV_RESOURCE_ID=$(az keyvault show --name <key-vault-name> --query id -o tsv)
CURRENT_USER=$(az ad signed-in-user show --query id -o tsv)
az role assignment create \
--assignee-object-id $CURRENT_USER \
--assignee-principal-type User \
--role "Key Vault Crypto Officer" \
--scope $KV_RESOURCE_ID
建立或匯入加密金鑰
你需要一把 RSA 或 RSA-HSM 的 2048、3072 或 4096 的鑰匙。 在你的金鑰庫中產生或匯入 RSA 金鑰。 在產生金鑰之前,請確保你在金鑰保存庫上具有金鑰保存庫 Crypto Officer 角色。
要透過 Azure 入口網站產生新的 RSA 加密金鑰,請遵循以下步驟:
- 前往 Azure 入口網站中的你的金鑰庫。
- 在服務選單中,選擇物件後,再選擇金鑰。
- 選取 產生/匯入。 在 選項中,選擇 產生。
- 輸入鑰匙名稱。 鍵名只能包含英文字母、數字和破折號。
- 將 金鑰類型 設為 RSA,並將 RSA 金鑰大小 設為 2048、3072 或 4096。
- 選取 建立。
要透過 Azure 入口網站匯入現有的 RSA 加密金鑰,請遵循以下步驟:
- 前往 Azure 入口網站中的你的金鑰庫。
- 在服務選單中,選擇物件後,再選擇金鑰。
- 選取 產生/匯入。 在 選項中,選擇 匯入。
- 選擇你的金鑰上傳。
- 輸入鑰匙名稱。 鍵名只能包含英文字母、數字和破折號。
- 將 [金鑰類型] 設定為 [RSA]。
- 選取 建立。
要使用 Azure PowerShell 建立 RSA 金鑰,請執行以下 cmdlet。 將<key-vault-name> 和 <key-name> 取代為您自己的值。 對於 Size,請指定 2048、3072 或 4096。
$keyParams = @{
VaultName = "<key-vault-name>"
Name = "<key-name>"
Destination = "Software"
KeyType = "RSA"
Size = 2048
}
Add-AzKeyVaultKey @keyParams
要使用 Azure PowerShell 匯入現有的 RSA 加密金鑰,請執行以下 cmdlet。 將 <key-vault-name>、<key-name> 和 <key-path> 取代為您自己的值。 第一行會提示輸入金鑰檔案的密碼。 如果金鑰檔沒有密碼,就省略 Read-Host 這一行和 KeyFilePassword。
$password = Read-Host -Prompt "Key file password" -AsSecureString
$keyParams = @{
VaultName = "<key-vault-name>"
Name = "<key-name>"
KeyFilePath = "<key-path>"
KeyFilePassword = $password
}
Add-AzKeyVaultKey @keyParams
要使用 Azure CLI 建立 RSA 金鑰,請執行以下指令。 將<key-vault-name> 和 <key-name> 取代為您自己的值。 對於 --size,請指定 2048、3072 或 4096。
az keyvault key create \
--vault-name <key-vault-name> \
--name <key-name> \
--kty RSA \
--size 2048
要使用 Azure CLI 匯入現有的 RSA 加密金鑰,請執行以下指令。 將<key-vault-name>、<key-name>、<key-path>和<key-password>替換為您自己的值。 如果金鑰檔沒有密碼,就省略該 --pem-password 參數。
az keyvault key import \
--vault-name <key-vault-name> \
--name <key-name> \
--pem-file <key-path> \
--pem-password <key-password>
建立一個管理身份並分配權限
儲存帳號需要一個 受管理身份 來驗證到金鑰保險庫。 透過使用管理身份,儲存帳號可以安全地存取你金鑰庫中的加密金鑰,而不必儲存憑證。
建立一個由使用者指派的管理身份,並在金鑰保存庫上將該身份授予金鑰保存庫 加密服務用戶角色。
建立使用者指派的管理型身分識別
使用Azure portal、Azure PowerShell或Azure CLI建立用戶指定管理身份。
要透過 Azure 入口網站建立使用者指派受控識別,請依照以下步驟操作:
- 搜尋 「受管理身份 」並選擇 「建立」。
- 選擇訂閱、資源群組、地區名稱。
- 選取 審核 + 建立,然後選取 建立。
要使用 Azure PowerShell 建立使用者指派的管理身份,請執行以下 cmdlet。 將 <resource-group>、<identity-name> 和 <region> 取代為您自己的值。
$identityParams = @{
ResourceGroupName = "<resource-group>"
Name = "<identity-name>"
Location = "<region>"
}
New-AzUserAssignedIdentity @identityParams
要使用 Azure CLI 建立使用者指派的管理身份,請執行以下指令。 將 <resource-group>、<identity-name> 和 <region> 取代為您自己的值。
az identity create \
--name <identity-name> \
--resource-group <resource-group> \
--location <region>
將 金鑰保存庫 Crypto Service Encryption User 角色指派給受控識別
將 金鑰保存庫 加密服務加密用戶 角色分配給你使用 Azure 入口網站、PowerShell 或 Azure CLI 建立的管理身份。
要透過Azure入口網站將金鑰保存庫加密服務加密用戶角色指派給受管理身份,請遵循以下步驟:
- 前往 Azure 入口網站中的你的金鑰庫。
- 從服務選單中,選擇存取控制(IAM)。
- 在授與此資源的存取權下方,選取新增角色指派。
- 搜尋並選擇 金鑰保存庫 Crypto Service Encryption User,然後選擇 Next。
- 在 [存取權指派對象] 下,選取 [受控識別]。
- 在 「會員」中,選擇 +選擇成員。
-
選取受管理的身分 視窗隨即開啟。 在 [受控識別] 下,選取 [使用者指派的受控識別]。
- 選擇你建立的管理身份,然後選擇 「選擇」。
- 選擇 Review + assign,然後再選擇 Review + assign。
要使用 Azure PowerShell 將 金鑰保存庫 加密服務加密使用者 角色指派給使用者指派的管理身份,請執行以下 cmdlet。 將 <resource-group>、<identity-name> 和 <key-vault-name> 取代為您自己的值。
$identityParams = @{
ResourceGroupName = "<resource-group>"
Name = "<identity-name>"
}
$identity = Get-AzUserAssignedIdentity @identityParams
$keyVault = Get-AzKeyVault -VaultName "<key-vault-name>"
$roleParams = @{
ObjectId = $identity.PrincipalId
RoleDefinitionName = "Key Vault Crypto Service Encryption User"
Scope = $keyVault.ResourceId
}
New-AzRoleAssignment @roleParams
要使用 Azure CLI 將 金鑰保存庫 加密服務加密用戶 角色指派給使用者指派的管理身份,請執行以下指令。 將 <resource-group>、<identity-name> 和 <key-vault-name> 取代為您自己的值。
# Get the principal ID of the user-assigned managed identity
IDENTITY_PRINCIPAL_ID=$(az identity show \
--name <identity-name> \
--resource-group <resource-group> \
--query principalId -o tsv)
# Get the key vault resource ID
KV_RESOURCE_ID=$(az keyvault show \
--name <key-vault-name> \
--query id -o tsv)
# Assign the Key Vault Crypto Service Encryption User role to the user-assigned managed identity
az role assignment create \
--assignee-object-id $IDENTITY_PRINCIPAL_ID \
--assignee-principal-type ServicePrincipal \
--role "Key Vault Crypto Service Encryption User" \
--scope $KV_RESOURCE_ID
有了金鑰庫、金鑰和受管理身份後,你可以在儲存帳號啟用客戶管理的金鑰。
如果你沒有指定金鑰版本,儲存帳號會使用自動金鑰版本更新(建議)。 若要使用手動金鑰版本更新,請指定一個金鑰版本。
Important
對於與 網路安全邊界相關的儲存帳戶,金鑰庫理想上應該位於相同的網路安全邊界內。 如果不是,那你必須設定金鑰保險庫的網路安全邊界設定檔,讓儲存帳號能與它通訊。
你可以透過 Azure 入口網站、Azure PowerShell 或 Azure CLI 在現有儲存帳號上設定客戶管理的金鑰。
要透過 Azure 入口網站在現有儲存帳號上設定客戶管理的金鑰,請遵循以下步驟。 這些步驟會使用自動金鑰版本更新。 若要使用手動金鑰版本更新,請在步驟 4 選擇 Enter key URI,並輸入包含金鑰版本的金鑰 URI。
- 前往您的儲存帳戶。
- 在服務選單中,在 安全 + 網路中選擇 加密。
- 對於 加密類型,請選擇 客戶管理金鑰。 如果儲存帳號已經設定為 CMK,請選擇 變更鍵。
- 對於 加密金鑰,請選擇 「從金鑰庫中選擇」。
- 選擇 選擇一個金鑰保管庫和金鑰。 對於 金鑰儲存類型,請選擇 金鑰保險庫。 選擇您的金鑰保存庫和金鑰,然後選擇 Select。
- 在 身份類型中,選擇使用者 指派 ,以使用你先前建立的使用者指派管理身份。
- 選取選取身分識別。 搜尋並選擇使用者指派的受控識別,然後選擇 新增。
- 選取 [儲存]。
若要使用 Azure PowerShell 並自動更新金鑰版本(建議)在現有儲存帳戶上設定客戶管理的金鑰,請執行以下 cmdlet。 用你自己的數值替換 <resource-group>、 <identity-name>、 <storage-account-name><key-vault-name><key-name> 、 , 。
以下 cmdlet 使用您先前建立的使用者指派的受管理的身份。 如果你想改用儲存帳號的系統身份,請設 IdentityType 為 SystemAssigned,並移除這些 Get-AzUserAssignedIdentity 行、 UserAssignedIdentityId和 KeyVaultUserAssignedIdentityId。
$resourceGroupName = "<resource-group>"
$keyVaultName = "<key-vault-name>"
$identityParams = @{
ResourceGroupName = $resourceGroupName
Name = "<identity-name>"
}
$identity = Get-AzUserAssignedIdentity @identityParams
$keyVault = Get-AzKeyVault -VaultName $keyVaultName
$key = Get-AzKeyVaultKey -VaultName $keyVaultName -Name "<key-name>"
$accountParams = @{
ResourceGroupName = $resourceGroupName
Name = "<storage-account-name>"
IdentityType = "UserAssigned"
UserAssignedIdentityId = $identity.Id
KeyVaultUri = $keyVault.VaultUri
KeyName = $key.Name
KeyVaultEncryption = $true
KeyVaultUserAssignedIdentityId = $identity.Id
}
Set-AzStorageAccount @accountParams
若要使用手動金鑰版本更新而非自動更新,請在$accountParams中加入KeyVersion = $key.Version。
要使用 Azure CLI 並自動更新金鑰版本(建議)在現有儲存帳號上設定客戶管理的金鑰,請執行以下指令。 用你自己的數值替換 <resource-group>、 <identity-name>、 <storage-account-name><key-vault-name><key-name> 、 , 。
以下指令使用你先前建立的使用者指派管理身份。 如果你想改用儲存帳號的系統身份,請設 --identity-type 為 SystemAssigned 並省略變 IDENTITY_RESOURCE_ID 數 --user-identity-id,且 --key-vault-user-identity-id。
# Using user-assigned managed identity. Omit for system assigned.
IDENTITY_RESOURCE_ID=$(az identity show \
--name <identity-name> \
--resource-group <resource-group> \
--query id -o tsv)
# Get the key vault URI
KEY_VAULT_URI=$(az keyvault show \
--name <key-vault-name> \
--query properties.vaultUri -o tsv)
az storage account update \
--name <storage-account-name> \
--resource-group <resource-group> \
--encryption-key-vault $KEY_VAULT_URI \
--encryption-key-name <key-name> \
--encryption-key-source Microsoft.Keyvault \
--key-vault-user-identity-id $IDENTITY_RESOURCE_ID \
--identity-type UserAssigned \
--user-identity-id $IDENTITY_RESOURCE_ID
若要使用手動鍵版本更新取代自動更新,請在指令--encryption-key-version <key-version>中新增az storage account update內容。
你可以在建立新儲存帳號時,透過 Azure 入口網站、Azure PowerShell 或 Azure CLI 來設定客戶管理的金鑰。
你不能在儲存帳號建立時使用系統指派的身份,因為該身份直到儲存帳號建立後才存在。 你必須使用使用者指派的管理身份。
要透過 Azure 入口網站設定客戶管理的儲存帳戶金鑰,請遵循以下步驟。 這些步驟會使用自動金鑰版本更新。 若要使用手動金鑰版本更新,請在步驟 2 中選取 從 URI 輸入金鑰,並輸入包含金鑰版本的金鑰 URI。
在儲存帳號建立時的 加密 標籤中,選擇「 客戶管理金鑰」(Customer-managed keys,CMK) 作為 加密類型。
對於 加密金鑰,請選擇 「選擇金鑰庫與金鑰」。
在 訂閱中,選擇包含你金鑰保險庫的訂閱。 入口網站可能會預設使用不同的訂閱。
對於 金鑰儲存類型,請選擇 金鑰保險庫。
選取您的金鑰保存庫與金鑰。
在 「使用者指派身份」中,選擇 「選擇一個身份」。 「選擇使用者指派受控識別」視窗會打開。
搜尋並選擇你所建立的使用者指派的受控識別。 新的儲存帳號無法使用系統指派的管理身份。
選取 ,然後新增。
完成剩餘的分頁,選擇 檢閱並建立,然後選擇 建立。
要使用 Azure PowerShell 建立一個由客戶管理的金鑰的新儲存帳號,請執行以下 cmdlet。 用你自己的價值觀取代 <resource-group>、 <identity-name>、 <storage-account-name><key-vault-name><key-name><region> 、 , 你可以為 SkuName 和 Kind 設定不同的值。
$resourceGroupName = "<resource-group>"
$keyVaultName = "<key-vault-name>"
$identityParams = @{
ResourceGroupName = $resourceGroupName
Name = "<identity-name>"
}
$identity = Get-AzUserAssignedIdentity @identityParams
$keyVault = Get-AzKeyVault -VaultName $keyVaultName
$key = Get-AzKeyVaultKey -VaultName $keyVaultName -Name "<key-name>"
$accountParams = @{
ResourceGroupName = $resourceGroupName
Name = "<storage-account-name>"
Location = "<region>"
SkuName = "Standard_LRS"
Kind = "StorageV2"
IdentityType = "UserAssigned"
UserAssignedIdentityId = $identity.Id
KeyVaultUri = $keyVault.VaultUri
KeyName = $key.Name
KeyVaultUserAssignedIdentityId = $identity.Id
}
New-AzStorageAccount @accountParams
若要使用手動更新金鑰版本而非自動更新,請在$accountParams中加入KeyVersion = $key.Version。
要使用 Azure CLI 建立一個由客戶管理的金鑰的新儲存帳號,請執行以下指令。 用你自己的價值觀取代 <resource-group>、 <identity-name>、 <storage-account-name><key-vault-name><key-name><region> 、 , 你可以為 --sku 和 --kind 指定不同的值。
IDENTITY_RESOURCE_ID=$(az identity show \
--name <identity-name> \
--resource-group <resource-group> \
--query id -o tsv)
# Get the key vault URI
KEY_VAULT_URI=$(az keyvault show \
--name <key-vault-name> \
--query properties.vaultUri -o tsv)
az storage account create \
--name <storage-account-name> \
--resource-group <resource-group> \
--location <region> \
--sku Standard_LRS \
--kind StorageV2 \
--identity-type UserAssigned \
--user-identity-id $IDENTITY_RESOURCE_ID \
--encryption-key-vault $KEY_VAULT_URI \
--encryption-key-name <key-name> \
--encryption-key-source Microsoft.Keyvault \
--key-vault-user-identity-id $IDENTITY_RESOURCE_ID
若要使用手動鍵版本更新而非自動,請在指令--encryption-key-version <key-version>中新增az storage account create內容。
驗證設定
啟用客戶管理金鑰後,請確認你的儲存帳號加密設定是否正確。 你可以透過使用 Azure 入口網站、Azure PowerShell 或 Azure CLI 來達成此目標。
要透過 Azure 入口驗證儲存帳號設定,請遵循以下步驟:
- 請進入 Azure portal 的 storage 帳號。
- 在服務選單中,在 安全 + 網路中選擇 加密。
- 確認 加密類型 顯示的是 客戶管理的金鑰。
- 請確認 Key 選擇 下的資訊是否正確。
要使用 Azure PowerShell 驗證儲存帳號設定,請執行以下 cmdlet。 將<resource-group> 和 <storage-account-name> 取代為您自己的值。
$accountParams = @{
ResourceGroupName = "<resource-group>"
Name = "<storage-account-name>"
}
$account = Get-AzStorageAccount @accountParams
$account.Encryption.KeySource
$account.Encryption.KeyVaultProperties
確認 KeySource 是 Microsoft.Keyvault,且 KeyVaultProperties 顯示你的金鑰庫 URI 和金鑰名稱。
要使用 Azure CLI 驗證設定,請執行以下指令。 將<resource-group> 和 <storage-account-name> 取代為您自己的值。
az storage account show \
--name <storage-account-name> \
--resource-group <resource-group> \
--query encryption
確認 keySource 是 Microsoft.Keyvault,且 keyVaultProperties 區塊顯示你的金鑰庫 URI 和金鑰名稱。
在 Azure Key Vault Managed HSM 中使用金鑰
你可以將客戶管理的金鑰存放在 Azure Key Vault Managed HSM 中,而非 Azure Key Vault。 步驟與 金鑰保存庫 區段不同於以下幾點:
- 託管 HSM 使用其自身的本地基於角色的存取控制(RBAC)。 您是在受控 HSM 上指派角色,而不是透過金鑰保存庫上的 Azure RBAC 來指派。 將儲存帳號的角色指派範圍限制為該金鑰,使受控識別只能使用該金鑰。
- 管理型 HSM 中的金鑰是 RSA-HSM 金鑰。 使用尺寸為 2048、3072 或 4096 的金鑰。
- 儲存帳號使用受管理 HSM 的 URI 來取代金鑰庫 URI。
在開始之前,請確保你擁有以下物品:
- 一個已配置並啟用的託管 HSM。 關於步驟,請參見快速入門:使用 Azure CLI 配置並啟用受管理的 HSM。
- 在受管理的 HSM 上啟用了清除保護。 如果未啟用清除保護,儲存體帳戶設定就會失敗,並出現錯誤
Keyvault policy recoverable is not set。 你啟用清除保護後就無法關閉它。 已刪除的受管理 HSM 會持續累積費用,直到保留期限結束。 欲了解更多資訊,請參閱 管理型 HSM 軟刪除及清除保護。
- 一個在受管理 HSM 上的本地 RBAC 角色,讓你可以建立金鑰,例如 Managed HSM Crypto User。
- 使用者指派的受管控身份。 關於步驟,請參見 建立使用者指派的管理身份。
在受管理的 HSM 中建立一把金鑰,將 Managed HSM Crypto Service Encryption User 角色指派給受管理身分識別,並設定儲存體帳戶使用該金鑰。 角色分配可能需要幾分鐘才能生效。 如果儲存帳號設定失敗且出現授權錯誤,請等幾分鐘再試一次。
要建立金鑰並指派角色,請使用 PowerShell 或 Azure CLI 的步驟。 接著在 Azure 入口網站設定儲存帳號:
- 前往您的儲存帳戶。
- 在服務選單中,在 安全 + 網路中選擇 加密。
- 對於 加密類型,請選擇 客戶管理金鑰。 如果儲存帳號已經設定為客戶管理的金鑰,請選擇 變更金鑰。
- 對於 加密金鑰,選擇 「從金鑰保存庫中選擇」,然後再選擇 「選擇金鑰保存庫和金鑰」。
- 對於 金鑰儲存類型,請選擇 受管型 HSM。
- 選擇您的受控 HSM 和金鑰,然後選擇 選擇。
- 在 身分類型中,選取 使用者指派,然後選取您的使用者指派受控識別。
- 選取 [儲存]。
執行下列 命令。 用你自己的數值替換 <hsm-name>、 <key-name>、 <resource-group><identity-name><storage-account-name> 、 , 。
$resourceGroupName = "<resource-group>"
$hsmName = "<hsm-name>"
$keyName = "<key-name>"
# Create an RSA-HSM key in the managed HSM
$keyParams = @{
HsmName = $hsmName
Name = $keyName
KeyType = "RSA"
Size = 2048
}
Add-AzKeyVaultKey @keyParams
# Assign the Managed HSM Crypto Service Encryption User role to the managed identity, scoped to the key
$identityParams = @{
ResourceGroupName = $resourceGroupName
Name = "<identity-name>"
}
$identity = Get-AzUserAssignedIdentity @identityParams
$roleParams = @{
HsmName = $hsmName
RoleDefinitionName = "Managed HSM Crypto Service Encryption User"
ObjectId = $identity.PrincipalId
Scope = "/keys/$keyName"
}
New-AzKeyVaultRoleAssignment @roleParams
# Configure customer-managed keys on the storage account
$hsm = Get-AzKeyVaultManagedHsm -Name $hsmName
$accountParams = @{
ResourceGroupName = $resourceGroupName
Name = "<storage-account-name>"
IdentityType = "UserAssigned"
UserAssignedIdentityId = $identity.Id
KeyVaultUri = $hsm.HsmUri
KeyName = $keyName
KeyVaultEncryption = $true
KeyVaultUserAssignedIdentityId = $identity.Id
}
Set-AzStorageAccount @accountParams
在受管理的 HSM 中,Add-AzKeyVaultKey 的金鑰類型為 RSA 時,會建立 RSA-HSM 金鑰。
執行下列 命令。 用你自己的數值替換 <hsm-name>、 <key-name>、 <identity-name><resource-group><storage-account-name> 、 , 。
HSM_NAME="<hsm-name>"
KEY_NAME="<key-name>"
# Create an RSA-HSM key in the managed HSM
az keyvault key create \
--hsm-name $HSM_NAME \
--name $KEY_NAME \
--kty RSA-HSM \
--size 2048
# Get the resource ID and principal ID of the user-assigned managed identity
IDENTITY_RESOURCE_ID=$(az identity show \
--name <identity-name> \
--resource-group <resource-group> \
--query id -o tsv)
IDENTITY_PRINCIPAL_ID=$(az identity show \
--name <identity-name> \
--resource-group <resource-group> \
--query principalId -o tsv)
# Assign the Managed HSM Crypto Service Encryption User role to the managed identity, scoped to the key
az keyvault role assignment create \
--hsm-name $HSM_NAME \
--role "Managed HSM Crypto Service Encryption User" \
--assignee-object-id $IDENTITY_PRINCIPAL_ID \
--assignee-principal-type ServicePrincipal \
--scope /keys/$KEY_NAME
# Get the managed HSM URI
HSM_URI=$(az keyvault show \
--hsm-name $HSM_NAME \
--query properties.hsmUri -o tsv)
# Configure customer-managed keys on the storage account
az storage account update \
--name <storage-account-name> \
--resource-group <resource-group> \
--identity-type UserAssigned \
--user-identity-id $IDENTITY_RESOURCE_ID \
--encryption-key-vault $HSM_URI \
--encryption-key-name $KEY_NAME \
--encryption-key-source Microsoft.Keyvault \
--key-vault-user-identity-id $IDENTITY_RESOURCE_ID
要建立一個在受管理 HSM 中使用金鑰的新儲存帳戶,請依照「 為新儲存帳戶配置客戶管理金鑰」中的步驟。 使用受管理 HSM 的 URI 作為金鑰庫 URI。
關於跨租用戶的客戶自控金鑰
許多在 Azure 上建置軟體即服務(SaaS)產品的服務提供商,希望讓客戶能夠自行管理加密金鑰。 客戶自控金鑰可讓服務提供者使用服務提供者的客戶所管理的加密金鑰來加密客戶的資料,而且服務提供者無法存取。 在 Azure 中,服務提供者的客戶可以使用 Azure Key Vault 管理他們自己的 Microsoft Entra 租戶和訂閱中的加密金鑰。
Azure 平台服務與資源,若服務提供者擁有且位於服務提供者租戶中,則需從客戶租戶取得金鑰才能執行加密/解密操作。
下圖顯示在跨租用戶客戶自控金鑰工作流程中,透過同盟身分進行的待用資料加密,該流程涵蓋服務提供者及其客戶。
在上述範例中,有兩個Microsoft Entra租戶:獨立服務提供者的租戶(Tenant 1),以及客戶的租戶(Tenant 2)。
Tenant1 裝載 Azure 平台服務,而 Tenant2 裝載客戶的金鑰保存庫。
多租戶應用程式註冊由 Tenant 1 中的服務提供者建立。 在此應用程式上建立同盟身分識別認證時,所使用的是使用者指派的受控識別。 然後,應用程式的名稱和應用程式識別碼會與客戶共用。
具有適當權限的使用者會在客戶租用戶 Tenant2 中安裝服務提供者的應用程式。 接著,使用者會授與與已安裝應用程式相關聯的服務主體對客戶金鑰保存庫的存取權限。 客戶也會將加密金鑰或客戶自控金鑰儲存在金鑰保存庫中。 客戶會與服務提供者共用金鑰位置 (金鑰的 URL)。
服務提供者現在具有:
- 安裝在客戶租用戶中之多租用戶應用程式的應用程式識別碼,已獲得客戶自控金鑰的存取權。
- 在多租用戶應用程式上設定為認證的受控識別。
- 客戶金鑰保存庫中的金鑰位置。
使用這三個參數,服務提供者會在 Tenant1 中佈建 Azure 資源,其可使用 Tenant2 中的客戶自控金鑰進行加密。
請將上述端對端解決方案分成三個階段:
- 服務提供者設定身分識別。
- 客戶授權服務提供者的多租戶應用程式存取 Azure Key Vault 中的加密金鑰。
- 服務提供者會使用客戶管理的金鑰加密 Azure 資源中的資料。
階段 1 中的作業是大部分服務提供者應用程式的一次性設定。 階段 2 和 3 中的作業會針對每個客戶重複。
服務提供者注意事項
- 不建議使用 Azure Resource Manager (ARM) 範本來建立 Microsoft Entra 應用程式。
- 相同的多租用戶應用程式可以用來存取任意數目之租用戶中的金鑰,例如 Tenant2、Tenant3、Tenant4 等等。 在每個租戶中,都會建立一個應用程式的獨立實例,其擁有相同的應用程式識別碼,但物件識別碼則不相同。 因此,此應用程式的每個執行個體都會獨立獲得授權。 請考慮如何使用此功能的應用程式物件將應用程式分割給所有客戶。
- 應用程式最多可以有 20 個同盟身分識別認證,而這需要服務提供者在其客戶之間共用同盟身分識別。 如需同盟身分識別設計考量和限制的詳細資訊,請參閱設定應用程式以信任外部身分識別提供者
- 在罕見的情況下,服務提供者可能會根據其客戶使用單一 Application 物件,但這需要大量維護成本,才能跨所有客戶大規模管理應用程式。
- 在服務提供者租戶中,無法自動進行發行者驗證。
階段 2 - 客戶授權存取金鑰保存庫
服務提供者客戶需考量的因素
- 在客戶租用戶 Tenant2 中,管理員可以設定原則來封鎖非管理使用者安裝應用程式。 這些原則可防止非管理使用者建立服務主體。 如果已設定這類原則,則必須涉及具有建立服務主體權限的使用者。
- 存取 Azure Key Vault 可以透過 Azure RBAC 或存取政策授權。 授與金鑰保存庫的存取權時,請務必使用金鑰保存庫的作用中機制。
- Microsoft Entra 應用程式註冊具有應用程式識別碼 (用戶端識別碼)。 在您的租用戶中安裝應用程式時,會建立服務主體。 服務主體與應用程式註冊共用相同的應用程式識別碼,但會產生自己的物件識別碼。 當您授權應用程式能夠存取資源時,可能需要使用服務主體
Name 或 ObjectID 屬性。
階段 3 - 服務提供者使用客戶自控金鑰來加密 Azure 資源中的資料
在第一階段和第二階段完成後,服務提供者可以在 Azure 資源上設定加密,將金鑰與金鑰庫放在客戶的租戶中,Azure 資源則放在 ISV 的租戶中。 服務提供者可使用該 Azure 資源支援的客戶端工具、ARM 範本或 REST API 來配置跨租戶客戶管理金鑰。
本節說明如何配置跨租戶客戶管理的金鑰並加密客戶資料。 你會學習如何在 Tenant1 的資源中,使用客戶管理的金鑰加密,該金鑰儲存在 Tenant2 的金鑰庫中。 您可以使用 Azure 入口網站、Azure PowerShell 或 Azure CLI。
請登入Azure入口網站並依照以下步驟操作。
下列步驟是由服務提供者在其租用戶 Tenant1 中執行。
服務提供者建立新的多租戶應用程式註冊
你可以建立一個新的多租戶 Microsoft Entra 應用程式註冊,或是從現有的多租戶應用程式註冊開始。 如果從現有的應用程式註冊開始,請記下應用程式的應用程式識別碼 (用戶端識別碼)。
若要建立新的註冊:
在搜尋方塊中,搜尋 Microsoft Entra ID。 找到並選擇 Microsoft Entra ID 擴充功能。
在左側窗格中選擇 管理 > 應用程式註冊。
選取 + 新增註冊。
請提供應用程式註冊名稱,然後選擇 任意組織目錄中的帳戶(任何 Microsoft Entra 目錄 – 多租戶)。
選擇 登記。
請記下應用程式的 ApplicationId/ClientId。
服務提供者建立使用者指派的受控識別
建立使用者指派的受控識別,以作為同盟身分識別認證。
在搜尋方塊中,搜尋Managed Identities。 找出並選取 Managed Identities 擴充功能。
選擇 + 創建。
提供受控識別的資源群組、區域和名稱。
選擇 評論 + 創建。
成功部署後,請記下使用者指派的管理身份的 Azure ResourceId,此資料可在 Properties 下找到。 例如:
/subscriptions/tttttttt-0000-tttt-0000-tttt0000tttt/resourcegroups/XTCMKDemo/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ConsotoCMKDemoUA
將使用者指派的受控識別設定為應用程式的同盟身分識別認證,以模擬應用程式的身分識別。
瀏覽至 Microsoft Entra ID > 應用程式註冊 > 您的應用程式。
選取 [憑證和秘密]。
選取 同盟識別碼。
選取 + 新增認證。
在 聯邦式認證場景 下,選取 受管理的身分識別。
按一下 選取受控識別。 從窗格中,選取訂用帳戶。 在 [受控識別] 下,選取 [使用者指派的受控識別]。 在 [選取] 方塊中,搜尋您稍早建立的受控識別,然後按一下窗格底部的 [選取]。
在 [認證詳細資料] 下,提供認證的名稱和選用描述,然後選取 [新增]。
若要使用 Azure PowerShell 來設定 ISV 的租戶,請安裝最新的 Az 模組。 如需如何安裝 PowerShell 的詳細資訊,請參閱使用 PowerShellGet 在 Windows 上安裝 Azure PowerShell。
- 如果你選擇在本地使用 Azure PowerShell:
- 如果您選擇使用 Azure Cloud Shell:
服務提供者 (ISV) 在其租用戶 Tenant1 中執行以下步驟。
服務提供者登入 Azure
在 Azure PowerShell 中,登入 ISV 的租戶,並將有效訂閱設定為 ISV 的訂閱。
$isvTenantId="<isv-tenant-id>"
$isvSubscriptionId="<isv-subscription-id>"
# Sign in to Azure in the ISV's tenant.
Connect-AzAccount -Tenant $isvTenantId
# Set the context to the ISV's subscription.
Set-AzContext -Subscription $isvSubscriptionId
服務提供者建立新的多租戶應用程式註冊
請在 Tenant1 中為多租戶註冊應用程式選擇名稱,並在Azure入口網站建立多租戶應用程式。
客戶會使用您為多租用戶應用程式所提供的名稱來識別 Tenant2 中的應用程式。 請記下應用程式的物件識別碼和應用程式識別碼。 您在後續步驟中將需要這些值。
$multiTenantAppName="<multi-tenant-app>"
$multiTenantApp = New-AzADApplication -DisplayName $multiTenantAppName `
-SignInAudience AzureADMultipleOrgs
# Object ID for the new multi-tenant app
$objectId = $multiTenantApp.Id
# Application (client) ID for the multi-tenant app
$multiTenantAppObjectId = $multiTenantApp.AppId
服務提供者建立使用者指派的受控識別
登入 ISV 的租用戶,然後建立要作為同盟身分識別認證的使用者指派受控識別。 要建立新的使用者指派的管理身份,您必須被指派一個包含 Microsoft.ManagedIdentity/userAssignedIdentities/write 動作的角色。
$isvRgName="<isv-resource-group>"
$isvLocation="<location>"
$userIdentityName="<user-assigned-managed-identity>"
# Create a new resource group in the ISV's subscription.
New-AzResourceGroup -Location $isvLocation -ResourceGroupName $isvRgName
# Create the new user-assigned managed identity.
$userIdentity = New-AzUserAssignedIdentity -Name $userIdentityName `
-ResourceGroupName $isvRgName `
-Location $isvLocation `
-SubscriptionId $isvSubscriptionId
將使用者指派的受控識別設定為應用程式的同盟身分識別認證,以模擬應用程式的身分識別。
若要從 PowerShell 設定同盟身分識別認證,請先安裝 Az.Resources 模組的 6.3.0 版或更新版本。
New-AzADAppFederatedCredential -ApplicationObjectId $multiTenantApp.Id `
-Name "MyFederatedIdentityCredential" `
-Audience "api://AzureADTokenExchange" `
-Issuer "https://login.microsoftonline.com/<tenant-id>/v2.0" `
-Subject $userIdentity.PrincipalId `
-Description "Federated Identity Credential for a customer-managed key"
下列步驟是由服務提供者在其租用戶 Tenant1 中執行。
服務提供者登入 Azure
登入 Azure 以使用 Azure CLI。
az login
服務提供者建立新的多租戶應用程式註冊
請在 Tenant1 中為多租戶應用程式選擇名稱,並在 Azure 入口建立該多租戶應用程式。
客戶會使用您為多租用戶應用程式所提供的名稱來識別 Tenant2 中的應用程式。 複製應用程式的應用程式識別碼 (或用戶端識別碼)、應用程式的物件識別碼,以及應用程式的租用戶識別碼。 您會在後續步驟中用到這些值。
multiTenantAppName="<multi-tenant-app>"
multiTenantAppObjectId=$(az ad app create --display-name $multiTenantAppName \
--sign-in-audience AzureADMultipleOrgs \
--query id \
--output tsv)
multiTenantAppId=$(az ad app show --id $multiTenantAppObjectId --query appId --output tsv)
服務提供者建立使用者指派的受控識別
登入 ISV 的租用戶,然後建立要作為同盟身分識別認證的使用者指派受控識別。 要建立新的使用者指派的管理身份,您必須被指派一個包含 Microsoft.ManagedIdentity/userAssignedIdentities/write 動作的角色。
isvSubscriptionId="<isv-subscription-id>"
isvRgName="<isv-resource-group>"
isvLocation="<location>"
userIdentityName="<user-assigned-managed-identity>"
az group create --location $isvLocation \
--resource-group $isvRgName \
--subscription $isvSubscriptionId
principalId=$(az identity create --name $userIdentityName \
--resource-group $isvRgName \
--location $isvLocation \
--subscription $isvSubscriptionId \
--query principalId \
--out tsv)
執行 az ad app federated-credential create 方法,以在應用程式上設定同盟身分識別認證,並建立與外部身分識別提供者的信任關係。
使用 api://AzureADTokenExchange 作為同盟身分識別認證中的 audience 值。 如需詳細資訊,請參閱 API 參考。
# Create a file named "credential.json" with the following content.
# Replace placeholders in angle brackets with your own values.
{
"name": "MyFederatedIdentityCredential",
"issuer": "https://login.microsoftonline.com/<tenantID>/v2.0",
"subject": "<user-assigned-identity-principal-id>",
"description": "Federated Identity Credential for a customer-managed key",
"audiences": [
"api://AzureADTokenExchange"
]
}
az ad app federated-credential create --id $multiTenantAppObjectId --parameters credential.json
服務提供者與客戶共用應用程式識別碼
尋找多租用戶應用程式的應用程式識別碼 (用戶端識別碼),並與客戶共用。
客戶授予服務提供者的應用程式對於金鑰保存庫中金鑰的存取權限。
下列步驟是由客戶在其租戶 Tenant2 中執行。 客戶可以使用 Azure 入口網站、Azure PowerShell 或 Azure CLI。
執行這些步驟的使用者必須是具有特殊權限角色的管理員,例如應用程式管理員、雲端應用程式管理員或全域管理員。
請登入Azure入口網站並依照以下步驟操作。
客戶在客戶租用戶中安裝服務提供者應用程式
若要在客戶租戶中安裝服務提供者註冊的應用程式,您可以使用該應用程式的應用程式識別碼來建立服務主體。 您可以使用下列任一種方式來建立服務主體:
客戶建立金鑰保存庫
若要建立金鑰保存庫,必須將「金鑰保存庫參與者」角色或另一個允許建立金鑰保存庫的角色指派給使用者的帳戶。
在Azure門戶選單或首頁,選擇 + 建立資源。 在 [搜尋] 方塊中,輸入「金鑰保存庫」。 從結果清單中,選取 [金鑰保存庫]。 在 [金鑰保存庫] 頁面上,選取 [建立]。
在 [基本] 索引標籤上,選擇訂用帳戶。 在 [資源群組] 下,選取 [新建],然後輸入資源群組名稱。
輸入金鑰保存庫的唯一名稱。
選取區域和定價層。
為新的金鑰保存庫啟用清除保護。
在 Access 政策 標籤中,為權限模型 選擇 Azure 角色基礎存取控制。
請選擇檢閱 + 建立,然後選擇建立。
記下可存取金鑰保存庫的金鑰保存庫名稱和 URI 應用程式必須使用此 URI。
如需詳細資訊,請參閱快速入門 - 使用 Azure 入口網站建立 Azure Key Vault。
客戶將 金鑰保存庫 加密專員角色指派給使用者帳號
此步驟可確保您可以建立加密金鑰。
- 進入你的金鑰庫,從左側窗格選擇 存取控制 (IAM)。
- 在授與此資源的存取權下方,選取新增角色指派。
- 搜尋並選擇 金鑰保存庫 Crypto Officer。
- 在 [成員] 下,選取 [使用者、群組或服務主體]。
- 選取 [成員],然後搜尋您的使用者帳戶。
- 選取 檢閱 + 指派。
客戶建立加密金鑰
要建立加密金鑰,使用者的帳號必須被指派為 金鑰保存庫 Crypto Officer 角色,或其他允許建立金鑰的角色。
- 在 [金鑰保存庫屬性] 頁面上,選取 [金鑰]。
- 選取 產生/匯入。
- 在 [建立金鑰] 畫面上,指定金鑰的名稱。 將其他值保留為預設值。
- 選取 建立。
- 複製金鑰 URI。
客戶將金鑰保存庫的存取權授予服務提供者應用程式
將 Azure RBAC 角色「金鑰保存庫密碼編譯服務加密使用者」指派給服務提供者的已註冊應用程式,以便存取金鑰保存庫。
- 進入你的金鑰庫,從左側窗格選擇 存取控制 (IAM)。
- 在授與此資源的存取權下方,選取新增角色指派。
- 搜尋並選擇 金鑰保存庫 加密服務加密用戶。
- 在 [成員] 下,選取 [使用者、群組或服務主體]。
- 選取 [成員],然後搜尋您從服務提供者安裝之應用程式的應用程式名稱。
- 選取 檢閱 + 指派。
您現在可以使用金鑰保存庫 URI 和金鑰來設定客戶自控金鑰。
若要使用 Azure PowerShell 來設定客戶端租戶,請安裝最新的 Az 模組。 如需如何安裝 PowerShell 的詳細資訊,請參閱使用 PowerShellGet 在 Windows 上安裝 Azure PowerShell。
- 如果你選擇在本地使用 Azure PowerShell:
- 如果您選擇使用 Azure Cloud Shell:
客戶登入 Azure
在 Azure PowerShell 中,登入客戶的租戶,並將有效訂閱設定為客戶的訂閱。
$customerTenantId="<customer-tenant-id>"
$customerSubscriptionId="<customer-subscription-id>"
# Sign in to Azure in the customer's tenant.
Connect-AzAccount -Tenant $customerTenantId
# Set the context to the customer's subscription.
Set-AzContext -Subscription $customerSubscriptionId
客戶在客戶租用戶中安裝服務提供者應用程式
在您收到服務提供者多租用戶應用程式的應用程式識別碼之後,請建立服務主體以在租用戶 Tenant2 中安裝應用程式。
在您打算在其中建立金鑰保存庫的租用戶中執行下列命令。
$customerRgName="<customer-resource-group>"
$customerLocation="<location>"
$multiTenantAppId="<multi-tenant-app-id>" # appId value from Tenant1
# Create a resource group in the customer's subscription.
New-AzResourceGroup -Location $customerLocation -ResourceGroupName $customerRgName
# Create the service principal with the registered app's application ID (client ID).
$servicePrincipal = New-AzADServicePrincipal -ApplicationId $multiTenantAppId
客戶建立金鑰保存庫
若要建立金鑰保存庫,必須將「金鑰保存庫參與者」角色或另一個允許建立金鑰保存庫的角色,指派給客戶的帳戶。
$kvName="<key-vault>"
$kv = New-AzKeyVault -Location $customerLocation `
-Name $kvName `
-ResourceGroupName $customerRgName `
-SubscriptionId $customerSubscriptionId `
-EnablePurgeProtection `
-EnableRbacAuthorization
客戶將 金鑰保存庫 加密專員角色指派給使用者帳號
將 金鑰保存庫 加密官員 角色指派給使用者帳號。 此步驟確保使用者可以建立金鑰保存庫和加密金鑰。 下列範例會將角色指派給目前的登入使用者。
$currentUserObjectId = (Get-AzADUser -SignedIn).Id
New-AzRoleAssignment -RoleDefinitionName "Key Vault Crypto Officer" `
-Scope $kv.ResourceId `
-ObjectId $currentUserObjectId
客戶建立加密金鑰
要建立加密金鑰,使用者的帳號必須被指派為 金鑰保存庫 Crypto Officer 角色,或其他允許建立金鑰的角色。
$keyName="<key-name>"
Add-AzKeyVaultKey -Name $keyName `
-VaultName $kvName `
-Destination software
客戶將金鑰保存庫的存取權授予服務提供者應用程式
透過您稍早所建立的服務主體,將 Azure RBAC 角色「金鑰保存庫密碼編譯服務加密使用者」指派給服務提供者的已註冊應用程式,以存取金鑰保存庫。
New-AzRoleAssignment -RoleDefinitionName "Key Vault Crypto Service Encryption User" `
-Scope $kv.ResourceId `
-ObjectId $servicePrincipal.Id
您現在可以使用金鑰保存庫 URI 和金鑰來設定客戶自控金鑰。
客戶登入 Azure
登入 Azure 以使用 Azure CLI。
az login
客戶在客戶租用戶中安裝服務提供者應用程式
一旦您收到服務提供者的多租用戶應用程式的應用程式識別碼,請使用下列命令在租用戶 Tenant2 中安裝應用程式。 安裝應用程式後,會在您的租戶中建立一個服務主體。
在您打算在其中建立金鑰保存庫的租用戶中執行下列命令。
# Create the service principal with the registered app's application ID (client ID)
multiTenantAppId="<multi-tenant-app-id>"
az ad sp create --id $multiTenantAppId --query id --out tsv
客戶建立金鑰保存庫
若要建立金鑰保存庫,必須將「金鑰保存庫參與者」角色或另一個允許建立金鑰保存庫的角色,指派給客戶的帳戶。
customerSubscriptionId="<customer-subscription-id>"
customerRgName="<customer-resource-group>"
customerLocation="<location>"
kvName="<key-vault>"
az group create --location $customerLocation \
--name $customerRgName
az keyvault create --name $kvName \
--location $customerLocation \
--resource-group $customerRgName \
--subscription $customerSubscriptionId \
--enable-purge-protection true \
--enable-rbac-authorization true
客戶將 金鑰保存庫 加密專員角色指派給使用者帳號
此步驟可確保您可以建立金鑰保存庫和加密金鑰。
currentUserObjectId=$(az ad signed-in-user show --query id --output tsv)
kvResourceId=$(az keyvault show --resource-group $customerRgName \
--name $kvName \
--query id \
--output tsv)
az role assignment create --role "Key Vault Crypto Officer" \
--scope $kvResourceId \
--assignee-object-id $currentUserObjectId
客戶建立加密金鑰
要建立加密金鑰,使用者的帳號必須被指派為 金鑰保存庫 Crypto Officer 角色,或其他允許建立金鑰的角色。
keyName="<key-name>"
az keyvault key create --name $keyName --vault-name $kvName
客戶將金鑰保存庫的存取權授予服務提供者應用程式
透過您稍早所建立的服務主體,將 Azure RBAC 角色「金鑰保存庫密碼編譯服務加密使用者」指派給服務提供者的已註冊應用程式,讓已註冊應用程式可以存取金鑰保存庫。
servicePrincipalId=$(az ad sp show --id $multiTenantAppId --query id --output tsv)
az role assignment create --role "Key Vault Crypto Service Encryption User" \
--scope $kvResourceId \
--assignee-object-id $servicePrincipalId
您現在可以使用金鑰保存庫 URI 和金鑰來設定客戶自控金鑰。
在此之前,你在 ISV 的租戶上設定多租戶應用程式,在客戶的租戶上安裝應用程式,並在客戶的租戶上設定金鑰庫和金鑰。 接著,你可以用客戶的租用戶中的金鑰在現有的儲存帳戶上設定客戶管理的金鑰。
以下範例展示了如何在現有儲存帳戶上,使用使用者指派的管理身份來授權存取金鑰庫,來設定客戶管理的金鑰。 您也可以使用系統指派的受控識別,在現有的儲存體帳戶上設定客戶自控金鑰。 在任一情況下,受控識別都必須有適當的權限可存取金鑰保存庫。 如需詳細資訊,請參閱向 Azure Key Vault 進行驗證。
當你為現有儲存帳戶設定客戶管理的金鑰加密時,只要相關金鑰庫中有新版本可用,你就可以選擇自動更新用於加密的金鑰版本。 要啟用此功能,請從金鑰 URI 中省略金鑰版本。 或者,您也可以明確指定一個用於加密的金鑰版本,在手動更新金鑰版本之前都使用該版本。 在金鑰 URI 上包含金鑰版本可設定客戶自控金鑰,以手動更新金鑰版本。
若要在 Azure 入口網站中為現有的儲存體帳戶設定跨租用戶的客戶自控金鑰,請遵循下列步驟:
前往您的儲存帳戶。
在 [安全性 + 網路] 下方,選取 [加密]。 預設情況下,金鑰管理設定為 Microsoft 管理的金鑰。
選取 [客戶自控金鑰] 選項。
選擇 從 金鑰保存庫 選取 選項。
選取 [輸入金鑰 URI],然後指定金鑰 URI。 如果你想讓 Azure 檔案儲存體 自動檢查是否有新的金鑰版本,並加以更新,可以省略 URI 中的金鑰版本。
選取包含金鑰保存庫和金鑰的訂用帳戶。
在 [身分識別類型] 欄位中,選取 [ 使用者指派],然後使用您先前建立的同盟身分識別認證來指定受控識別。
展開 進階 區塊,選擇你之前在 ISV 租戶中建立的多租戶註冊應用程式。
儲存您的變更。
在你從客戶租戶的金鑰保存庫指定金鑰後,Azure 入口網站會顯示已設定為使用該金鑰的客戶管理金鑰。 其也會指出已啟用金鑰版本的自動更新,並顯示目前用於加密的金鑰版本。 入口網站同時顯示用於授權存取金鑰庫的受管理身份類型、該管理身份的主識別碼,以及多租戶應用程式的應用程式識別碼。
要使用 PowerShell 為現有儲存帳號設定跨租用戶客戶管理的金鑰,請先安裝 Az.Storage PowerShell 模組,版本為 5.1.0 或更新版本。 此模組會與 Az PowerShell 模組 9.1.0 版或更新版本一起安裝。
接著,呼叫 Set-AzStorageAccount,提供你先前在 ISV 訂閱中設定的使用者指派管理身份的資源 ID,以及你先前在 ISV 訂閱中設定的多租戶應用程式(用戶端)ID。 提供客戶金鑰保存庫的 URI 和金鑰名稱。
請記得將括弧中的預留位置值取代為您自己的值,並使用先前的範例中定義的變數。
$accountName = "<storage-account>"
$kvUri = "<key-vault-uri>"
$keyName = "<key-name>"
$multiTenantAppId = "<multi-tenant-app-id>"
$accountParams = @{
ResourceGroupName = $isvRgName
Name = $accountName
KeyVaultEncryption = $true
UserAssignedIdentityId = $userIdentity.Id
IdentityType = "SystemAssignedUserAssigned"
KeyName = $keyName
KeyVaultUri = $kvUri
KeyVaultUserAssignedIdentityId = $userIdentity.Id
KeyVaultFederatedClientId = $multiTenantAppId
}
Set-AzStorageAccount @accountParams
若要使用 Azure CLI 為現有儲存體帳戶設定跨租用戶客戶自控金鑰,請先安裝 Azure CLI 2.42.0 版或更新版本。 如需安裝 Azure CLI 的詳細資訊,請參閱如何安裝 Azure CLI。
接著,呼叫 az storage account update,提供你先前在 ISV 訂閱中設定的使用者指派受控識別的資源 ID,以及你之前在 ISV 訂閱中設定的多租戶應用程式的應用程式(用戶端)ID。 提供客戶金鑰保存庫的 URI 和金鑰名稱。
請記得將括弧中的預留位置值取代為您自己的值,並使用先前的範例中定義的變數。
accountName="<storage-account>"
kvUri="<key-vault-uri>"
keyName="<key-name>"
multiTenantAppId="<multi-tenant-app-id>" # appId value from multi-tenant app
# Get the resource ID for the user-assigned managed identity.
identityResourceId=$(az identity show --name $userIdentityName \
--resource-group $isvRgName \
--query id \
--output tsv)
az storage account update --name $accountName \
--resource-group $isvRgName \
--identity-type SystemAssigned,UserAssigned \
--user-identity-id $identityResourceId \
--encryption-key-vault $kvUri \
--encryption-key-name $keyName \
--encryption-key-source Microsoft.Keyvault \
--key-vault-user-identity-id $identityResourceId \
--key-vault-federated-client-id $multiTenantAppId
服務提供者建立一個以客戶金鑰加密的新儲存體帳戶
你也可以在 ISV 租戶上建立新的儲存帳戶,並使用客戶租戶中的金鑰設定客戶自控金鑰。
在建立儲存體帳戶期間設定客戶自控金鑰時,您必須使用使用者指派的現有受控識別來授與金鑰保存庫的存取權。 使用者指派的受控識別必須有適當的權限可存取金鑰保存庫。 如需詳細資訊,請參閱向 Azure Key Vault 進行驗證。
當你為新儲存帳號設定客戶管理的金鑰加密時,只要相關金鑰庫中有新版本可用,你就可以選擇自動更新用於加密的金鑰版本。 若要這麼做,請省略金鑰 URI 中的金鑰版本。 或者,您可以明確指定在手動更新金鑰版本前要用於加密的金鑰版本。 在金鑰 URI 上包含金鑰版本可設定客戶自控金鑰,以手動更新金鑰版本。
若要在 Azure 入口網站中為新的儲存體帳戶設定跨租用戶的客戶自控金鑰,請遵循下列步驟:
在 Azure 入口網站,前往 ISV 租戶的儲存帳戶頁面,選擇建立按鈕以建立新帳戶。
請依照「建立經典檔案分享」中的步驟,填寫 基礎、進階、網路及 資料保護 分頁的欄位。
在 [加密] 索引標籤上的 [啟用客戶自控金鑰的支援] 欄位中,指定要啟用客戶自控金鑰支援的服務。
在 [加密類型] 欄位中,選取 [客戶自控金鑰 (CMK)]。
在 [加密金鑰] 欄位中,選擇 [輸入金鑰保存庫中的金鑰],然後指定金鑰 URI。 如果你想讓 Azure 檔案儲存體 自動檢查並更新新的 key 版本,可以省略 URI 中的金鑰版本。
針對 [使用者指派的身分識別] 欄位,搜尋您先前在 ISV 租用戶中建立的使用者指派受控識別。
展開 進階 區塊,選擇你之前在 ISV 租戶中建立的多租戶註冊應用程式。
選取 [檢閱] 按鈕,以驗證並建立帳戶。
若要在 PowerShell 中為新的儲存體帳戶設定跨租用戶客戶自控金鑰,請先安裝 Az.Storage PowerShell 模組 5.1.0 版或更新版本。 此模組會與 Az PowerShell 模組 9.1.0 版或更新版本一起安裝。
接著,呼叫 New-AzStorageAccount,提供你先前在 ISV 訂閱中設定的使用者指派管理身份的資源 ID,以及你先前在 ISV 訂閱中設定的多租戶應用程式(客戶端)ID。 提供客戶金鑰保存庫的 URI 和金鑰名稱。
請記得將括弧中的預留位置值取代為您自己的值,並使用先前的範例中定義的變數。
$accountName = "<account-name>"
$kvUri = "<key-vault-uri>"
$keyName = "<key-name>"
$location = "<location>"
$multiTenantAppId = "<application-id>" # appId value from multi-tenant app
$userIdentity = Get-AzUserAssignedIdentity -Name "<user-assigned-identity>" -ResourceGroupName $isvRgName
$accountParams = @{
ResourceGroupName = $isvRgName
Name = $accountName
Kind = "StorageV2"
SkuName = "Standard_LRS"
Location = $location
UserAssignedIdentityId = $userIdentity.Id
IdentityType = "SystemAssignedUserAssigned"
KeyName = $keyName
KeyVaultUri = $kvUri
KeyVaultUserAssignedIdentityId = $userIdentity.Id
KeyVaultFederatedClientId = $multiTenantAppId
}
New-AzStorageAccount @accountParams
若要使用 Azure CLI 為新的儲存體帳戶設定跨租用戶客戶自控金鑰,請先安裝 Azure CLI 2.42.0 版或更新版本。 如需安裝 Azure CLI 的詳細資訊,請參閱如何安裝 Azure CLI。
接著,呼叫az storage account create,並提供您先前在 ISV 訂用帳戶中設定之使用者指派受控身分識別的資源識別碼,以及您先前在 ISV 訂用帳戶中設定之多租用戶應用程式的應用程式 (用戶端) 識別碼。 提供客戶金鑰保存庫的 URI 和金鑰名稱。
請記得將括弧中的預留位置值取代為您自己的值,並使用先前的範例中定義的變數。
accountName="<storage-account>"
kvUri="<key-vault-uri>"
keyName="<key-name>"
multiTenantAppId="<multi-tenant-app-id>" # appId value from multi-tenant app
# Get the resource ID for the user-assigned managed identity.
identityResourceId=$(az identity show --name $userIdentityName \
--resource-group $isvRgName \
--query id \
--output tsv)
az storage account create \
--name $accountName \
--resource-group $isvRgName \
--location $isvLocation \
--sku Standard_LRS \
--kind StorageV2 \
--identity-type SystemAssigned,UserAssigned \
--user-identity-id $identityResourceId \
--encryption-key-vault $kvUri \
--encryption-key-name $keyName \
--encryption-key-source Microsoft.Keyvault \
--key-vault-user-identity-id $identityResourceId \
--key-vault-federated-client-id $multiTenantAppId
您也可以在建立新的儲存體帳戶時,設定由客戶管理的金鑰,並手動更新金鑰的版本。 若要這樣做,請在指定金鑰 URI 時包括金鑰版本。
要輪替或更換金鑰、撤銷存取權或切回 Microsoft 管理的金鑰,請使用以下章節中的步驟。 這些步驟對跨租戶客戶管理的金鑰也是相同的。
金鑰輪替
定期輪換加密金鑰可以減少金鑰一旦被洩漏的風險。 針對使用客戶管理金鑰的儲存帳號,有兩種輪替加密金鑰的方式:
-
旋轉鑰匙版本 - 在鑰匙庫中建立同一鑰匙的新版本。 金鑰名稱保持不變,但版本會改變。
-
更改金鑰 - 將儲存帳號切換成在同一或不同的金鑰庫中使用完全不同的金鑰(名稱不同)。
Important
Azure 每天只檢查一次金鑰庫中的新金鑰版本。 更換金鑰後,請等待 24 小時內再停用先前的金鑰版本。
輪替金鑰版本
為了安全最佳實務,至少每兩年輪換一次金鑰版本。
自動密鑰版本輪換(建議)
如果你設定客戶管理的金鑰但未指定金鑰版本(預設值),Azure 會自動每天檢查是否有新的金鑰版本。 如果你在金鑰庫中建立新版本的金鑰,Azure 會在 24 小時內接收。 你也可以在 Azure Key Vault 設定 自動金鑰輪替,以排程產生新的金鑰版本。
手動金鑰版本輪替
如果你在設定客戶管理金鑰時指定金鑰版本,Azure 會使用該特定版本,不會自動檢查是否有新版本。 你必須手動更新儲存帳號設定,指向新的金鑰版本。
若要透過 Azure 入口網站手動輪換金鑰版本,請依照以下步驟操作:
- 移至您的金鑰保存庫。 在服務選單中,選擇物件後,再選擇金鑰。
- 先選取金鑰,然後選擇新的金鑰版本。 複製 金鑰識別碼的值。 該值包含了金鑰版本。
- 前往您的儲存帳戶。 在服務選單中,在 安全 + 網路中選擇 加密。
- 選取 [變更金鑰]。
- 對於加密金鑰,選擇輸入金鑰 URI,然後將金鑰識別碼貼入金鑰 URI。
- 選取 [儲存]。
若要使用 Azure PowerShell 手動輪換金鑰版本,請執行以下 cmdlet。 將<resource-group>、<storage-account-name>、<key-vault-name>和<key-name>替換為您自己的值。
$keyVaultName = "<key-vault-name>"
$keyVault = Get-AzKeyVault -VaultName $keyVaultName
$key = Get-AzKeyVaultKey -VaultName $keyVaultName -Name "<key-name>"
$accountParams = @{
ResourceGroupName = "<resource-group>"
Name = "<storage-account-name>"
KeyVaultUri = $keyVault.VaultUri
KeyName = $key.Name
KeyVersion = $key.Version
KeyVaultEncryption = $true
}
Set-AzStorageAccount @accountParams
若要使用 Azure CLI 手動輪換金鑰版本,請執行以下指令。 將<storage-account-name>、<resource-group>、<key-vault-name>和<key-name>替換為您自己的值。
# Get the key vault URI
KEY_VAULT_URI=$(az keyvault show \
--name <key-vault-name> \
--query properties.vaultUri -o tsv)
# Get the latest key version
KEY_VERSION=$(az keyvault key show \
--vault-name <key-vault-name> \
--name <key-name> \
--query key.kid -o tsv | sed -e 's|.*/||')
az storage account update \
--name <storage-account-name> \
--resource-group <resource-group> \
--encryption-key-vault $KEY_VAULT_URI \
--encryption-key-name <key-name> \
--encryption-key-version $KEY_VERSION \
--encryption-key-source Microsoft.Keyvault
變更金鑰
若要切換儲存帳號使用完全不同的金鑰,請在您的金鑰庫中建立或匯入一組新金鑰(參見 建立或匯入加密金鑰),然後更新儲存帳號的加密設定以使用新金鑰。
要透過 Azure 入口網站更改金鑰,請依照以下步驟操作:
- 前往您的儲存帳戶。
- 在服務選單中,在 安全 + 網路中選擇 加密。
- 選取 [變更金鑰]。
- 選擇 選擇一個金鑰保管庫和金鑰。 對於 金鑰儲存類型,請選擇 金鑰保險庫。 選擇您的金鑰保存庫和新金鑰,然後選擇 Select。
- 選取 [儲存]。
要用 Azure PowerShell 更改鍵,請執行以下 cmdlet。 將<resource-group>、<storage-account-name>、<key-vault-name>和<new-key-name>替換為您自己的值。
Cmdlet 會將 KeyVersion 設為空值,這會開啟自動金鑰版本更新(建議)。 如果你省略 KeyVersion 了,而儲存帳戶使用了你之前指定的金鑰版本,指令程式會保留該版本並失敗,因為該版本對新金鑰不存在。 若要改用手動金鑰版本更新,請設定 KeyVersion 為 $key.Version。
$keyVaultName = "<key-vault-name>"
$keyVault = Get-AzKeyVault -VaultName $keyVaultName
$key = Get-AzKeyVaultKey -VaultName $keyVaultName -Name "<new-key-name>"
$accountParams = @{
ResourceGroupName = "<resource-group>"
Name = "<storage-account-name>"
KeyVaultUri = $keyVault.VaultUri
KeyName = $key.Name
KeyVersion = ""
KeyVaultEncryption = $true
}
Set-AzStorageAccount @accountParams
要使用 Azure CLI 更改金鑰,請執行以下指令。 將<storage-account-name>、<resource-group>、<key-vault-name>和<new-key-name>替換為您自己的值。
指令設 --encryption-key-version 為空值,啟動自動鍵版本更新(建議)。 如果您省略--encryption-key-version,且儲存體帳戶使用您先前指定的金鑰版本,命令會保留該版本並失敗,因為新金鑰沒有這個版本。 若要使用手動金鑰版本更新,請設定 --encryption-key-version 為新金鑰的版本。
# Get the key vault URI
KEY_VAULT_URI=$(az keyvault show \
--name <key-vault-name> \
--query properties.vaultUri -o tsv)
az storage account update \
--name <storage-account-name> \
--resource-group <resource-group> \
--encryption-key-vault $KEY_VAULT_URI \
--encryption-key-name <new-key-name> \
--encryption-key-version "" \
--encryption-key-source Microsoft.Keyvault
停用金鑰來撤銷對檔案分享資料的存取權
你可以透過停用或刪除客戶管理的金鑰來阻擋加密檔案分享資料的存取。 存取權限不會立即遭到封鎖。 停用金鑰後,資料平面操作可能需要幾分鐘才會開始失敗。 在金鑰被停用時,所有 Azure 檔案儲存體 資料平面操作在 HTTP 403(禁止)下都會失敗,包括:
- 列出目錄與檔案
- 建立、取得或設定目錄或檔案
- 取得或設定檔案元資料
- 輸入範圍、複製檔案、重新命名檔案
若要撤銷對檔案分享資料的存取,請使用 Azure 入口網站、Azure PowerShell 或 Azure CLI 來停用 key vault 中的金鑰。 重新啟用金鑰以恢復存取權限。
要透過 Azure 入口網站停用該金鑰,請遵循以下步驟:
- 前往 Azure 入口網站中的你的金鑰庫。
- 在服務選單中,選擇物件後,再選擇金鑰。
- 以滑鼠右鍵按一下該金鑰,然後選取 [停用]。
要使用 Azure PowerShell 停用該金鑰,請執行以下 cmdlet。 將<key-vault-name> 和 <key-name> 取代為您自己的值。
$keyParams = @{
VaultName = "<key-vault-name>"
Name = "<key-name>"
Enable = $false
}
Update-AzKeyVaultKey @keyParams
要使用 Azure CLI 停用該金鑰,請執行以下指令。 將<key-vault-name> 和 <key-name> 取代為您自己的值。
az keyvault key set-attributes \
--vault-name <key-vault-name> \
--name <key-name> \
--enabled false
切換回 Microsoft 管理的金鑰
如果你不再需要客戶管理的金鑰,可以透過 Azure 入口網站、Azure PowerShell 或 Azure CLI,將儲存帳號切回 Microsoft 管理的金鑰進行加密。
要透過 Azure 入口網站切換回 Microsoft 管理的金鑰,請遵循以下步驟:
- 請進入 Azure portal 的 storage 帳號。
- 在服務選單中,在 安全 + 網路中選擇 加密。
- 將 [加密類型] 變更為 [Microsoft 管理的金鑰]。
- 選取 [儲存]。
若要使用 Azure PowerShell 切回 Microsoft 管理的金鑰,請執行以下 cmdlet。 將<resource-group> 和 <storage-account-name> 取代為您自己的值。
$accountParams = @{
ResourceGroupName = "<resource-group>"
Name = "<storage-account-name>"
StorageEncryption = $true
}
Set-AzStorageAccount @accountParams
若要使用 Azure CLI 切回 Microsoft 管理的金鑰,請執行以下指令。 將<resource-group> 和 <storage-account-name> 取代為您自己的值。
az storage account update \
--name <storage-account-name> \
--resource-group <resource-group> \
--encryption-key-source Microsoft.Storage
相關內容