springdocopenapiui中用于基本身份验证的java启用授权按钮

Question

如何在springdoc-openapi-ui（OpenAPI 3.0/swagger-ui.html）中启用“授权”按钮进行基本身份验证

在Spring @Controller和@Configuration类中必须添加哪些注释

Answer 1

在@Configurationbean中使用注释@io.swagger.v3.oas.annotations.security.SecurityScheme定义OpenAPI 3.0的全局安全方案：

@Configuration
@OpenAPIDefinition(info = @Info(title = "My API", version = "v1"))
@SecurityScheme(
    name = "basicAuth",
    type = SecuritySchemeType.HTTP,
    scheme = "basic"
)
public class OpenApi30Config {

}

注释每个需要基本身份验证的@RestController方法，其中@io.swagger.v3.oas.annotations.Operation引用已定义的安全方案：

@Operation(summary = "My endpoint", security = @SecurityRequirement(name = "basicAuth"))