你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure Monitor 客户管理的密钥
使用 Microsoft 管理的密钥对 Azure Monitor 中的数据进行加密。 可以使用自己的加密密钥来保护工作区中的数据。 Azure Monitor 中的客户管理的密钥使你可以控制加密密钥生命周期和对日志的访问。 配置后，引入到链接工作区的新数据会使用 Azure Key Vault 或 Azure Key Vault 托管“HSM”中的密钥进行加密。
客户管理的密钥概述
静态数据加密是组织中常见的隐私和安全要求。 可以让 Azure 完全管理静态加密，也可以使用各种选项严格管理加密和加密密钥。
Azure Monitor 确保使用 Microsoft 管理的密钥 (MMK) 静态加密所有数据和保存的查询。 Azure Monitor 进行加密的操作与Azure 存储加密的操作相同。
若要控制密钥生命周期并且想要能够撤销对数据的访问权限，请使用你自己的在 Azure Key Vault 或 Azure Key Vault 托管“HSM”中的密钥来加密数据。 客户管理的密钥功能在专用群集上提供，该功能提供更高级别的保护和控制。
引入到专用群集的数据进行两次加密 - 一次在服务级别使用 Microsoft 管理的密钥或客户管理的密钥进行，一次在基础结构级别使用两种不同的加密算法和两个不同的密钥进行。 双重加密可以在其中一种加密算法或密钥被泄露的情况下提供保护。 专用群集还允许使用密码箱来保护数据。
过去 14 天内引入的数据或最近在查询中使用的数据保存在热缓存（受 SSD 支持）中，以提高查询效率。 SSD 数据使用 Microsoft 管理的密钥进行加密，而不管你是否配置客户管理的密钥，但你对 SSD 访问的控制遵循密钥吊销规定。
重要
专用群集使用承诺层级定价模型，该模型至少为 100 GB/天。
客户管理的密钥在 Azure Monitor 中的工作原理
Azure Monitor 使用托管标识授予对 Azure Key Vault 中的密钥的访问权限。 在群集级别支持 Log Analytics 群集的标识。 为了在多个工作区提供客户管理的密钥，Log Analytics 群集资源充当 Key Vault 和 Log Analytics 工作区之间的中间标识连接。 群集的存储使用与群集关联的托管标识，通过 Microsoft Entra ID 对 Azure Key Vault 进行身份验证。
群集支持两种托管标识类型：系统分配的标识和用户分配的标识，而单一标识可根据自己的场景在群集中进行自定义。
- 系统分配的托管标识更简单，会在
identitytype设置为SystemAssigned时随群集自动生成。 此标识稍后用于授予对 Key Vault 的存储访问权限，以便进行数据加密和解密。 - 用户分配的托管标识让你可以在创建群集时配置客户管理的密钥（前提是
identitytype设置为UserAssigned，且在创建群集之前在 Key Vault 中向其授予权限）。
可以在新群集或具有链接工作区且正在引入数据的现有专用群集上配置客户管理的密钥。 同样，可以随时取消工作区与群集的链接。 引入到链接工作区的新数据使用密钥进行加密，旧数据仍使用 Microsoft 管理的密钥进行加密。 配置不会中断引入或查询，查询可以无缝地跨新旧数据执行。 在取消工作区与群集的链接时。 引入的新数据使用 Microsoft 管理的密钥进行加密。
重要
客户管理的密钥功能是区域性的。 Azure Key Vault、专用群集和链接工作区必须位于同一区域，但可以位于不同订阅。
- 密钥保管库
- Log Analytics 群集资源具有拥有 Key Vault 权限的托管标识，此标识可传播到基础专用群集存储
- 专用群集
- 链接到专用群集的工作区
加密密钥类型
存储数据加密涉及 3 种类型的密钥：
- “KEK”- 密钥加密密钥（你的客户管理的密钥）
- “AEK”- 帐户加密密钥
- “DEK”- 数据加密密钥
下列规则适用：
- 群集存储对每个存储帐户都有唯一的加密密钥，称为“AEK”。
- AEK 用于派生 DEK 密钥，后者用于对写入磁盘的每个数据块进行加密。
- 在群集中配置客户管理的密钥“KEK”时，群集存储会执行向 Key Vault 发出的“包装”和“解包”请求，以进行“AEK”加密和解密。
- “KEK”绝不会离开 Key Vault，在将密钥存储在 Azure Key Vault 托管“HSM”中的情况下绝不会离开硬件。
- Azure 存储使用与群集关联的托管标识进行身份验证。 它通过 Microsoft Entra ID 访问 Azure Key Vault。
客户管理的密钥的预配步骤
- 创建 Azure Key Vault 和存储密钥
- 创建专用群集
- 向 Key Vault 授予权限
- 为专用群集更新密钥 ID 详细信息
- 链接工作区
目前，Azure 门户不完全支持客户管理的密钥的配置，可以通过 PowerShell、CLI 或 REST 请求执行预配。
存储加密密钥 (KEK)
Azure 密钥管理产品组合列出了可以使用的保管库和托管 HSM。
在计划群集的区域中创建或使用现有的 Azure Key Vault。 在 Key Vault 中，生成或导入用于日志加密的密钥。 必须将 Azure Key Vault 配置为可恢复，以保护密钥以及对 Azure Monitor 中的数据的访问权限。 可以验证是否应启用 Key Vault 中“软删除”和“清除保护”属性下的此配置 。
可以通过 CLI 和 PowerShell 在 Key Vault 中更新这些设置：
所需的权限
若要执行与群集相关的操作，需要以下权限：
| 操作 | 所需的权限或角色 |
|---|---|
| 创建专用群集 | 例如，Log Analytics 参与者内置角色提供的 Microsoft.Resources/deployments/* 和 Microsoft.OperationalInsights/clusters/write 权限 |
| 更改群集属性 | 例如，Log Analytics 参与者内置角色提供的 Microsoft.OperationalInsights/clusters/write 权限 |
| 将工作区链接到群集 | 例如，Log Analytics 参与者内置角色提供的 Microsoft.OperationalInsights/clusters/write、Microsoft.OperationalInsights/workspaces/write 和 Microsoft.OperationalInsights/workspaces/linkedservices/write 权限 |
| 检查工作区链接状态 | 例如，Log Analytics 读者内置角色提供的对工作区的 Microsoft.OperationalInsights/workspaces/read 权限 |
| 获取群集或检查群集的预配状态 | 例如，Log Analytics 读者内置角色提供的 Microsoft.OperationalInsights/clusters/read 权限 |
| 更新群集中的承诺层级或计费类型 | 例如，Log Analytics 参与者内置角色提供的 Microsoft.OperationalInsights/clusters/write 权限 |
| 授予所需权限 | 具有 */write 权限的所有者或参与者角色，或具有 Microsoft.OperationalInsights/* 权限的 Log Analytics 参与者内置角色 |
| 从群集中取消与工作区的链接 | 例如，Log Analytics 参与者内置角色提供的 Microsoft.OperationalInsights/workspaces/linkedServices/delete 权限 |
| 删除专用群集 | 例如，Log Analytics 参与者内置角色提供的 Microsoft.OperationalInsights/clusters/delete 权限 |
创建群集
群集使用托管标识对 Key Vault 进行数据加密。 在创建群集时将 identity type 属性配置为 SystemAssigned 或 UserAssigned，以允许访问 Key Vault 进行数据加密和解密操作。
例如，在系统分配的托管标识的请求正文中添加这些属性
{
"identity": {
"type": "SystemAssigned"
}
}
注意
创建群集后，可以更改标识类型，不会中断引入或查询，但需注意以下事项
- 群集中无法同时更新标识和密钥 — 在两个连续的操作中更新
- 将
SystemAssigned更新为UserAssigned– 在 Key Vault 中授予UserAssign标识，然后在群集中更新identity - 将
UserAssigned更新为SystemAssigned– 在 Key Vault 中授予SystemAssigned标识，然后在群集中更新identity
请按照“专用群集”一文中阐述的过程进行操作。
授予 Key Vault 权限
Azure 密钥保管库中有两种权限模型用于向群集和底层存储授予权限，分别是基于 Azure 角色的访问控制 (Azure RBAC) 和保管库访问策略（旧版）。
分配你控制的 Azure RBAC（建议做法）
若要添加角色分配，你必须具有一个拥有
Microsoft.Authorization/roleAssignments/write和Microsoft.Authorization/roleAssignments/delete权限的角色，例如用户访问管理员或所有者。- 在 Azure 门户中打开 Key Vault，然后选择“设置”>“访问配置”>“Azure 基于角色的访问控制”并“应用”
- 单击“转到访问控制(IAM)”按钮并添加“Key Vault 加密服务加密用户”角色分配。
- 在“成员”选项卡中选择“托管标识”，然后选择标识的订阅和标识作为成员
分配保管库访问策略（旧版）
在 Azure 门户中打开 Key Vault，然后选择“访问策略”>“保管库访问策略”>“+ 添加访问策略”以使用以下设置创建策略：
- 密钥权限 — 选择“获取”、“包装密钥”和“解包密钥”。
- 选择主体 - 具体取决于群集中使用的标识类型（系统或用户分配的托管标识）
- 系统分配的托管标识 - 输入群集名称或群集主体 ID
- 用户分配的托管标识 - 输入标识名称
需要“获取”权限，才能验证是否已将 Key Vault 配置为可恢复以保护密钥以及对 Azure Monitor 数据的访问。
为群集更新密钥标识符详细信息
群集的所有操作都需要 Microsoft.OperationalInsights/clusters/write 操作权限。 可以通过包含 */write 操作的所有者或参与者角色或包含 Microsoft.OperationalInsights/* 操作的 Log Analytics 参与者角色授予此权限。
此步骤使用用于“AEK”打包和解包的密钥和版本更新专用群集存储。
重要
- 密钥轮换可以是自动操作，也可以遵守显式的密钥版本。请参阅密钥轮换，确定合适的方法后再更新群集中的密钥 ID 详细信息。
- 群集更新不应在同一个操作中同时包含标识和密钥标识符详细信息。 如果需要对两者进行更新，则更新应为两个连续操作。
为群集中的 KeyVaultProperties 更新密钥标识符详细信息。
该操作是异步操作，可能需要一段时间才能完成。
将工作区链接到群集
重要
此步骤应仅在群集配置之后执行。 如果在预配前链接工作区并引入数据，则引入的数据将被删除，并且无法恢复。
请遵循“专用群集”一文中说明的过程。
取消工作区与群集的链接
请遵循“专用群集”一文中说明的过程。
密钥吊销
重要
- 若要撤销对数据的访问，建议禁用密钥，或删除 Key Vault 中的访问策略。
- 如果将群集的
identitytype设置为None，还可撤销数据访问权，但不建议使用此方法，因为如果不联系支持人员就无法将其还原。
群集的存储在一小时或更短时间内始终认可密钥权限的更改，存储会变得不可用。 引入到链接工作区的新数据将被删除且不可恢复。 这些工作空间上的数据无法访问，并且查询失败。 只要不删除群集和工作区，之前引入的数据就会保留在存储中。 不可访问的数据由数据保留策略管理，并在保留期截止时被清除。 过去 14 天内引入的数据和最近在查询中使用的数据也保存在热缓存（受 SSD 支持）中，以提高查询效率。 SSD 上的数据将在密钥吊销操作后被删除，并且变得不可访问。 群集存储会定期尝试访问 Key Vault 进行包装和解包，一旦启用密钥，解包就会成功，SSD 数据将从存储中重新加载，并在 30 分钟内恢复数据引入和查询。
密钥轮换
密钥轮换具有两种模式：
- 自动轮换 – 更新群集中的
"keyVaultProperties"属性并省略"keyVersion"属性，或将其设置为""。 存储会自动使用最新的密钥版本。 - 显式密钥版本更新 – 更新
"keyVaultProperties"属性并在"keyVersion"属性中更新密钥版本。 密钥轮换需要显式更新群集中的"keyVersion"属性。 有关详细信息，请参阅为群集更新密钥标识符详细信息。 如果在 Key Vault 中生成了新的密钥版本但未在群集中更新密钥，群集存储将继续使用之前的密钥。 如果在更新群集中的新密钥之前禁用或删除了旧密钥，则你将进入密钥吊销状态。
在密钥轮换操作期间和之后，你的所有数据仍然可以访问。 数据始终使用帐户加密密钥 (AEK) 加密，该密钥使用 Key Vault 中的新密钥加密密钥 (KEK) 版本进行加密。
适用于已保存查询和日志搜索警报的客户管理的密钥
Log Analytics 中使用的查询语言可以实现丰富的表达，并且可以在注释中或查询语法中包含敏感信息。 某些组织要求将此类信息按照客户管理的密钥的策略进行保护，因此你需要保存使用密钥加密的查询。 使用 Azure Monitor，可以在链接到工作区时将使用密钥加密的已保存查询和日志搜索警报存储在自己的存储帐户中。
工作簿的客户管理的密钥
使用 Azure Monitor，可以在工作簿“保存”操作中选择“将内容保存到 Azure 存储帐户”时，将使用密钥加密的工作簿查询存储在自己的存储帐户中，但需留意所提及的有关用于已保存查询和日志搜索警报的客户管理的密钥的注意事项。
注意
在以下方案中，仍使用 Microsoft 密钥 (MMK) 对查询加密，而不考虑客户管理的密钥的配置：Azure 仪表板、Azure 逻辑应用、Azure Notebooks 和自动化 Runbook。
当链接到已保存查询的“存储帐户”后，服务会将已保存查询和日志搜索警报查询存储在存储帐户中。 掌握对存储帐户“encryption-at-rest 策略”的控制权后，可以使用客户管理的密钥来保护所保存的查询和日志搜索警报。 但需支付与该存储帐户相关的费用。
设置用于查询的客户管理的密钥之前需要注意的事项
- 需拥有对工作区和存储帐户的“写入”权限。
- 确保在 Log Analytics 工作区所在区域创建存储帐户，且使用客户管理的密钥加密。 这一点很重要，因为保存的查询将存储在表存储中，并且只能在创建存储帐户时对其进行加密。
- 保存在查询包中的查询不会使用客户管理的密钥进行加密。 请在保存查询时改为选择“另存为旧查询”，以使用客户管理的密钥对其进行保护。
- 存储中的保存查询被视为服务项目，并且其格式可能会发生变化。
- 链接用于查询的存储帐户将会从工作区中移除现有的保存查询。 复制你在此配置之前需要的保存查询。 可以使用 PowerShell 查看保存的查询。
- 链接存储帐户进行查询时，不支持查询“历史记录”和“固定到仪表板”。
- 你可以将单个存储帐户链接到同时用于所保存查询和日志搜索警报查询的工作区。
- 日志搜索警报将保存在 Blob 存储中，而且可以在创建存储帐户时或稍后配置客户管理的密钥加密。
- 触发的日志搜索警报将不会包含搜索结果或警报查询。 可以使用警报维度获取触发警报中的上下文。
为保存的查询配置 BYOS
为查询链接存储帐户以在你的存储帐户中保留已保存的查询。
完成配置后，所有新的已存搜索查询将保存在存储中。
为日志搜索警报查询配置 BYOS
链接警报的存储帐户，以在你的存储帐户中保留日志搜索警报查询。
完成配置后，所有新的日志警报查询将保存在存储中。
客户密码箱
通过密码箱，可以在支持请求期间批准或拒绝 Microsoft 工程师的数据访问请求。
密码箱在 Azure Monitor 的专用群集中提供，可在订阅级别授予访问数据的权限。
了解有关 Microsoft Azure 客户密码箱详细信息
客户管理的密钥的操作
客户管理的密钥在专用群集上提供，并且专用群集文章中引用了这些操作
- 获取资源组中的所有群集
- 获取订阅中的所有群集
- 更新群集中的容量预留
- 更新群集中的 billingType
- 从群集中取消与工作区的链接
- 删除群集
限制和约束
每个区域和订阅中最多可以创建两个活动群集。
每个区域和订阅中最多可以存在 7 个保留群集（活动或最近删除的群集）。
最多可以将 1,000 个 Log Analytics 工作区链接到一个群集。
在 30 天内最多允许对特定工作区进行两次工作区链接操作。
当前不支持将群集移到另一个资源组或订阅。
群集更新不应在同一操作中同时包含标识和密钥标识符详细信息。 如果两者都需要更新，则应在两次连续操作中进行更新。
当前不能在中国使用密码箱。
密码箱不适用于具有辅助计划的表。
对于受支持区域中自 2020 年 10 月开始创建的群集，系统会自动为其配置双重加密。 可以通过在群集上发送 GET 请求并观察启用了双重加密的群集的
isDoubleEncryptionEnabled值是否为true来验证是否为你的群集配置了双重加密。- 如果你创建群集并收到错误“区域名称不支持对群集进行双重加密。”，则你仍可通过在 REST 请求正文中添加
"properties": {"isDoubleEncryptionEnabled": false}来创建无双重加密的群集。 - 创建群集后，无法再更改双重加密设置。
- 如果你创建群集并收到错误“区域名称不支持对群集进行双重加密。”，则你仍可通过在 REST 请求正文中添加
客户管理的密钥的加密应用于在配置后新引入的数据。 在配置前引入的数据仍将使用 Microsoft 密钥进行加密。 你可以无缝查询在配置客户管理的密钥前后引入的数据。
Azure Key Vault 必须配置为可恢复。 默认情况下，这些属性不会启用，并且应使用 CLI 或 PowerShell 对其进行配置：
Azure Key Vault、群集和工作区必须位于同一区域和同一 Microsoft Entra 租户，但可以位于不同订阅。
如果将群集的
identitytype设置为None，还可撤销数据访问权，但不建议使用此方法，因为如果不联系支持人员就无法将其还原。 建议通过密钥吊销来撤销对你的数据的访问权限。如果密钥保管库位于专用链接 (vNet) 中，则不能将客户管理的密钥与用户分配的托管标识一起使用。 在这种情况下，可以使用系统分配的托管标识。
辅助表计划不支持客户管理的密钥。 具有辅助计划的表中的数据使用 Microsoft 管理的密钥进行加密，即使你使用自己的加密密钥保护 Log Analytics 工作区其余部分中的数据也是如此。
故障排除
依据 Key Vault 可用性的行为：
正常操作 — 存储会缓存 AEK 一小段时间，并返回 Key Vault 定期进行解包。
Key Vault 连接错误 -- 存储通过允许密钥在缓存中保留一段时间（保留时间与可用性问题的持续时间相同）来处理暂时性错误（超时、连接失败、DNS 问题），这可以克服暂时性的问题和可用性问题。 查询和引入功能将继续运行而不会中断。
Key Vault 访问速率（群集存储为实现包装和解包而访问 Key Vault 的频率）介于 6 到 60 秒之间。
如果在群集处于预配或更新状态时对其进行更新，则更新将失败。
如果在创建集群时遇到冲突错误，则具有相同名称的集群可能在过去 14 天内已被删除并保留。 删除的群集名称在删除后会保留 14 天。
如果工作区已链接到另一个群集，则将工作区链接到群集将失败。
如果创建群集并立即指定 KeyVaultProperties，操作可能会失败，除非为群集分配标识并向该标识授予对 Key Vault 的访问权限。
如果使用 KeyVaultProperties 更新现有的群集，并且 Key Vault 中缺少“Get”密钥访问策略，则该操作将失败。
如果无法部署群集，请验证 Azure Key Vault、群集和链接的工作区是否位于同一区域。 可以位于不同的订阅。
如果在 Key Vault 中轮换密钥，但未更新群集中的新密钥标识符详细信息，则群集将继续使用之前的密钥，并且数据将变得不可访问。 更新群集中的新密钥标识符详细信息以恢复数据引入和查询功能。 可以使用“''”更新密钥版本，让存储始终自动使用最新密钥版本。
部分操作较为耗时，可能需要一段时间才能完成，包括群集创建、群集密钥更新和群集删除。 可以通过将 GET 请求发送到群集或工作区来检查操作状态，并观察响应。 例如，未链接的工作区在“功能”下没有 clusterResourceId 。
错误消息
群集更新
- 400 - 群集处于正在删除状态。 正在执行异步操作。 群集必须完成其操作，才能执行任意更新操作。
- 400 - KeyVaultProperties 不为空，但格式错误。 请参阅密钥标识符更新。
- 400 - 无法验证 Key Vault 中的密钥。 可能是由于权限不足或密钥不存在。 验证是否在 Key Vault 中设置密钥和访问策略。
- 400 - 密钥不可恢复。 Key Vault 必须设置为“软删除”和“清除保护”。 请参阅 Key Vault 文档
- 400 - 现在无法执行操作。 等待异步操作完成，然后重试。
- 400 - 群集处于正在删除状态。 等待异步操作完成，然后重试。
群集获取
- 404 -- 找不到群集，群集可能已删除。 如果尝试使用该名称创建群集但发生冲突，则该群集正处于删除过程中。