密钥管理(Secret Management)简介
应用程序通常会通过使用专用的密钥存储来秘密存储敏感信息,常见示例包括:
包含用户名和密码的数据库连接字符串。
用于调用外部 Web API 的 API 密钥。
用于对外部系统进行身份验证的客户端证书/令牌。
温馨提示:必须谨慎管理机密,以免在应用程序之外泄露。
传统的做法是 将应用程序机密存储在应用程序代码库内的配置文件中, .NET 开发人员一想到 web.config 文件就会很亲切。 虽然实现起来很简单,但 将机密与代码集成在一起并不安全。 常见的错误是在推送到公共 GIT 存储库时包含该文件,导致机密泄露。
【十二要素(The Twelve Factors)应用】是一种被广泛认可的用于构建新式分布式应用程序的方法。 其中介绍了一系列原则和最佳做法。 第三个要素规定配置和机密要存储在代码库外部。
通常这需要建立一个 密钥存储,如 Azure Key Vault、Hashicorp Vault 和其他仓库等机密管理工具中隔离机密(并在那里存储应用程序级别的密钥)。 可通过这些工具将机密存储在外部、在不同环境中使用不同的凭据,并且通过应用程序代码引用它们。 不过,每款工具都不简单,而且需要学习(增加相应的学习成本)。
要访问这些密钥存储,应用程序需要导入相应的密钥存储 SDK,并使用它访问这些密钥。 这可能需要相当数量的模板代码,这些代码与应用的实际业务领域无关,因此在多云场景中,可能会使用不同厂商特定的密钥存储,这就成为一个更大的挑战。
Dapr 的密钥管理
Dapr 提供了简化机密管理的构建基块。让开发人员在任何地方更容易消耗应用程序密钥, Dapr 有一个专用的密钥构建块 API ,允许开发人员从一个密钥存储获得密钥。
密钥管理的优点
通过 Dapr 机密管理构建基块,可轻松地使用机密和机密管理工具。
它通过统一的接口隐藏基础管道。
它支持各种可插入的机密存储组件,这些组件在开发环境和生产环境中可能有所不同。
应用程序不需要直接依赖于机密存储库(应用程序和密钥存储分离)。
开发人员无需详细了解每个机密存储。
密钥管理的应用
使用 Dapr 的密钥存储构建块通常涉及以下内容:
设置一个特定的密钥存储解决方案的组件。
在应用程序代码中使用 Dapr 密钥 API 获取密钥。
[可选] 在 Dapr 组件文件中引用密钥。
密钥管理的工作原理
应用程序通过两种方式使用机密管理构建基块:
直接从构建基块 API 检索查询机密。
从 Dapr 组件配置中间接引用机密。
应用程序代码可以调用密钥构建块 API,从 Dapr 支持的密钥存储中检索密钥,并可以在您的代码中使用。
例如,下图显示了一个应用程序从配置的云密钥存储中请求名为 “mysecret“ 的密钥存储 “vault”。
应用程序可以使用密钥 API 访问 Kubernetes 密钥存储的秘密。 在下面的示例中,应用程序会从 Kubernetes 密钥存储检索相同的密钥 “mysecret”。
组件配置路径:
C:\Users<username>.dapr\components
更多密钥管理支持的组件,请查看:
Secret stores =》https://docs.dapr.io/reference/components-reference/supported-secret-stores/
密钥管理 API
使用机密管理构建基块时,应用程序会与 Dapr Sidecar 进行交互。 Sidecar 会公开机密 API。 可使用 HTTP 或 gRPC 调用 API。
【调用 Endport 】
使用以下 URL 调用 HTTP API(GET 请求)
URL 字段说明:
< dapr-port > 指定 Dapr Sidecar 正在侦听的端口号。
< store-name > 指定 Dapr 机密存储的名称。
< name > 指定要检索的机密的名称。
< metadata > [可选]提供机密的其他信息。
元数据属性因机密存储而异。 有关元数据属性的详细信息,请查看 [机密 API 参考](机密 API 参考 | Dapr Docs)。
【响应状态码】
- 【构建块 Secret API 】
在 Dapr Sidecar 中的构建块 Secret API 接口信息(由于 daprd 是 go 语言编写的,因此下面提供 go 语言的接口信息):
在 .NET 中使用 Secret(机密)
此处使用 secretstores.local.file 类型来演示。
直接从构建基块 API 检索查询 Secret
添加 secrets01.json 文件
在 FrontEnd 项目中新增文件夹 Secrets ,并添加 secrets01.json 文件,在该文件中新增如下配置信息:
在 appsettings.json 文件中添加如下配置
此处只举例 RabbitMQ 的连接,其他类似,可自行扩展;
新增 DaprSecretManagementController
在 FrontEnd 项目中新增 DaprSecretManagementController API ,通过 API 方式获取 Secret 在应用程序中使用,添加如下代码:
浏览器查看 Swagger 页面,操作 API 输出如下信息:
curl 调用单个获取 Secret 的 api
输出信息如下:
从 Dapr 组件配置中间接引用 Secret
继续拿上一篇 Dapr for dotnet | 绑定 - Input/Output Bindings 中的输入/输出绑定举例,在前面的 yaml 配置中 rabbitmq 的连接字符串是包含铭感信息(amqp://mqtest:test123@192.168.30.71:5672),此处改造如下:
修改 Input/Output Bindings 的 yaml 配置文件
分别修改 rabbitmq-input-binding.yaml 和 rabbitmq-output-binding.yaml 文件中的的配置,修改信息如下:
rabbitmq-input-binding.yaml
在 host 的 value 修改添加 secretKeyRef ;
添加授权 auth.secretStore;
密钥(Secret)作用域 / 访问权限限制
一旦配置完毕,默认情况下任何该仓库内定义的密钥(Secret)都可以从 Dapr 应用程序访问。
要限制 Dapr 应用程序访问密钥(Secret)的话, 您可以通过向应用程序配置添加密钥作用域政策并限制权限来定义密钥作用域。
如何使用秘钥的作用域限定访问 =》https://docs.dapr.io/developing-applications/building-blocks/secrets/secrets-scopes/
修改 config.yaml 权限配置
想要恢复 RabbitMQ 绑定的可访问性,可以修改 defaultAccess: allow 然后(dapr run)重启 frontend 服务器即可。
注意:先检查 RabbitMQ 服务是否开启,可用浏览器查看管理页面。
参考文章推荐:
Secrets management overview =》https://docs.dapr.io/developing-applications/building-blocks/secrets/secrets-overview/
Secrets API reference =》https://docs.dapr.io/reference/api/secrets_api/
How To: Use secret scoping =》https://docs.dapr.io/developing-applications/building-blocks/secrets/secrets-scopes/
How To: Retrieve a secret =》https://docs.dapr.io/developing-applications/building-blocks/secrets/howto-secrets/
Secret stores =》https://docs.dapr.io/reference/components-reference/supported-secret-stores/
面向 .NET 开发人员的 Dapr | Dapr 机密管理构建基块 =》https://docs.microsoft.com/zh-cn/dotnet/architecture/dapr-for-net-developers/secrets-management
————————————————
版权声明:本文为CSDN博主「ChaITSimpleLove」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/ChaITSimpleLove/article/details/124251052