创建 Azure Key Vault 凭据
Power Automate 中的凭据页面允许您使用 Azure Key Vault 创建、编辑和共享登录凭据,并在桌面流连接中使用。
重要提示
- 目前,这项功能不可用于美国政府云。
先决条件
凭据使用存储在 Azure Key Vault 中的密码。 若要允许您创建凭据,您的管理员需要首先配置 Azure Key Vault。
简而言之,管理员需要确保:
- Microsoft Power Platform 资源提供程序已在 Azure 订阅中注册。
- 有一个 Azure Key Vault,其中包含要在凭据中使用的密码。
- Dataverse 服务主体具有使用密码的权限。
- 创建环境变量的用户对 Azure Key Vault 资源拥有适当的权限。
- Power Automate 环境和 Azure 订阅必须在同一个租户上。
要配置 Azure Key Vault,请按照配置 Azure Key Vault 中描述的步骤操作。
创建凭据
要创建您的凭据:
- 转到凭据页面。
- 选择左侧导航中的更多,然后选择查找全部。
- 在数据下,选择凭据。 您可以将页面固定在左侧导航中,使其更易于访问。
在凭据页面中,您现在可以创建您的第一个凭据。
要创建您的凭据,您需要提供以下信息:
- 凭据名称:输入凭据的名称
- 描述(可选)
选择下一步后,您需要选择 Azure Key Vault 作为凭据存储。
在向导的最后一步,选择用户名和密码或创建新的用户名和密码:
-
用户名:选择用户名,您可以使用下拉功能。 如果您没有任何环境变量,请选择新建:
显示名称。 输入环境变量的名称。
Name。 唯一名称会自动从显示名称生成,但您可以更改它。
值。 填充用户的名称。 对于本地用户,请提供用户名。 对于域用户,请提供
<DOMAIN\username>
或<username@domain.com>
。
备注
Credential username 是一个文本环境变量。 您也可以从解决方案页面创建一个文本变量,并选择它作为用户名。
-
密码:要选择密码,您可以使用下拉菜单。 如果您没有任何密码环境变量,请选择新建:
- 显示名称。 输入环境变量的名称。
- Name。 唯一名称会自动从显示名称生成,但您可以更改它。
- 订阅 id。与密钥保管库关联的 Azure 订阅 ID。
- 资源组名称。 包含机密的密钥保管库所在的 Azure 资源组。
- Azure 密钥保管库名称。 包含机密的密钥保管库的名称。
- 密码名称。 Azure Key Vault 中机密的名称。
备注
订阅 ID、资源组名称和密钥保管库名称可在密钥保管库的 Azure 门户概览页上找到。 通过选择设置下的机密可以在 Azure 门户的密钥保管库页面上找到机密名称。 将在后台执行机密的用户访问验证。 如果用户没有最基本的读取权限,将显示此验证错误:“此变量未正确保存。 用户无权从“Azure Key Vault 路径”读取密码。密码使用密码环境变量。 您也可以从解决方案页面创建一个密码变量,并选择它作为密码。
使用凭据创建桌面流连接
注意:凭据目前仅在桌面流连接中受支持。
您现在可以在桌面流连接中使用您的凭据
查看密码的使用位置
从解决方案页面,您可以检索所有密码环境变量的依赖关系。 这有助于您在编辑 Azure Key Vault 密码之前了解它们的使用位置。
- 选择一个环境变量。
- 选择高级选项,然后选择显示依赖关系。
- 您可以看到:
- 使用此环境变量的凭据。
- 使用此环境变量的连接。
共享凭据
您可以与组织中的其他用户共享您拥有的凭据,并授予这些用户特定的访问权限。
- 登录到 Power Automate,然后转到凭据。
- 从凭据列表中选择您的凭据。
- 在命令栏上,选择共享。
- 选择添加人员,输入您组织中要与其共享凭据的人员的姓名,然后选择您要授予此用户的角色:
- 共同所有者(可以编辑)。 此访问级别授予该凭据完全权限。 共同所有者可以使用凭据、与其他人共享凭据、编辑凭据的详细信息以及删除凭据。
- 用户(只能查看)。 此访问级别仅授予使用凭据的权限。 此访问权限不支持编辑、共享或删除权限。
- 用户(可以查看和共享)。 此访问级别与只能查看选项相同,但授予共享权限。
- 选择保存。
备注
通过共享您的凭据,凭据中使用的所有环境变量也被共享。 删除凭据的权限不会删除环境变量的权限。
删除凭据
- 登录到 Power Automate,然后转到凭据。
- 从列表中选择要删除的凭据,然后选择命令栏上的删除机器。
备注
删除凭据不要删除关联的环境变量
使用凭据导出桌面流连接
备注
您应该首先阅读关于桌面流 ALM 的文章。
您可以使用凭据通过桌面流连接导出云端流。 您应该首先导入包含凭据和相关环境变量的解决方案,然后导入包含云端流和桌面流的解决方案。
限制
- 目前,此功能仅适用于桌面流连接。
- 在新设计器中创建凭据尚不可用。
- 您不能编辑现有凭据中的选定环境变量。 如果您想要更改用户名和密码的值,您需要更新环境变量或 Azure Key Vault 密码。
- 使用凭据更新连接是异步的。 更新密码后,桌面流连接可能需要一分钟的时间来使用新凭据。
更新密钥(密码轮换)- 已弃用
备注
本节现在已弃用。 所有使用凭据的连接现在都在流执行期间检索密码。 再不需要再创建该自定义流来更新连接。 应该更新使用 2024 年 4 月之前创建的凭据的连接,以受益于自动更新。
更新密钥(密码轮换)的必备条件
- 确保事件网格在 Azure 中注册为资源提供程序。 了解有关资源提供程序的更多信息。
- 确保在 Power Automate 中使用事件网格触发器的用户拥有事件网格参与者权限。 了解更多
备注
此部分需要特定权限,例如组织的系统管理员,否则只会更新您自己的桌面流连接。
使用 Event Grid 触发器创建云端流
当您在 Azure Key Vault 中编辑密码时,您希望确保使用这些密码的凭据和连接始终是最新的,以避免破坏您的自动化。 在 Power Automate 中,您需要创建一个云端流,当 Azure Key Vault 中的密码发生更改时,该云端流将更新凭据。
此云端流包含一个触发器和一项操作:
- 触发器:当资源事件发生时(事件网格)
- 资源类型:Microsoft.KeyVault.vaults
- 资源名称:提供密钥库的名称。
- 订阅:提供订阅的名称。
- 事件类型:Microsoft.KeyVault.SecretNewVersionCreated
- 操作:执行未绑定操作 (Dataverse)
- 操作名称:NotifyEnvironmentVariableSecretChange
- KeyVaultUrl:主题
- 密码名称:Subject
如果您使用一个密钥保管库来保存所有的密码,那么您只需要一个云端流。 如果您有几个密钥保管库,您需要复制云端流并更新资源名称。
要确保您的云端流与 Azure Key Vault 一起正常使用:
- 转至密钥保管库。
- 选择事件。
- 在活动订阅中,检查您是否能看到 LogicApps webhook。