ASP.NET Core优雅的在开发环境保存机密（User Secrets）
更新时间：2017年05月25日 11:52:50 作者：Savorboard
这篇文章主要为大家详细介绍了ASP.NET Core如何优雅的在开发环境保存机密User Secrets，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
前言
在应用程序开发的过程中，有的时候需要在代码中保存一些机密的信息，比如加密密钥，字符串，或者是用户名密码等。通常的做法是保存到一个配置文件中，在以前我们会把他保存到web.config中，但是在ASP.NET Core中，这一方式或许发生了改变，或者说你有更多多元化的方法, 以及更加优雅的的配置来设置或者保存这些机密资料。
起初我以为这个UserSecrets它并没有什么用，因为我有需要配置的地方我直接配置到appsetting.json文件中就可以了，直到一次开发过程中，我才感受到了它真正的用途。
目录
用户机密介绍
如何添加用户机密
在应用程序中使用用户机密
总结
用户机密介绍
有以下场景大家可以想一下在以前的代码中我们是怎么样处理的：
需要保存一些和第三方网站对接的密钥，比如和 微信，微博站点使用的 appkey
给每个开发人员配置不用的用户名密码来访问一些资源
开发人员在开发过程中使用各自本机的数据库，如何配置数据库地址、账号和密码
假设说最后一项，每个开发要使用自己本机的数据库，你可能会说让每个人修改自己的web.config，在提交代码的时候不提交就行了。那么如果在web.config添加其他配置项的时候，显然不提交web.config文件不合理的。
现在，ASP.NET Core 提供了一种很优雅简洁的方式 User Secrets 用来帮助我们解决这个事情。
在新建一个 ASP.NET Core Web 应用程序的时候，会在 Startup.cs 文件中看到这样一段代码：
public Startup(IHostingEnvironment env)
{
…..
if (env.IsDevelopment())
{
builder.AddUserSecrets();
}
builder.AddEnvironmentVariables();
}
在 project.json 文件中，会看到 User Secrets 相关的一些配置
{
“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是用来标识项目的User Secrets唯一性的，如果有两个项目需要使用不同的Secrets ，这就需要有不同的userSecretsId。
Microsoft.Extensions.SecretManager.Tools 主要是用来设置或者查看secrets的值。
如何添加用户机密
可以在命令行中使用命令来添加：
image
切换命令行窗口到程序的运行目录， 输入 dotnet user-secrets -h ,来查看可以使用的命令
使用 dotnet user-secrets list 列出所有的用户机密
使用 dotnet user-secrets set WeChatAppKey “X3423FEED2435DD”设置一个用户机密，其中 WebChatAppKey 为键，后面的是值。
然后使用dotnet user-secrets list来查看设置的键值对。
然后我又设置了一个数据库的连接字符串进去。
以上是使用命令行的方式来设置用户机密，也可以使用 Visual Studio 2015代替命令行来做这项工作。
Visual Studio中，在Web项目上右键,可以看到一个 管理用户机密 的菜单：
image
点击打开时候，会出现一个secrets.json的文件，里面就是刚刚在命令行设置的键值对：
image
有些同学可能会问既然是存储到secrets.json，那么这个文件是在哪里呢？
secrets.json的存储位置？
在非Windows系统中，它的存储位置在
~/.microsoft/usersecrets/<userSecretsId>/secrets.json
在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 对象访问
public IConfigurationRoot Configuration { get; }
public void ConfigureServices(IServiceCollection services)
{
var wechatKey = Configuration[“WeChatAppKey”]
}
你可以使用DI来将用户机密映射到一个C#类文件，像这样
secrets.json
{
“SecretsKeys”:
{
WeCharAppKey:”xxejfwert3045″,
WeboAppKey:”35402345lkefgjlkdfg”,
…..
}
}
SecretsKeysConfig.cs
public class SecretsKeysConfig
{
public string WeCharAppKey { get; set;}
public string WeboAppKey { get; set;}
// ……
}
Startup.cs
public void ConfigureServices(IServiceCollection services)
{
services.Configure<SecretsKeysConfig>(Configuration.GetSection(“SecretsKeys”));
// 其他代码
}
HomeController.cs
public class HomeController : Controller
{
public SecretsKeysConfig AppConfigs { get; }
public HomeController(IOptions<SecretsKeysConfig> appkeys)
{
AppConfigs = appkeys.Value;
}
}
注意：如果你的appsetting.json文件中有和secrets.json文件中相同节点（冲突）的配置项，那么就会被secrets.json中的设置项给覆盖掉，因为 builder.AddUserSecrets()晚于 AddJsonFile(“appsettings.json”)注册, 那么我们可以利用这个特性来在每个开发人员的机器上重新设置数据库连接字符串了。
总结
以上，或许可以感受到微软在 ASP.NET Core 中对于开发人员还是非常贴心的，很多小细节都考虑到了，因此在我们构建应用程序的过程中，可以多使用这些小功能（特性）来让我们的代码更加的优雅～
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持华域联盟。
您可能感兴趣的文章:.Net Core3 用Windows 桌面应用开发Asp.Net Core网站ASP.NET Core应用错误处理之DeveloperExceptionPageMiddleware中间件呈现“开发者异常页面”Asp.Net Core利用文件监视进行快速测试开发详解ASP.NET Core开发教程之Logging利用NLog写日志文件Visual Studio 2017 ASP.NET Core开发VS2015 搭建Asp.net core开发环境的方法[Asp.Net Core]提高开发效率的方法
ASP.NET
Core
User
Secrets
相关文章
阿里云上从ASP.NET线程角度对“黑色30秒”问题的全新分析在这篇博文中，我们抛开对阿里云的怀疑，完全从ASP.NET的角度进行分析，看能不能找到针对问题现象的更合理的解释 2015-09-09
详解Func<T>与Action<T>区别本文主要介绍Func<T>和Action<T>的用法以及他们之间的区别，希望对大家有所帮助 2016-11-11
Linux(Ubuntu)下搭建ASP.NET Core环境本文给大家介绍的是无需安装mono，在Linux(Ubuntu14.04.4 LTS)下搭建ASP.NET Core环境 继续.NET跨平台，希望对大家能够有所帮助。 2016-07-07
ASP.NET Web.config配置文件详解这篇文章主要为大家详细介绍了ASP.NET Web.config配置文件，教大家如何配置Web.config文件，具有一定的参考价值，感兴趣的小伙伴们可以参考一下 2017-01-01
基于.NET中建构子中传递子对象的对象详解本篇文章介绍了，基于.NET中建构子中传递子对象的对象详解。需要的朋友参考下 2013-05-05
CorFlags.exe检查.NET程序平台目标(Platform Target)的工具.NET Framework SDK中的一个工具程序: CorFlags.exe。CorFlags.exe不但可查询.NET组件的平台目标设定，甚至能直接修改设定，省去重新编译的工夫。 2013-02-02
ASP.NET Core使用GraphQL第一章之Hello World这篇文章主要给大家介绍了关于ASP.NET Core使用GraphQL第一章之Hello World的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧 2018-11-11
CodeFirst从零开始搭建Asp.Net Core2.0网站这篇文章主要为大家详细介绍了CodeFirst从零开始搭建Asp.Net Core2.0网站的详细过程，具有一定的参考价值，感兴趣的小伙伴们可以参考一下 2017-07-07
Visual Studio 2017通过SSH调试Linux上.NET Core这篇文章主要为大家详细介绍了Visual Studio 2017通过SSH调试Linux 上.NET Core的相关资料，具有一定的参考价值，感兴趣的小伙伴们可以参考一下 2017-03-03
把程序集安装到全局程序集缓存中的步骤最近两天在看网络编程中制作简单的http服务器，其中用到把程序集安装到全局程序集缓存中，自己尝试了一下，记录一下：（首先，对共享程序集安装计算机管理员权限） 2008-11-11
最新评论
评论(0)