docs: 记录 Sense 视频接入安全边界 (#66)

This commit is contained in:
QiuSW
2026-08-14 16:58:13 +08:00
parent 2bb1614a3c
commit 26e2e632d5
5 changed files with 50 additions and 10 deletions
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
wiki_page: Local-Development-and-Verification
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Local-Development-and-Verification.-
wiki_revision: f68bbd8c7a99689e65453ae00c7bbd2c3ee00357
synchronized_at: 2026-08-14T07:02:43Z
wiki_revision: c8afa08e1e189a9c2779da1cbd3ed75124fd7eae
synchronized_at: 2026-08-14T08:53:20Z
<!-- gitea-wiki-mirror:end -->
# 本地开发与验证
@@ -163,6 +163,10 @@ $env:SENSE_CREDENTIAL_KEY = [Convert]::ToBase64String($keyBytes)
```
缺少或格式错误的密钥时,普通设备台账仍可读写,但凭据更新返回服务不可用且不得产生部分写入。设备回归至少覆盖:中文名称与位置、未知 JSON 字段拒绝、版本冲突返回 409、非视频设备显示适配器未就绪、viewer 只读、凭据响应/操作日志不含明文,以及 PostgreSQL 迁移重复执行不增加菜单或权限记录。
视频接入还需在仓库外配置 SENSE_ONVIF_DISCOVERY_IP(获准的本机网卡 IP)和 SENSE_ONVIF_ALLOWED_CIDRS(逗号分隔的获准摄像头网段)。不要使用 0.0.0.0/0 代替授权清单。
协议回归位于 app/sense/onvif、app/sense/rtsp、app/sense/admission;隔离 PostgreSQL 重启恢复测试通过 SENSE_ADMISSION_TEST_DATABASE_URL 显式启用。验证至少覆盖 Digest/Basic、无配置发现提示、URL 凭据和敏感查询拒绝、目标网段、重定向、Media/Stream 主机归一化、主子码流、失败重探保留已验证 Profile,以及 viewer 只读权限。
<!-- sense-runtime:end -->