【问题标题】:Swagger UI authorization not sending the tokenSwagger UI 授权不发送令牌
【发布时间】:2021-06-25 22:16:27
【问题描述】:

我是 Swagger 的新手。我正在使用 OpenAPI 3.0.2。

当我运行 Swagger UI 时,顶部和每个 API 都会出现授权按钮,但它们不起作用。当我单击它们时,我可以在 apiKey 框中输入任何文本,它接受它并说我已获得授权。但是没有 API 有效,它们都返回 401

这里是Startup.ConfigureServices中的相关代码

services.AddAuthentication(
        x =>
        {
            x.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
            x.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
        }
    )
    .AddJwtBearer(
        x =>
        {
            x.RequireHttpsMetadata = false;
            x.SaveToken = true;
            x.TokenValidationParameters = new TokenValidationParameters
            {
                ValidateIssuer = false,
                ValidateAudience = false,
                ValidateIssuerSigningKey = true,
                IssuerSigningKey = new SymmetricSecurityKey(key),
                ValidIssuer = Configuration["Tokens:Issuer"],
                ValidAudience = Configuration["Tokens:Audience"],
            };
        }
    );
services.AddSwaggerGen(
    setupAction =>
    {
        setupAction.SwaggerDoc(
            "LibraryOpenApiSpecification",
            new Microsoft.OpenApi.Models.OpenApiInfo()
            {
                Title = "Library API",
                Version = "2.0",
                Description = "Text",

                Contact = new Microsoft.OpenApi.Models.OpenApiContact()
                {
                    Email = "me@google.com",
                    Name = "user1",
                    Url = new Uri("http://www.google.com")
                }
            }
        );

        setupAction.AddSecurityDefinition(
            "Bearer",
            new OpenApiSecurityScheme
            {
                Name = "Authorization",
                Type = SecuritySchemeType.ApiKey,
                Scheme = "Bearer",
                BearerFormat = "JWT",
                In = ParameterLocation.Header,
                Description = "JWT Authorization header using the Bearer scheme."
            }
        );


        setupAction.AddSecurityRequirement(
            new OpenApiSecurityRequirement
            {
                {
                    new OpenApiSecurityScheme
                    {
                        Reference = new OpenApiReference
                        {
                            Type = ReferenceType.SecurityScheme,
                            Id = "Bearer"
                        }
                    },
                    new string[] { }
                }
            }
        );


        var xmlCommentsFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
        var xmlCommentFullPath = Path.Combine(AppContext.BaseDirectory, xmlCommentsFile);
        setupAction.IncludeXmlComments(xmlCommentFullPath);
    }
);

代码不是我的,是由另一个开发人员带来的。 如果需要,我会提供更多代码和信息

【问题讨论】:

  • 尝试在 AddSecurityDefinition 方法中将 Type 更改为 Type = SecuritySchemeType.Http
  • 谢谢。我只是这样做了,但没有改变

标签: asp.net-core swagger swagger-ui swashbuckle.aspnetcore


【解决方案1】:

这是一个工作示例:

services.AddSwaggerGen(
    c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "ApiPlayground", Version = "v1" });
        c.AddSecurityDefinition(
            "token",
            new OpenApiSecurityScheme
            {
                Type = SecuritySchemeType.Http,
                BearerFormat = "JWT",
                Scheme = "Bearer",
                In = ParameterLocation.Header,
                Name = HeaderNames.Authorization
            }
        );
        c.AddSecurityRequirement(
            new OpenApiSecurityRequirement
            {
                {
                    new OpenApiSecurityScheme
                    {
                        Reference = new OpenApiReference
                        {
                            Type = ReferenceType.SecurityScheme,
                            Id = "token"
                        },
                    },
                    Array.Empty<string>()
                }
            }
        );
    }
);

配置完成后,Swagger UI 会为您提供一个按钮进行身份验证

一旦您填写输入令牌并发送请求,它将在Authorization 标头中发送。

现在,应用程序必须为每个请求解析并验证此令牌,因此您必须在 Startup.Configure 方法中启用身份验证中间件。

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

