OpenAPI 2.0 警告

损坏的对象级授权
- securityDefinition 声明中未定义安全字段中使用的 OAuth 方案的范围
- 使用的 OAuth 方案的范围未在 securityDefinition 声明中定义
损坏的用户身份验证
- 未定义安全字段
- 安全字段不包含任何项目
- 安全字段不包含任何方案
- 未定义安全定义对象
- 安全定义对象不包含任何方案
- 安全字段中使用的方案未在安全定义对象中定义
- 操作的安全字段不包含任何项目
- 操作的安全字段不包含任何方案
- 操作不强制执行任何安全方案
- 过多的数据暴露
- API 接受来自 OAuth 身份验证的纯文本凭据
- API 接受纯文本的 API 密钥
- API 接受纯文本的基本身份验证凭据
- 全局方案定义了 HTTP 方案
- 操作以纯文本形式接受来自 OAuth 身份验证的凭据
- 操作接受纯文本的 API 密钥
- 操作接受纯文本的基本身份验证凭据
- 操作方案定义了 HTTP 方案
- 授权 URL 使用 HTTP 协议。凭证将作为纯文本传输
- 令牌 URL 使用 HTTP 协议
- Produces 字段未定义
- Produces 字段不包含任何项目
- 为操作生成字段不包含任何项目
- 操作不包含产生字段
注射
- 未定义消耗字段
- 消耗字段不包含任何项目
- 操作的消耗字段不包含任何项目
- 操作不包含消耗字段

资产管理不当

OAuth 身份验证使用已弃用的隐式流程
OAuth 身份验证使用已弃用的密码流程

损坏的对象级授权

securityDefinition 声明中未定义安全字段中使用的 OAuth 方案的范围

解决：

swagger: '2.0'
#...
security:
  - OAuth2:
    - read
    - write
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    scopes:
      read: read object
      write: writes object
    authorizationUrl: https://example.com/authorize
    tokenUrl: https://example.com/token

使用的 OAuth 方案的范围未在 securityDefinition 声明中定义

解决：

swagger: '2.0'
#...
paths:
  "/user":
    get:
      summary: 'Sample endpoint: Returns details about a particular user'
      operationId: listUser
      security:
        - OAuth2:
          - read
          - write
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    scopes:
      read: read object
      write: writes object
    authorizationUrl: https://example.com/authorize
    tokenUrl: https://example.com/token

损坏的用户身份验证

未定义安全字段

解决：

swagger: '2.0'
#...
securityDefinitions:
  basicAuth:
    type: basic
security:
    - basicAuth: []

安全字段不包含任何项目

解决：

swagger: '2.0'
#...
securityDefinitions:
  basicAuth:
    type: basic
security:
    - basicAuth: []

安全字段不包含任何方案

解决：

swagger: '2.0'
#...
securityDefinitions:
  basicAuth:
    type: basic
security:
    - basicAuth: []

未定义安全定义对象

解决：

swagger: '2.0'
#...
securityDefinitions:
  basicAuth:
    type: basic

安全定义对象不包含任何方案

解决：

swagger: '2.0'
#...
securityDefinitions:
  basicAuth:
    type: basic

安全字段中使用的方案未在安全定义对象中定义

解决：

swagger: '2.0'
#...
securityDefinitions:
  basicAuth:
    type: basic
security:
    - basicAuth: []

操作的安全字段不包含任何项目

解决：

swagger: '2.0'
#...
paths:
  /user:
    get:
      description: 'Returns details about a particular user'
      security:
          - basicAuth: []
      #...
securityDefinitions:
  basicAuth:
    type: basic

操作的安全字段不包含任何方案

解决：

swagger: '2.0'
#...
paths:
  /user:
    get:
      description: 'Returns details about a particular user'
      security:
          - basicAuth: []
      #...
securityDefinitions:
  basicAuth:
    type: basic

操作不强制执行任何安全方案

解决：

swagger: '2.0'
#...
paths:
  /user:
    get:
      description: 'Sample endpoint: Returns details about a particular user'
      security:
          - basicAuth: []
      #...
securityDefinitions:
  basicAuth:
    type: basic

过多的数据暴露

API 接受来自 OAuth 身份验证的纯文本凭据

解决：

