文章出處

問題

如何在ASP.NET Core 2.0中保存機密配置項(不用將其暴露給源代碼管理器)?

答案

創建一個ASP.NET Core 2.0空項目,在項目節點上點擊右鍵,并點擊菜單項 - 管理用戶機密:

這將會打開secrets.json文件,添加配置鍵值對:

{
  "UserPassword": "Password1"
}

 為此配置項添加POCO類:

public class SecretSettings
{
	public string UserPassword { get; set; }
} 

使用之前創建的HelloWorldMiddleware中間件,將IOptions<T>作為中間件的構造函數參數注入,其中T就是我們剛剛定義的POCO類:

public class HelloWorldMiddleware
{
	private readonly RequestDelegate _next;
	private readonly SecretSettings _settings;

	public HelloWorldMiddleware(RequestDelegate next, IOptions<SecretSettings> options)
	{
		_next = next;
		_settings = options.Value;
	}

	public async Task Invoke(HttpContext context)
	{
		var jsonSettings = JsonConvert.SerializeObject(_settings, Formatting.Indented);
		await context.Response.WriteAsync(jsonSettings);
	}
}


public static class UseHelloWorldInClassExtensions
{
	public static IApplicationBuilder UseHelloWorld(this IApplicationBuilder app)
	{
		return app.UseMiddleware<HelloWorldMiddleware>();
	}
}  

在Startup.cs中,我們需要做如下幾件事:

1. 通過構造函數參數注入IConfiguration

2. 在ConfigureServices()中添加Options服務,并添加機密配置的依賴項

3. 在Configure()方法中使用中間件

public class Startup
{
	public static IConfiguration Configuration { get; private set; }

	public Startup(IConfiguration configuration)
	{
		Configuration = configuration;
	}
	
	public void ConfigureServices(IServiceCollection services)
	{
		services.AddOptions();

		services.Configure<SecretSettings>(Configuration);
	}

	
	public void Configure(IApplicationBuilder app, IHostingEnvironment env)
	{
		app.UseHelloWorld();
	}
}  

運行,此時頁面顯示:

 

討論

之前我們討論過如何在配置文件中存儲全局配置項。然而,這些配置文件會被簽入源代碼管理器,因此不適合用于保存機密配置。在生產環境中,這些配置可以保存到環境變量或者Azure云的密鑰存儲庫中 。對于開發環境,ASP.NET Core 2.0提供了可選的解決方案:用戶機密管理器。

用戶機密管理器允許開發人員將機密信息保存到secrets.json文件中,而不會簽入到源代碼管理器。secrets.json文本被保存到系統的AppData目錄中,在VS2017中你可以將鼠標移動到相應的選項卡上查看文件路徑。需要注意的一點:機密信息是被保存在普通文本文件中的。這些文件是在創建WebHost時由運行時讀取并加載的。

 

====start by sanshi=========================

你可能也注意到了用戶機密文件路徑中的那個類似GUID的字符串了,它是由VS 2017自動創建的,并存在工程文件中(SecretConfiguration.csproj):

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp2.0</TargetFramework>
    <UserSecretsId>2d08d295-6b15-46b3-a5a3-ad0b1992f492</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.0" />
  </ItemGroup>

</Project>

====end by sanshi=========================

CLI

我們也可以使用命令行界面(CLI)的指令 dotnet user-secrets 來管理機密信息。為此,我們需要首先想工程文件中添加如下配置:

<ItemGroup>
	<DotNetCliToolReference Include="Microsoft.Extensions.SecretManager.Tools" Version="2.0.0" />
</ItemGroup>  

 接下來,我們就可以使用如下命令來管理用戶機密信息:

1. list:列出所有的機密信息,例如:dotnet user-secrets list

2. set:添加或更新某個機密項,例如:dotnet user-secrets set SecretSetting “SecretValue”

3. remove:刪除某個機密項,例如:dotnet user-secrets remove SecretSetting

4. clear:清空所有機密項,例如:dotnet user-secrets clear

====start by sanshi=========================

下面,我們會簡單演示這一過程,首先打開命令行窗體(Windows+X),并定位到項目所在目錄:

cd C:\Users\sanshi\Desktop\ASP.NET_Core_20_Articles\SecretConfiguration\SecretConfiguration

然后鍵入如下命令:

dotnet user-secrets list  

運行結果:

下面來修改這個機密項:

dotnet user-secrets set UserPassword "My New Password"

在VS中打開機密文件,發現已經修改成功:

{
  "UserPassword": "My New Password"
}

====end by sanshi=========================

 

源代碼下載

 

原文:https://tahirnaushad.com/2017/08/31/asp-net-core-2-0-secret-manager/


文章列表


不含病毒。www.avast.com
arrow
arrow
    全站熱搜
    創作者介紹
    創作者 大師兄 的頭像
    大師兄

    IT工程師數位筆記本

    大師兄 發表在 痞客邦 留言(0) 人氣()