Swagger路径的特定安全性

Question

我有一个节点。我想在其中添加炫耀文档的jsAPI。客户通过JWT授权，因此我将此添加到安全中：

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

然后我可以将它添加到不同的路径中，告诉客户端，要做到这一点，您需要登录。

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

但是，如何添加更具体的安全约束呢？例如，用户只有在以该用户身份登录时才能编辑配置文件。或者，如果用户具有超级管理员状态，或者如果他是论坛的管理员，则可以编辑评论，评论将发布在 OR 上，作为创建此评论的用户进行记录。

Answer 1

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

我所做的是在swagger文件< code>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);
}