Swagger 路径的特定安全性

Question

我有一个 Node.js API，我想在其中添加 swagger 文档。客户端通过 JWT 授权，所以我将其添加到安全性：

securityDefinitions:
  UserSecurity:
    type: apiKey
    description: User is logged in
    in: header
    name: Authorization

我可以将其添加到不同的路径以告诉客户端，要执行此操作，您需要登录。

/user/{userId}
  get:
    security:
      - UserSecurity: []

但是如何添加更具体的安全约束？就像，用户只能以该用户身份登录才能编辑配置文件。或者，如果用户具有超级管理员状态，或者如果他是董事会的管理员，则用户可以编辑评论，评论发布在或记录为创建此评论的用户。

Answer 1

AFAIK，没有直接的方法可以将“角色”添加到招摇文档中。

我所做的是，我正在向 swagger 文件 x-scope 添加一个自定义部分：

get:
    operationId: getToken
    x-scope:
      - merchant
    security:
      - token: []

然后在代码中，我根据路径中提供的角色检查用户的角色：

authorize: (req, def, token, callback) => {
  let scopes = req.swagger.operation["x-scope"];
  //scopes will contain ["merchant"] array

  return verifyUserAndRoles(token, scopes);
}