Swagger 2.0多认证配置问题：实现双Header联合认证选项

在Swagger 2.0里完全可以实现你需要的认证逻辑，核心是利用Swagger的安全规则：security数组中的每个元素是「或」的关系，元素内的多个认证项是「且」的关系。具体调整步骤如下：

1. 完善securityDefinitions配置 #

需要把JWT认证依赖的两个请求头x和y分别定义为独立的apiKey认证项：

securityDefinitions:
  DomainSessionAuth:
    type: apiKey
    in: header
    name: a
    description: 单会话身份认证
  JwtAuthX:
    type: apiKey
    in: header
    name: x
    description: JWT认证所需的X请求头
  JwtAuthY:
    type: apiKey
    in: header
    name: y
    description: JWT认证所需的Y请求头

2. 调整路径的security规则 #

通过数组元素的拆分与组合，实现「二选一」的逻辑：

security:
  # 选项一：仅携带请求头a即可通过认证
  - DomainSessionAuth: []
  # 选项二：必须同时携带请求头x和y才能通过认证
  - JwtAuthX: []
    JwtAuthY: []

配置逻辑说明 #

• security数组里的两个对象代表两种可选的认证方式，用户只需满足其中一种即可。
• 第二个对象内同时声明JwtAuthX和JwtAuthY，表示这两个请求头必须同时存在，符合你要求的「JWT认证需要同时携带x和y」的规则。

内容的提问来源于stack exchange，提问作者mike