使用.Net核心的OAuth实现2.0，Swagger

基础概念

OAuth 2.0（开放授权）是一个开放标准，用于授权第三方应用访问用户在另一服务上存储的资源（如照片、视频、联系人列表等），而无需将用户名和密码提供给第三方应用。OAuth 2.0 提供了多种授权流程，以适应不同的使用场景。

Swagger（现称为 OpenAPI Specification）是一种用于描述、生成、消费和可视化 RESTful Web 服务的工具集。它允许开发者设计、构建、文档化和使用 RESTful API。

类型

OAuth 2.0 的授权类型包括：

授权码流程（Authorization Code Grant）：适用于有服务器端的应用。
隐式流程（Implicit Grant）：适用于客户端应用，如 JavaScript 应用。
资源所有者密码凭据流程（Resource Owner Password Credentials Grant）：适用于受信任的应用。
客户端凭据流程（Client Credentials Grant）：适用于没有用户参与的应用间通信。

应用场景

Web 应用：用户通过浏览器访问第三方应用，第三方应用通过 OAuth 2.0 获取授权码，然后获取访问令牌。
移动应用：用户通过移动应用登录，应用通过 OAuth 2.0 获取访问令牌。
单页应用（SPA）：通过隐式流程获取访问令牌。

示例代码

以下是一个使用 .NET Core 实现 OAuth 2.0 授权码流程的示例：

安装依赖

dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
dotnet add package Swashbuckle.AspNetCore

配置授权服务

public void ConfigureServices(IServiceCollection services)
{
    services.AddAuthentication(options =>
    {
        options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
        options.DefaultChallengeScheme = "OAuth2";
    })
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = Configuration["Jwt:Issuer"],
            ValidAudience = Configuration["Jwt:Audience"],
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration["Jwt:SecretKey"]))
        };
    })
    .AddOAuth("OAuth2", options =>
    {
        options.ClientId = Configuration["OAuth2:ClientId"];
        options.ClientSecret = Configuration["OAuth2:ClientSecret"];
        options.AuthorizationEndpoint = "https://authorization-server.com/oauth/authorize";
        options.TokenEndpoint = "https://authorization-server.com/oauth/token";
        options.UserInformationEndpoint = "https://authorization-server.com/userinfo";

        options.CallbackPath = new PathString("/signin-oauth2");
        options.SaveTokens = true;
    });

    services.AddControllers();
    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
    });
}

配置 Swagger

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseSwagger();
        app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1"));
    }

    app.UseRouting();

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

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}