ASP.NET 安全性框架（Security）快速入门指南

ASP.NET 安全性框架（Security）快速入门指南

Security[Archived] Middleware for security and authorization of web apps. Project moved to https://github.com/aspnet/AspNetCore项目地址:https://gitcode.com/gh_mirrors/se/Security

1. 项目目录结构及介绍

在 aspnet/Security 仓库中，主要的目录结构如下：

/src

此目录包含了 ASP.NET 安全性的核心源代码。各个子目录分别对应不同的安全特性，例如身份验证 (Authentication)、授权 (Authorization) 和其他相关组件。

/test

测试代码位于这个目录下，用于确保框架的正确性和稳定性。这里的单元测试和集成测试涵盖了各种场景。

/samples

示例应用代码存放在这里，提供了如何在实际项目中使用 ASP.NET Security 的实例。

/docs

包含了项目的文档资源，如 API 参考或开发者指南。

2. 项目的启动文件介绍

在 ASP.NET 应用程序中，启动文件通常是 Startup.cs。在这个文件中，你会看到 ConfigureServices 和 Configure 方法。这些方法被用来注册服务并设置应用程序的行为，包括安全性相关的配置。

• ConfigureServices(IServiceCollection services) 在这里，你可以添加安全相关的服务到依赖注入容器。比如：

  services.AddAuthentication("schemeName")
          .AddCookie("schemeName", options =>
          {
              // Cookie 配置
          });
  

• Configure(IApplicationBuilder app, IWebHostEnvironment env) 这个方法用来配置应用程序中间件，其中包括处理请求的管道。安全相关的中间件如身份验证和授权通常会在这个方法内设置：

  app.UseAuthentication();
  app.UseAuthorization();
  

3. 项目的配置文件介绍

ASP.NET Security 的配置通常通过 appsettings.json 或者环境变量进行。以下是一些常见的安全性相关配置项示例：

appsettings.json 示例：

{
  "Logging": {...},
  "AllowedHosts": "...",
  
  "Authentication": {
    "CookieOptions": {
      "CookieName": "MyAppAuthCookie",
      "ExpireTimeSpan": "08:00:00",
      "SlidingExpiration": true
    }
  },
  
  "Authorization": {
    "Policies": {
      "PolicyName": {
        "Requirements": [
          { "Type": "Microsoft.AspNetCore.Authorization.Policy.RequireAuthenticatedUser" }
        ]
      }
    }
  }
}

请注意，实际的配置选项取决于你使用的特定安全特性。例如，上述配置中的 CookieOptions 是对使用 cookie 身份验证时的参数设置。

为了在代码中访问这些配置，你可以使用 IConfiguration 对象，它可以从依赖注入容器中获取：

public class Startup
{
    private readonly IConfiguration _config;

    public Startup(IConfiguration config)
    {
        _config = config;
    }

    // 使用配置对象来读取设置
    public void ConfigureServices(IServiceCollection services)
    {
        var authCookieOptions = _config.GetSection("Authentication:CookieOptions");
        // ...
    }
}

这就是 ASP.NET Security 框架的基本目录结构、启动文件和配置文件简介。结合源代码和示例，你将能够更好地理解并开始使用这个强大的安全性框架。

Security[Archived] Middleware for security and authorization of web apps. Project moved to https://github.com/aspnet/AspNetCore项目地址:https://gitcode.com/gh_mirrors/se/Security