SuperAPI AI 工具集

dotnet-secrets-management

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 .NET 应用提供与云平台无关的密钥和敏感配置管理,覆盖从本地开发到生产环境的完整生命周期,并给出应避免的反模式。

主要能力:本地开发使用用户机密(dotnet user-secrets CLI,secrets.json 存放在仓库之外);生产使用环境变量,通过双下划线 __ 映射配置节,可加前缀避免冲突;用 IConfiguration 绑定到强类型 Options 类并配合数据注解校验;支持密钥轮换策略,如 IOptionsMonitor 运行时重载、双密钥验证窗口;推荐生产使用托管标识实现无密码认证。

使用方式:初始化并设置用户机密可执行 dotnet user-secrets init、dotnet user-secrets set "ConnectionStrings:DefaultDb" "..."、dotnet user-secrets list、dotnet user-secrets remove、dotnet user-secrets clear。环境变量示例:export ConnectionStrings__DefaultDb="...",代码中通过 builder.Configuration 读取。Options 注册使用 AddOptions<T>().BindConfiguration(...).ValidateDataAnnotations().ValidateOnStart()。

适用场景:.NET 8.0+ 的 Web、控制台与 Worker 服务;本地开发、CI/CD、预发与生产环境;容器环境通过环境变量或挂载密钥注入。

限制:用户机密未加密,仅适用于开发;环境变量对同一用户下所有进程可见,多租户容器应使用容器级隔离;云厂商专用密钥库(Azure Key Vault、AWS Secrets Manager、GCP Secret Manager)、认证授权实现、加密算法选择、通用 Options 模式与配置源优先级均不在本技能范围内。Options 类必须使用 { get; set; } 而非 init,否则绑定器无法赋值。