ASP.NET Core优雅的在开发环境保存机密（User Secrets）
前言
在应用程序开发的过程中，有的时候需要在代码中保存一些机密的信息，比如加密密钥，字符串，或者是用户名密码等。通常的做法是保存到一个配置文件中，在以前我们会把他保存到web.config中，但是在ASP.NETCore中，这一方式或许发生了改变，或者说你有更多多元化的方法,以及更加优雅的的配置来设置或者保存这些机密资料。
起初我以为这个UserSecrets它并没有什么用，因为我有需要配置的地方我直接配置到appsetting.json文件中就可以了，直到一次开发过程中，我才感受到了它真正的用途。
目录
- 用户机密介绍
- 如何添加用户机密
- 在应用程序中使用用户机密
- 总结
用户机密介绍
有以下场景大家可以想一下在以前的代码中我们是怎么样处理的：
- 需要保存一些和第三方网站对接的密钥，比如和微信，微博站点使用的appkey
- 给每个开发人员配置不用的用户名密码来访问一些资源
- 开发人员在开发过程中使用各自本机的数据库，如何配置数据库地址、账号和密码
假设说最后一项，每个开发要使用自己本机的数据库，你可能会说让每个人修改自己的web.config，在提交代码的时候不提交就行了。那么如果在web.config添加其他配置项的时候，显然不提交web.config文件不合理的。
现在，ASP.NETCore提供了一种很优雅简洁的方式UserSecrets用来帮助我们解决这个事情。
在新建一个ASP.NETCoreWeb应用程序的时候，会在Startup.cs文件中看到这样一段代码：
publicStartup(IHostingEnvironmentenv)
{
.....
if(env.IsDevelopment())
{
builder.AddUserSecrets();
}
builder.AddEnvironmentVariables();
}
在project.json文件中，会看到UserSecrets相关的一些配置
{
"userSecretsId":"aspnet-WebAppCore-e278c40f-15bd-4c19-9662-541514f02f3e"
...
"Microsoft.Extensions.Configuration.UserSecrets":"1.0.0",
"Microsoft.Extensions.SecretManager.Tools":“1.0.0-preview2-final”
}
可以看到builder.AddUserSecrets这行代码，他是在开发环境才运行的。
userSecretsId是用来标识项目的UserSecrets唯一性的，如果有两个项目需要使用不同的Secrets，这就需要有不同的userSecretsId。
Microsoft.Extensions.SecretManager.Tools主要是用来设置或者查看secrets的值。
如何添加用户机密
可以在命令行中使用命令来添加：
image
- 切换命令行窗口到程序的运行目录，输入dotnetuser-secrets-h,来查看可以使用的命令
- 使用dotnetuser-secretslist列出所有的用户机密
- 使用dotnetuser-secretssetWeChatAppKey"X3423FEED2435DD"设置一个用户机密，其中WebChatAppKey为键，后面的是值。
- 然后使用dotnetuser-secretslist来查看设置的键值对。
- 然后我又设置了一个数据库的连接字符串进去。
以上是使用命令行的方式来设置用户机密，也可以使用VisualStudio2015代替命令行来做这项工作。
VisualStudio中，在Web项目上右键,可以看到一个管理用户机密的菜单：
image
点击打开时候，会出现一个secrets.json的文件，里面就是刚刚在命令行设置的键值对：
image
有些同学可能会问既然是存储到secrets.json，那么这个文件是在哪里呢？
secrets.json的存储位置？
在非Windows系统中，它的存储位置在
~/.microsoft/usersecrets/
在Windows系统中，它的位置在
C:\Users\用户名\AppData\Roaming\Microsoft\UserSecrets\aspnet-WebAppCore-e278c40f-15bd-4c19-9662-541514f02f3e
可以看到，存储的上层文件夹就是project.json文件中的userSecretsId设定的值。
在应用程序中使用用户机密
要在应用程序中访问配置的用户机密，你需要保证project.json文件中存在依赖项：
Microsoft.Extensions.Configuration.UserSecrets并且builder.AddUserSecrets()。
然后在Startup.cs文件中通过Configuration对象访问
publicIConfigurationRootConfiguration{get;}
publicvoidConfigureServices(IServiceCollectionservices)
{
varwechatKey=Configuration["WeChatAppKey"]
}
你可以使用DI来将用户机密映射到一个C#类文件，像这样
secrets.json
{
"SecretsKeys":
{
WeCharAppKey:"xxejfwert3045",
WeboAppKey:"35402345lkefgjlkdfg",
.....
}
}
SecretsKeysConfig.cs
publicclassSecretsKeysConfig
{
publicstringWeCharAppKey{get;set;}
publicstringWeboAppKey{get;set;}
//......
}
Startup.cs
publicvoidConfigureServices(IServiceCollectionservices)
{
services.Configure(Configuration.GetSection("SecretsKeys"));
//其他代码
}
HomeController.cs
publicclassHomeController:Controller
{
publicSecretsKeysConfigAppConfigs{get;}
publicHomeController(IOptionsappkeys)
{
AppConfigs=appkeys.Value;
}
}
注意：如果你的appsetting.json文件中有和secrets.json文件中相同节点（冲突）的配置项，那么就会被secrets.json中的设置项给覆盖掉，因为builder.AddUserSecrets()晚于AddJsonFile("appsettings.json")注册,那么我们可以利用这个特性来在每个开发人员的机器上重新设置数据库连接字符串了。
总结
以上，或许可以感受到微软在ASP.NETCore中对于开发人员还是非常贴心的，很多小细节都考虑到了，因此在我们构建应用程序的过程中，可以多使用这些小功能（特性）来让我们的代码更加的优雅～
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。