.NET微服务安全实践：开发环境下的应用密钥安全存储-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01126/article/details/148548888

.NET微服务安全实践：开发环境下的应用密钥安全存储

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

前言

在现代应用开发中，安全性始终是重中之重。特别是在微服务架构中，应用通常需要处理各种敏感信息，如数据库连接字符串、API密钥、密码等。本文将深入探讨在.NET微服务开发过程中，如何安全地存储和管理这些应用密钥(secrets)，避免将它们直接暴露在源代码中。

为什么需要安全存储密钥？

在开发过程中，开发者经常需要处理以下类型的敏感信息：

数据库连接字符串
API密钥和访问令牌
加密密钥
服务账户凭证

将这些信息直接硬编码在源代码中会带来严重的安全风险，特别是当代码被提交到版本控制系统时。即使删除了相关代码，历史记录中仍可能保留这些敏感信息。

环境变量存储方案

基本原理

环境变量是存储开发环境密钥的一种简单有效的方式。这种方式将敏感信息与代码分离，使得密钥不会出现在源代码或版本控制系统中。

使用方法

在.NET应用中，可以通过以下方式使用环境变量：

设置环境变量（以Linux/macOS为例）：

export ConnectionStrings__Default="Server=myServer;Database=myDB;User=myUser;Password=myPassword;"

在应用中读取环境变量：

var builder = new ConfigurationBuilder()
    .AddEnvironmentVariables();
    
var configuration = builder.Build();
string connectionString = configuration["ConnectionStrings:Default"];

命名规范

当配置具有层次结构时，环境变量名称需要使用特定格式：

使用双下划线__作为分隔符（某些平台使用单下划线）
或者使用冒号:作为分隔符（在ASP.NET Core中更常见）

例如，对应以下JSON配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Debug"
    }
  }
}

环境变量应命名为：Logging:LogLevel:Default

优缺点分析

优点：

简单易用
与操作系统集成
适用于各种开发环境

缺点：

环境变量通常以明文形式存储
如果系统被入侵，环境变量容易被读取
缺乏版本控制和审计功能

ASP.NET Core密钥管理器(Secret Manager)

工具介绍

ASP.NET Core提供了一个专门的密钥管理工具——Secret Manager，它专门用于开发环境下的密钥存储。这个工具将密钥存储在用户配置文件目录下的JSON文件中，完全独立于项目代码。

配置步骤

添加必要的NuGet包引用：

<ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="x.x.x" />
</ItemGroup>

在项目文件中定义UserSecretsId：

<PropertyGroup>
    <UserSecretsId>your-unique-guid-here</UserSecretsId>
</PropertyGroup>

通过CLI工具管理密钥：

dotnet user-secrets set "ConnectionStrings:Default" "your_connection_string"

实际应用

在代码中访问这些密钥非常简单：

var builder = new ConfigurationBuilder()
    .AddUserSecrets<Startup>();
    
var configuration = builder.Build();
string connectionString = configuration["ConnectionStrings:Default"];

在ASP.NET Core应用中，通常会在Program.cs中使用默认构建器，它会自动包含开发环境下的用户密钥：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });