openAPI规范中的角色授权配置

Question

我们正在为我们的服务创建 openAPI。这些服务受到授权标头中发送的 JWT 令牌的保护。在该 JWT 中，我们有与角色相关的声明。根据角色，用户可以访问他尝试访问的端点/路径。我们有什么方法可以在 openAPI 中定义端点/路径映射的角色。

例如，我有一个端点/路径 /api/v1/users，具有“ADMIN”角色的用户可以访问它。我如何在我的 openAPI 规范中定义它？

Answer 1

该项目的 openapi 负责人这样说：https://flic.kr/p/2keNR8v