swagger core 2.0 отключить безопасность для конечной точки

Я использую Swagger Core 2.0 для создания файлов определений openAPI 3.0, и у меня возникли проблемы с отключением «безопасности» для конкретной конечной точки. У меня определены мои securitySchemes и корневой элемент безопасности:

{
  "openapi" : "3.0.1",
  "security" : [ {
    "JWT" : [ ]
  } ],
  "paths" : {   
    "/auth" : {
      "post" : {
        "summary" : "authenticate user",
        "operationId" : "authenticate",
        "requestBody" : {
          "content" : {
            "application/json" : {
              "schema" : {
                "$ref" : "#/components/schemas/AuthenticationRequest"
              }
            }
          }
        },
        "responses" : {
          "200" : {
            "description" : "when user is successfully authenticated",
            "content" : {
              "application/json" : {
                "schema" : {
                  "$ref" : "#/components/schemas/AuthenticateUserOutput"
                }
              }
            }
          },       
          "401" : {
            "description" : "when email/password not valid or user is blocked/inactive"
          }       
        }
      }
    },
  },
  "components" : {
    "schemas" : {
      "AuthenticateUserOutput" : {
        "type" : "object",
        "properties" : {
          "token" : {
            "type" : "string"
          },
          "lastLoginAt" : {
            "type" : "string",
            "format" : "date-time"
          },        
          "lastProjectId" : {
            "type" : "string"
          }
        }
      },
      ...,
      "AuthenticationRequest" : {
        "required" : [ "email", "password" ],
        "type" : "object",
        "properties" : {
          "email" : {
            "type" : "string"
          },
          "password" : {
            "type" : "string"
          }
        }
      }
    },
    "securitySchemes" : {
      "JWT" : {
        "type" : "http",
        "scheme" : "bearer",
        "bearerFormat" : "JWT"
      }
    }
  }
}

Согласно спецификации OPEN API 3 https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#securityRequirementObject, я должен иметь возможность переопределить глобальные «требования безопасности» для отдельной операции. Я хотел бы «отключить» безопасность JWT для нескольких операций, и, согласно https://github.com/OAI/OpenAPI-Specification/blob/3.0.1/versions/3.0.1.md#securityRequirementObject, это можно сделать:

Чтобы удалить объявление безопасности верхнего уровня, можно использовать пустой массив.

К сожалению, я изо всех сил пытаюсь определить «пустой массив безопасности» на уровне операции с использованием аннотаций ... Я попытался указать

security = {}

or

security = @SecurityRequirement(name ="")

но никакой элемент безопасности внутри операции не создается вообще .... Есть идеи?

Ниже приведен мой Java-код (я использую для интеграции с Swagger dropwizard), который позволяет определить SecurityScheme и безопасность корневого уровня.

 Info info = new Info()
            .title("someTitle")
            .description("some description")
            .version("1.0")

    SecurityScheme jwtSecurity = new SecurityScheme()
            .type(SecurityScheme.Type.HTTP)
            .name("Authorization")
            .in(SecurityScheme.In.HEADER)
            .scheme("bearer")
            .bearerFormat("JWT");

    String securitySchemaName = "JWT";
    OpenAPI oas = new OpenAPI()
            .info(info)
            .components(new Components().addSecuritySchemes(securitySchemaName, jwtSecurity))
            .addSecurityItem(new SecurityRequirement().addList(securitySchemaName));

    SwaggerConfiguration oasConfig = new SwaggerConfiguration()
            .openAPI(oas)
            .prettyPrint(true)
            .resourcePackages(Stream.of("my.resources.package")
                    .collect(Collectors.toSet()));
    environment.jersey().register(new OpenApiResource()
            .openApiConfiguration(oasConfig));

Затем на нескольких выделенных конечных точках я хотел бы отключить безопасность, поэтому я пытаюсь:

    @POST
@Operation(
        summary = "authenticate user",
        responses = {
                @ApiResponse(responseCode = "200", description = "when user is successfully authenticated",
                        content = @Content(schema = @Schema(implementation = AuthenticateUserOutput.class))),                   
                @ApiResponse(responseCode = "401", description = "when email/password not valid or user is blocked/inactive"),
        }
        ,security = what to put here ?
)

person user62058    schedule 01.06.2018    source источник
comment
Не могли бы вы опубликовать свой Java-код с аннотациями?   -  person Helen    schedule 01.06.2018
comment
Я только что отредактировал сообщение, чтобы добавить глобальную конфигурацию и конфигурацию для конкретной конечной точки   -  person user62058    schedule 01.06.2018
comment
Вы нашли решение этого? В настоящее время это вызывает у меня головную боль   -  person Xander    schedule 08.07.2020


Ответы (2)


Согласно комментарию к проекту OpenAPI-Specification GitHub . Это должно быть возможно.

Вы пробовали это?

security: [
  {}
]
person dansomething    schedule 31.07.2019

У меня была такая же проблема в веб-приложении Java SpringBoot (dependency org.springdoc: springdoc-openapi-ui: 1.5.2). В соответствии с этим ответом я решил добавить пустую аннотацию @SecurityRequirements к операции. Например:

@POST
@SecurityRequirements
@Operation(
    summary = "authenticate user",
    responses = {
    @ApiResponse(responseCode = "200", description = "when user is successfully authenticated",
                 content = @Content(schema = @Schema(implementation = AuthenticateUserOutput.class))),                   
        @ApiResponse(responseCode = "401", description = "when email/password not valid or user is blocked/inactive"),
    } )
)
person Sergio    schedule 23.12.2020