Swagger 本身不直接提供授权功能，在 Linux 系统中可通过以下方式实现授权：

1. OAuth 2.0 集成

   • 在 Swagger 配置文件（如 swagger.yaml）中定义 securitySchemes，指定 OAuth 2.0 的 type、flow、authorizationUrl、tokenUrl 等参数。
   • 在 API 端点中通过 security 字段应用授权方案，如 security: [ { oauth2: [] } ]。
   • 需搭配后端 OAuth 2.0 服务器（如 Keycloak）实现令牌颁发与验证。

2. API 密钥认证

   • 在 Swagger 配置中添加 apiKey 类型的安全方案，指定密钥传递方式（如 HTTP 头 X-API-Key）。
   • 后端通过验证请求头中的密钥控制访问权限。

3. JWT 认证

   • 生成 JWT 令牌（如使用 JJWT 库），在 Swagger 配置中将其作为 apiKey 或 http 类型的安全方案。
   • 后端通过解析令牌中的权限信息（如 scope）控制接口访问。

4. 角色/权限控制

   • 在后端定义角色与权限的映射关系，通过注解或配置将权限关联到 Swagger API 文档。
   • 例如，使用 @PreAuthorize 注解限制特定角色的接口访问。

5. 访问控制列表（ACL）

   • 在后端实现 ACL 逻辑，根据用户身份或所属组动态控制 API 访问权限。
   • 在 Swagger 文档中通过注释标注权限要求，辅助文档化权限规则。

注意：需确保通信使用 HTTPS，敏感信息（如密钥、令牌）需安全存储，生产环境建议结合 API 网关（如 Kong）统一管理认证授权。

参考来源：