深色模式
部署与安全
上线前要定三件事:谁能嵌、谁能看、数据到哪为止。
允许哪些宿主嵌
报表服务的配置文件 conch.config.json:
json
{
"embed": {
"allowedOrigins": ["https://hdms.example.com", "https://portal.example.com"]
}
}这一份名单同时管住两种嵌入形态:
- iframe:报表服务在每个响应上发
Content-Security-Policy: frame-ancestors https://hdms.example.com https://portal.example.com——只有这两个站点能把报表嵌进 iframe,别人嵌会被浏览器挡掉。 - 自定义元素:这种形态不是 iframe,
frame-ancestors管不到它;它是宿主页面跨域直接调报表服务的接口,所以名单落成 CORS 白名单——不在名单里的站点,浏览器不会把接口结果交给它。
不配这一段就两边都不限制,任何站点都能嵌。本地开发和演示可以不配,正式部署应当配上。改完重启报表服务生效。
SaaS 镜像部署
用供应商发来的 SaaS 镜像部署时,授权里写着你们的域名:
- 报表服务只接受从授权域名进来的访问,别的域名访问回 403(集群内部用 IP、服务名访问不受限制)。
- 不配
allowedOrigins时,授权域名下的 https 站点都能嵌;配了就只放行名单里、同时落在授权域名内的那些,名单里超出授权域名的会被忽略,启动日志里会写明。 - 要加域名,找供应商换授权。
只配一种形态挡不住另一种
以前只有 iframe 那一种嵌法时,配了 frame-ancestors 就够了。现在要是漏配(或者只在代理上加了 X-Frame-Options),别的站点仍然能用自定义元素把你们的报表嵌走。名单写在 allowedOrigins 里,两种形态一起管住。
也要检查反向代理
有些网关默认往回加 X-Frame-Options: SAMEORIGIN,那一条会让所有跨域嵌入失败,而且比 frame-ancestors 更粗暴。报表服务自己不发这个头,发了就是代理加的,去代理上关掉。
谁能看到报表
推荐:开启鉴权,由宿主签发凭证。 报表服务配 auth.mode: "jwt" 后,每个接口都要宿主后端签发的短期凭证,租户、角色、数据范围都从凭证里取,浏览器改不了。iframe、自定义元素怎么拿到凭证,见登录身份与数据范围。
不开鉴权时,查看页没有自己的登录页,访问控制靠部署位置来做,两种可行方案:
一、放在内网 / 只开给宿主的网络 报表服务不暴露到公网,只有能访问宿主系统的人能访问它。最省事,适合院内、厂内部署。
二、由宿主反向代理,鉴权在代理上做 把报表服务挂到宿主自己的域名下,用户的登录态(cookie)天然带上,也没有跨站 cookie 的麻烦:
nginx
location /report/ {
# 这里接你们自己的鉴权(auth_request / JWT 校验 / 基础认证)
auth_request /your-auth;
# 填安装时选的监听地址与端口;选的是局域网地址(如 192.168.1.20)就填那个,127.0.0.1 连不上
proxy_pass http://127.0.0.1:5088/;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
# 多租户部署时由代理钉死租户,浏览器改不了
proxy_set_header X-Conch-Tenant hospital-a;
# 对话式生成走 SSE,必须关缓冲
proxy_buffering off;
}宿主页面里 iframe 就写 src="/report/?id=...&view=1",同源,frame-ancestors 也不用配了。
用自定义元素同理:脚本写 src="/report/embed.js",它会自己认出服务在 /report/ 下,接口也走这个代理——同源、带得上登录态,CORS 与租户头都不用另外操心。
报表服务的页面、图标与接口请求都按它自己所在的目录走,挂在哪个子路径下都行,报表服务这边不用配前缀。代理上注意两点:
- 转发时去掉前缀:上面
proxy_pass http://127.0.0.1:5088/;末尾那个/就是去掉/report的意思,报表服务收到的是/api/...。 - 保留原来的 Host:
proxy_set_header Host $host;。用按域名授权的镜像部署时,报表服务按 Host 判断访问是否来自授权域名。
不带斜杠访问 /report 时,nginx 会自动重定向到 /report/;报表服务的页面自己也会补上斜杠。
K8s 上用 ingress-nginx 时这样写(其它 Ingress 控制器按各自的「去前缀」写法):
yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: conch-report
annotations:
nginx.ingress.kubernetes.io/use-regex: "true"
nginx.ingress.kubernetes.io/rewrite-target: /$2
nginx.ingress.kubernetes.io/proxy-buffering: "off" # 对话式生成走 SSE
nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
# 鉴权接到宿主自己的认证服务(按宿主现有的写法)
# nginx.ingress.kubernetes.io/auth-url: "http://<宿主认证服务>/check"
spec:
rules:
- host: hdms.example.com
http:
paths:
- path: /report(/|$)(.*)
pathType: ImplementationSpecific
backend: { service: { name: conch-report, port: { number: 80 } } }别把报表服务直接开到公网又不设任何认证
查看态链接里只有报表 id,能猜到 id 的人就能看到那张报表的数据。公网部署一定要在前面加一道认证。
不开鉴权时,租户从请求头 X-Conch-Tenant、数据范围从 X-Conch-Scope 取,浏览器发不出这两个头,所以必须在反向代理上注入,不能指望前端传。按登录身份逐个用户区分数据范围,要开鉴权,见登录身份与数据范围。
数据边界在哪
| 这一层 | 做了什么 |
|---|---|
| 数据库账号 | 只读账号,写操作在库上就被拒 |
| SQL 守卫 | 报表里的每条 SQL 执行前都过一遍守卫,只放行单条只读查询 |
| 查看态下发内容 | 规格里的 SQL 正文不下发到浏览器,查看页拿到的只有渲染要用的结构 |
| 客户端传参 | 查看态只报版本号,规格由服务端按那一版取,浏览器传来的规格不作数 |
| 行级范围 | 数据源配了数据范围时,每条 SQL 执行前被改写成只查当前身份范围内的数据,不靠 SQL 里写没写条件;拿不到身份就拒绝,不回落到默认值 |
| 模型 | 只在设计态参与,只看表结构与字典值;运行态没有模型,数据从库到浏览器不经过任何模型 |
lock= 只是界面口径(控件只读),不是权限。会改链接的人能把它去掉。要做到「这个人只能看到自己那部分数据」,必须落在凭证里的数据范围上,不能靠 lock,也不能靠链接参数——请求里带由系统决定的参数会被直接拒绝。
对业务库的压力
报表直接查宿主的业务库,下面这几道闸防止一条慢查询或一阵并发拖垮它:
| 这一道 | 做了什么 |
|---|---|
| 查询时限 | 页面上跑数、穿透 10 秒,导出 60 秒;排队、建连、执行、取数全算在内,到点就叫库停掉这条查询、连接归还 |
| 行数上限 | 页面 5000 行,导出 10 万行;够数就叫库停掉,不等它把剩下的行送完 |
| 库里的兜底 | MySQL / MariaDB / PostgreSQL 在库里也设了语句超时(比上面多 5 秒),报表服务被强杀、来不及叫停时库自己会停。SQL Server 没有这个机制,需要的话请 DBA 配 Resource Governor |
| 并发上限 | 每个库同时最多跑 8 条查询,多出来的排队,排队时间算在查询时限里。在配置文件里调:"query": { "maxConcurrentPerDatasource": 4 },改完重启服务 |
| 页面上的取消 | 连着改筛选、关掉穿透窗口、关掉页面时,还没回来的查询会被取消,库不会白跑 |
HTTPS
宿主是 https://、报表服务是 http://,浏览器会按混合内容直接拦掉 iframe,页面上一片空白。两边都上 HTTPS,或者都走同一个域名下的反向代理。
链接里别放这些
- 不要放 token、密码、签名。查看态链接会进浏览器历史、进 Referer、被人抄给同事。
- 不要放 SQL。报表服务不接受从链接或请求体传 SQL 来执行。
- 不要放能反推出别人身份的值——链接是可以改的,把
dept=A改成dept=B的成本是零。
版本怎么发才稳
- 嵌出去的链接默认跟着当前发布版走。设计者改草稿不会影响生产页面,重新发布才会更新。
- 要在改版期间保持页面不变,把链接钉在某一版:
&version=v3。 - 要给客户一份不会再变的数,发布时选「数据快照」,那一版打开不查库。
version=draft只用于发布前自查,别出现在给客户的链接里。
