Quarkus Swagger-UI Authorization

Question

Im currently working with Quarkus and Swagger-UI as delivered by quarkus-smallrye-openapi. We have OIDC from Azure AD as security, which is currently not supported by Swagger-UI (see Swagger-Docs), so I can't add the "real" authorization to swagger. This means, I can't use Swagger since my endpoints are at least secured with @RolesAllowed. We have an endpoint to fetch a mock-security token, but I don't know how to tell swagger to take this token. Basically I want to tell swagger-ui "Here, I have this token, add it as Authorization: Bearer XXXto all requests", but I don't know how to do that in Quarkus.

Answer 1

1. Register security scheme

@Path("/sample")
@SecuritySchemes(value = {
        @SecurityScheme(securitySchemeName = "apiKey", 
                        type = SecuritySchemeType.HTTP,
                        scheme = "Bearer")}
)
public class SampleResource {

2. Mark the operation's security requirement with the scheme name registered.

    @GET
    @SecurityRequirement(name = "apiKey")
    String hello() {

3. Authorize option should be now available on swagger page. Enter your mock api key here.

4. Trigger the service from swagger ui. You could now see Authorization: Bearer <VALUE> header set in request.