openapi - Swagger Open API 安全架构给出对象错误

Question

我在 yaml 的 open api swagger 规范中设置安全架构时遇到问题。

设置安全模式时出现以下错误：

在路径中我确实使用了 Bearerauth 但仍然是同样的问题：

路径：

/v1/items:
    get:
      tags:
        - Item Resources
      summary: searches items
      security:
        - BearerAuth: [adsfdf]
      operationId: searchItems
      description: |

有关如何解决此问题的任何建议，或实施有任何问题？

Answer 1

您的全局安全定义是缩进的。全局安全性是在顶层定义的，而不是在 auth 类型或组件定义中。

此外，在您的路径使用中，您定义了一个范围adsfdf。安全范围不适用于承载身份验证 - 出于 OAuth 的目的，此格式存在于 OpenAPI 中。有关更多详细信息，请参阅Swagger 的文档。

security:
  - bearerAuth: []         # use the same name as above