授权标头未显示在 CURL springdoc-openapi-ui 中

Question

我正在使用springdoc-openapi-ui. 我已经配置了名为 的全局标头Authorization。当我执行 API 时，Authorization请求的 CURL 中没有显示。除了 之外，我的其他参数都显示在 CURL 中Authorization。

以前，我使用的是springfox-swagger-ui，当时它显示在 CURL 部分中。

我搜索了相同的内容并在https://swagger.io/docs/specification/describing-parameters/#header-parameters上找到了注释 Note: Header parameters named Accept, Content-Type and Authorization are not allowed.

但我的要求仅用Authorization作标题。我们有什么办法可以实现这一目标吗？

我SwaggerConfiguration的添加在下面。

@Configuration
public class SwaggerConfiguration {

    @Value("${title:title}")
    private String title;
    @Value("${description:description.}")
    private String description;
    @Value("${version:0.0.1}")
    private String version;

    @Value("${schemeId}")
    String schemeIdentifier;

    @Bean
    public OperationCustomizer customGlobalHeaders() {

        return (Operation operation, HandlerMethod handlerMethod) -> {

            Parameter authorization = new Parameter().in(ParameterIn.HEADER.toString()).name("Authorization")
                    .description("Authorization details JWT token")
                    .schema(new StringSchema()).required(true);

            Parameter applicationId = new Parameter().in(ParameterIn.HEADER.toString()).schema(new StringSchema())
                    .name("Application-Id").description("Originating application or client using the service")
                    .required(false);

            operation.addParametersItem(authorization);
            operation.addParametersItem(applicationId);

            return operation;
        };
    }

    @Bean
    public GroupedOpenApi adminApi() {      

        String[] packagesToscan = { "abc.controller" };

        return GroupedOpenApi.builder().setGroup("Client").packagesToScan(packagesToscan).build();
    }

    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI().info(new Info().title(title).version(version).description(description))
                .components(new Components());
    }
}

Answer 1

我已经寻找过同样的答案。
我们无法将 Authorization 设置为springdoc open api. 如果我们想使用，那么我们需要启用 上的授权按钮swagger ui。

然后它将显示在 CURL 部分，如下所示。

在全球位置启用 swagger 上的授权按钮的代码

@Configuration
public class SwaggerConfiguration {

    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI().info(new 
             Info().title("title").version("version").description("description"))
                .addSecurityItem(new SecurityRequirement().addList("my security"))
                .components(new Components().addSecuritySchemes("my security",
                        new SecurityScheme().name("my 
                 security").type(SecurityScheme.Type.HTTP).scheme("bearer")));
    }
}