那么如果令牌通过验证,您应该可以使用HttpContext.User 属性访问用户。

如果您仍然收到 401 错误,则表明令牌验证存在问题,请检查您是否在 Startup.Configure 方法中配置了授权服务:

services.AddAuthorization(
    options => options.FallbackPolicy = new AuthorizationPolicyBuilder()
        .RequireAuthenticatedUser()
        .AddAuthenticationSchemes(JwtBearerDefaults.AuthenticationScheme).Build()
);

这将要求所有请求进行身份验证,除非使用[Authorize](或[AllowAnonymous])属性设置了另一个授权策略。这将确保令牌被解析和验证。

这是一个对令牌进行签名和验证的端到端 API。

internal class HardCodedConfiguration
{
    public static SymmetricSecurityKey SigningKey = new SymmetricSecurityKey(
        Encoding.UTF8.GetBytes(
            "alongrandomstringhere.11b48736983e87c5cff022c462849ca5b7c5e99b76d81e9707fa35e76024cba8"
        )
    );

    public static SigningCredentials SigningCredentials => new SigningCredentials(
        SigningKey,
        SecurityAlgorithms.HmacSha256
    );
}

[ApiController]
[Route("")]
public class HelloController : ControllerBase
{
    [AllowAnonymous]
    [HttpGet("token")]
    public ActionResult SignToken()
    {
        var token = new JwtSecurityTokenHandler().WriteToken(
            new JwtSecurityToken(
                claims: new List<Claim>()
                {
                    new Claim("name", "abdusco")
                },
                expires:DateTime.Now.AddHours(1),
                signingCredentials: HardCodedConfiguration.SigningCredentials
            )
        );
        return Ok(token);
    }

    [HttpGet]
    public IActionResult AuthorizedEndpoint()
    {
        return Ok(User.Claims.Select(c => new { c.Type, c.Value }).ToList());
    }
}

// inside Startup class
public void ConfigureServices(IServiceCollection services)
{
    // swagger configuration
    // ...
    services.AddControllers();
    services.AddAuthorization(
        options => options.FallbackPolicy = new AuthorizationPolicyBuilder()
            .RequireAuthenticatedUser()
            .AddAuthenticationSchemes(JwtBearerDefaults.AuthenticationScheme).Build()
    );
    services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddJwtBearer(
            o =>
            {
                o.TokenValidationParameters = new TokenValidationParameters
                {
                    ValidateIssuer = false,
                    ValidateAudience = false,
                    IssuerSigningKey = HardCodedConfiguration.SigningKey,
                };
            }
        );
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();

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

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

【讨论】:

  • 仍然不起作用这里有一些细节: 1)首先我不确定我在我的 OP 中是否清楚。这里至少有2个问题。第一个问题是授权按钮接受任何令牌,即使我在 appsettings.json 中定义了一个。 2)我不得不对你的代码进行一些更改,因为我在运行它时遇到了错误。我在 OP 3 中用我的 SwaggerDoc 替换了您的 SwaggerDoc)API 仍然不起作用。我按照您的指示将级别更改为调试。我将在我的下一条评论中显示控制台消息,因为该消息已达到其字符限制
  • 这里是控制台消息:Microsoft.AspNetCore.Authorization.DefaultAuthorizationService:信息:授权失败。未满足这些要求: DenyAnonymousAuthorizationRequirement:需要经过身份验证的用户。 Microsoft.AspNetCore.Authentication.JwtBearer.JwtBearerHandler:信息:AuthenticationScheme:Bearer 被质询。
  • 那个按钮不做任何验证。它只是将令牌转发到 API。关于日志消息,我知道出了什么问题。我会在几秒钟内更新答案
  • 我添加了你的方法,但还是不行。我收到了相同的控制台消息。忘了告诉我有 app.UseAuthentication(); app.UseAuthorization();已经
  • services.AddAuthorization 怎么样?
猜你喜欢
  • 2020-08-19
  • 2022-11-24
  • 2019-05-11
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2018-03-28
  • 1970-01-01
  • 2022-11-08
相关资源
最近更新 更多