# 安全与插件扩展标准
安全与插件扩展标准用于承载鉴权、接口文档、API 目录等 Web/API 增强能力。它们通常不属于服务运行的硬依赖,但会影响接口访问、调试和治理体验。
# 标准接口与插件能力
| 能力 | 作用 |
|---|---|
IJwtHandlerStandard | JWT 处理标准入口 |
IAppPluginFactory | 插件注册与获取工厂 |
IPlugin | 插件基础标记接口 |
Air.Cloud.Plugins.Jwt | JWT 鉴权插件 |
Air.Cloud.Plugins.SpecificationDocument | Swagger / OpenAPI 文档插件 |
Air.Cloud.Plugins.APICatalog | API 目录与探针插件 |
Air.Cloud.Plugins.CodeGenerator | 代码生成插件 |
Air.Cloud.Plugins.Security | 安全辅助插件 |
# 使用建议
- 插件不要放复杂业务流程,复杂业务应放在业务服务或模块里。
- 鉴权和文档属于 Web/API 横切能力,建议在应用启动阶段统一注册。
- 如果业务需要替换默认插件,应在启动阶段调用
AppRealization.SetPlugin()。
# 实现文档
- JWT:见
插件下的JWT 鉴权。 - Swagger:见
插件下的接口文档。