swagger: '2.0'
#...
host: 'example.com'
schemes:
  - https
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    authorizationUrl: https://my.auth.example.com/
    tokenUrl: https://my.token.example.com/
security:
 - OAuth2: []

API 接受纯文本的 API 密钥

分辨率：

swagger: '2.0'
#...
host: 'example.com'
schemes:
  - https
securityDefinitions:
  apiKeyAuth:
    type: apiKey
    name: api_key
    in: header
security:
  - apiKeyAuth: []

API 接受纯文本的基本身份验证凭据

解决：

swagger: '2.0'
#...
host: 'example.com'
schemes:
  - https
securityDefinitions:
  basicAuth:
    type: basic
security:
 - basicAuth: []

全局方案定义了 HTTP 方案

解决：

swagger: '2.0'
#...
host: 'example.com'
schemes:
  - https
#...

操作以纯文本形式接受来自 OAuth 身份验证的凭据

解决：

swagger: '2.0'
#...
host: 'example.com'
paths:
  "/user":
    get:
      summary: 'Sample endpoint: Returns details about a particular user'
      schemes:
          - https
      security:
          - OAuth2: []
      #...
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    authorizationUrl: https://my.auth.example.com/
    tokenUrl: https://my.token.example.com/

操作接受纯文本的 API 密钥

分辨率：

swagger: '2.0'
#...
host: 'example.com'
paths:
  "/user":
    get:
      summary: 'Sample endpoint: Returns details about a particular user'
      schemes:
          - https
      security:
          - apiKeyAuth: []
      #...
securityDefinitions:
  apiKeyAuth:
    type: apiKey
    name: api_key
    in: header

操作接受纯文本的基本身份验证凭据

解决：

swagger: '2.0'
#...
host: 'example.com'
paths:
  "/user":
    get:
      summary: 'Sample endpoint: Returns details about a particular user'
      schemes:
          - https
      security:
          - BasicAuth: []
      #...
securityDefinitions:
  BasicAuth:
    type: basic

操作方案定义了 HTTP 方案

解决：

swagger: '2.0'
#...
host: 'example.com'
paths:
  "/user":
    get:
      summary: 'Sample endpoint: Returns details about a particular user'
      schemes:
          - https
      #...

授权 URL 使用 HTTP 协议。凭证将作为纯文本传输

解决：

swagger: '2.0'
#...
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    #...
    authorizationUrl: https://example.com/authorize

令牌 URL 使用 HTTP 协议

解决：

swagger: '2.0'
#...
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    #...
    tokenUrl: https://example.com/token

Produces 字段未定义

解决：

swagger: '2.0'
paths: {}
consumes:
  - application/json
produces:
  - application/json

Produces 字段不包含任何项目

解决：

swagger: '2.0'
paths: {}
produces:
  - application/json
...

为操作生成字段不包含任何项目

解决：

swagger: '2.0'
paths:
  /user/{userId}:
    get:
      produces:
        - application/json

操作不包含产生字段

解决：

swagger: '2.0'
paths:
  /user/{userId}:
    get:
      produces:
        - application/json
  ...
...

注射

未定义消耗字段

解决：

swagger: '2.0'
paths: {}
consumes:
  - application/json

消耗字段不包含任何项目

解决：

swagger: '2.0'
paths: {}
consumes:
  - application/json
...

操作的消耗字段不包含任何项目

解决：

swagger: '2.0'
paths:
  /user/{userId}:
    put:
      consumes:
        - application/json

操作不包含消耗字段

解决：

swagger: '2.0'
paths:
  /user/{userId}:
    put:
      consumes:
        - application/json
  ...
...

资产管理不当

OAuth 身份验证使用已弃用的隐式流程

解决：

swagger: '2.0'
#...
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    authorizationUrl: https://my.auth.example.com/
    tokenUrl: https://my.token.example.com/
    scopes:
      write: modify data
      read: read data

OAuth 身份验证使用已弃用的密码流程

解决：

swagger: '2.0'
#...
securityDefinitions:
  OAuth2:
    type: oauth2
    flow: accessCode
    authorizationUrl: https://my.auth.example.com/
    tokenUrl: https://my.token.example.com/
    scopes:
      write: modify data
      read: read data

42 次浏览	1次

< 首页

< 下一页