写入Swagger（openAPI）规格：securityDefinitions

Question

我想在我的Swagger页面上实现HTTP基本身份验证。

的docs for securityDefinitions举个例子：

type: http 
scheme: basic 

但是当我把它添加到我的YAML文件是这样的：

securityDefinitions: 
    type: http 
    scheme: basic 

我得到一个错误：

我究竟做错了什么？

Answer 1

type: http 
scheme: basic 

是OpenAPI 3.0语法（您链接到的规范是OpenAPI 3.0）。

但是，你正在使用的OpenAPI 2.0，所以你需要使用：

securityDefinitions: 
    BasicAuth: 
    type: basic 

security: 
    - BasicAuth: [] 

这里是OpenAPI的2.0规格：
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#securitySchemeObject

下面是2.0的基本身份验证指南：
https://swagger.io/docs/specification/2-0/authentication/basic-authentication/