docs: README + API_Auth + Security_Plan + Plugin_Guide 更新至 v0.7.0
- README: 新功能列表、start.sh、架构图 - API_Auth_Flow: 新增 API Key 认证章节 - Security_Hardening_Plan: 标记全部完成 - Plugin_Dev_Guide: 新增插件导入安装章节 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -239,6 +239,34 @@ Content-Type: application/json
|
||||
|
||||
---
|
||||
|
||||
|
||||
## 十一、API Key 认证 (服务器间通信)
|
||||
|
||||
### 创建 API Key
|
||||
在 WebUI "框架设置" → "API Key 管理" 中创建,支持三种权限模板:
|
||||
| 模板 | 权限 |
|
||||
|------|------|
|
||||
| `readonly` | framework.status.read, plugin.info.read |
|
||||
| `monitor` | + framework.event.subscribe |
|
||||
| `full` | admin (全部) |
|
||||
|
||||
每个 Key 可选 TTL 过期时间,格式 `sk-` + 48 hex chars。
|
||||
|
||||
### 使用方式
|
||||
```
|
||||
GET /SenSu/api/system
|
||||
Authorization: Bearer sk-xxxxxxxx...
|
||||
```
|
||||
|
||||
### 验证流程
|
||||
```
|
||||
panel_auth() 拦截
|
||||
├─ Cookie panel_token → Session Store
|
||||
├─ 失败 → API Key Store (validate_api_key)
|
||||
├─ 检查过期时间
|
||||
└─ 注入 key 自身权限范围
|
||||
```
|
||||
|
||||
## 八、安全响应头
|
||||
|
||||
所有响应自动添加:
|
||||
|
||||
@@ -3404,6 +3404,17 @@ class PluginResourceManager:
|
||||
|
||||
### 2.6 插件 WebUI 页面 (v0.6.0)
|
||||
|
||||
### 2.7 插件导入安装 (v0.7.0)
|
||||
|
||||
框架支持在 WebUI 插件管理页直接导入安装插件:
|
||||
|
||||
**ZIP 导入**:上传 .zip 包 → 自动解压到 plugins/ → pip install -r requirements.txt → 加载
|
||||
|
||||
**Git Clone 导入**:输入仓库 URL → git clone → pip install → 加载
|
||||
|
||||
安装过程在子进程中执行,失败不影响框架主进程。安装失败的插件在统计面板中显示。
|
||||
|
||||
|
||||
插件可以注册 WebUI 页面,自动出现在 SenSu 管理面板侧边栏的「插件面板」折叠项中。
|
||||
|
||||
#### 2.6.1 注册页面
|
||||
|
||||
Reference in New Issue
Block a user