• 技术文章 >后端开发 >C#.Net教程

    分享ASP.NET Core在开发环境中保存机密(User Secrets)的实例

    零下一度零下一度2017-05-27 10:35:28原创1126

    这篇文章主要为大家详细介绍了ASP.NET Core如何优雅的在开发环境保存机密User Secrets,具有一定的参考价值,感兴趣的小伙伴们可以参考一下

    前言

    在应用程序开发的过程中,有的时候需要在代码中保存一些机密的信息,比如加密密钥,字符串,或者是用户名密码等。通常的做法是保存到一个配置文件中,在以前我们会把他保存到web.config中,但是在ASP.NET Core中,这一方式或许发生了改变,或者说你有更多多元化的方法, 以及更加优雅的的配置来设置或者保存这些机密资料。

    起初我以为这个UserSecrets它并没有什么用,因为我有需要配置的地方我直接配置到appsetting.json文件中就可以了,直到一次开发过程中,我才感受到了它真正的用途。

    目录

    用户机密介绍

    有以下场景大家可以想一下在以前的代码中我们是怎么样处理的:

    假设说最后一项,每个开发要使用自己本机的数据库,你可能会说让每个人修改自己的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

    以上是使用命令行的方式来设置用户机密,也可以使用 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 中对于开发人员还是非常贴心的,很多小细节都考虑到了,因此在我们构建应用程序的过程中,可以多使用这些小功能(特性)来让我们的代码更加的优雅~

    【相关推荐】

    1. ASP.NET免费视频教程

    2. 详细介绍ZKEACMS for .Net Core

    3. 在.net core 下如何进行http请求?

    4. 如何在ASP.NET Core中使用Cookie中间件的详细介绍

    5. .Net Core中如何使用ref和Span<T>提高程序性能的实现代码

    以上就是分享ASP.NET Core在开发环境中保存机密(User Secrets)的实例的详细内容,更多请关注php中文网其它相关文章!

    声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn核实处理。
    专题推荐:ASP.NET Core User Secrets
    上一篇:CentOS上运行ZKEACMS的实例教程 下一篇:自己动手写 PHP MVC 框架(40节精讲/巨细/新人进阶必看)

    相关文章推荐

    • C# 动态加载Dll• 从0自学C#04--特性和设计原则• ASP.NET使用Ajax如何返回Json对象的方法具体介绍• 【c#教程】C# 属性(Property)• asp.net 图片验证码的HtmlHelper
    1/1

    PHP中文网