Skip to content

部署与安全 ​

上线前要定三件事:谁能嵌、谁能看、数据到哪为止。

允许哪些宿主嵌 ​

报表服务的配置文件 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 只用于发布前自查,别出现在给客户的链接里。

给 AI 用的纯文本索引在 /llms.txt,每篇原文在 /md/ 下。