OA 数据只进一个门:达梦生产库只读直连、OA 流程操作双通道代理、组织架构与用户资料对外接口、单点登录票据换入、已结束表单零写入覆盖——其他平台无法直连生产库、无法持有 OA 会话,本平台是唯一流通枢纽。
定位、难点、技术框架——30 秒建立全貌。
致远 OA(Seeyon A8N V9.0SP1 CAP4)侧只放壳控件 + 配置 + 渲染挂载点:控件类 LeonTestControl、前端原生 JS leonTestCtrl.js、代理 Servlet /seeyon/leonapi/*(自动补 X-API-Key)。业务逻辑与数据全部落在自有 Flask 平台 TK-ZY-OA(192.168.11.70:8506,公网 119.145.17.34:8506)。新增组件类型时 OA 侧零改动——OA 只需两个接口(GET /api/leon/types、POST /api/leon/bind)与一个渲染页(/api/leon/embed)。
平台同时是 OA 数据的唯一流通枢纽:其他平台无法直连达梦生产库、无法持有 OA 会话、无法签发 OA 票据、无法代理 OA 流程操作,只能经本平台的枢纽与对外接口消费数据。
三条主链路,每条各守一条红线。
FIELD_INFO 超 4000 字符必须分段拼接;SYSDBA 默认 schema 不是 SEEYON_OA,一律带 schema 前缀;生产库禁写,违者 sidecar 覆盖代替。
撤回必须 POST + _json_params(缺 body 即“从页面获取数据失败”);退回目标节点必须是历史节点(传未走过节点会被静默退回上一节点);isCircleBack 归一 0/1。
无状态:每次页面访问回 OA 重新确认,OA 退出/换人立刻生效;票据一次性且出现在 URL,落地后用 location.replace 清掉。
| 模块 | 职责 | 难点所在 |
|---|---|---|
| oa_hub 数据枢纽 | 统一中转,其他项目不再直连 OA;token 缓存 20 分钟 | 读 31 前缀白名单、写 15 条 curated 白名单 + 总开关 |
| /api/ext 对外接口 | 口令换令牌,组织架构 87 部门 + 用户资料只读 | 无状态 HMAC 令牌,轮换靠改口令;成员登录名以 ORG_PRINCIPAL 为准 |
| oa-overlay 覆盖服务 | 已结束表单零写入展示,SQLite sidecar + 原单快照 | 覆盖作者须可信;分享外链未做,仍需控制台登录 |
| info-board 展示板 | 接口驱动(remote_url),SSO 无状态闸门 | 64KB 上限 / 8s 超时;门户挂载走设计器 iframe 型 |
| 完整性闸门 | 无实例即锁,留证 | 类型感知放行:只管 renderer=form,其余 passthrough 直渲 |
| CAP4 壳控件 | OA 零改动增删组件类型 | 生产达梦 leon_component_def 缺表,靠 servlet 透传平台 /types |
| 门户自定义栏目 | leonInfoBoardSection(kkcustom),iframe 走同源代理 | 命名栏目须服务端部署 + 重启 A8,无免部署方案 |
生产语言实录,按难度递进:签票 → 核验 → 闸门 → 代理。
票据格式 base64(payload).timestamp.nonce.hmac,payload = userId|loginName|name|role,TTL 120 秒,nonce 防重放。平台验票只认三件事:签名对得上、没过期、nonce 没用过。
def verify_ticket(ticket): if not ticket or ticket.count(".") != 3: return None, "票据格式不对" b64, ts, nonce, sig = ticket.split(".") if not hmac.compare_digest(_sign(b64 + "." + ts + "." + nonce), sig): return None, "签名校验失败" if abs(time.time() - int(ts)) > SSO_TTL: return None, "票据已过期" # nonce 单次有效:用过即记,SSO_TTL*2 后自动清理 with SEEN_LOCK: if nonce in SEEN_NONCE: return None, "票据已被使用" SEEN_NONCE[nonce] = time.time() parts = _unb64u(b64).decode("utf-8").split("|") return {"username": parts[0], "login_name": parts[1], "name": parts[2], "role": parts[3]}, None
为什么这样写:票据出现在 URL 里(会进浏览器历史),必须一次性;compare_digest 防时序攻击;签发与验证共享同一 SSO_SECRET。
生产 8012 与测试 8023 各有内网/公网入口,逐个带 Cookie 问 whoami;第一个 success 即认领身份,其余不再问。
def _oa_roots(): roots = [] for base in (OA8012_SSO_PUBLIC, OA_SSO_PUBLIC, OA8012_SSO_INTERNAL, OA_SSO_INTERNAL): r = base.split("/seeyon/")[0] if r and r not in roots: roots.append(r) return roots # 公网优先,内网兜底
为什么这样写:用户实际登录的是大鹏投控 8012,测试 8023 只是备用;顺序即优先级,坏入口 60 秒熔断跳过。
网关 mount 时按 leonType 取 renderer:只有平台存数、可封存的 form 类型才过闸;link/linklist/richtext/table/chart/custom 直接渲染,不撒谎、不误伤。
function gateApplies(cfg, done) { var t = (cfg && cfg.leonType) || ""; if (!t) return done(false); // 未配置组件:直接渲染 fetchType(t, function(def) { if (!def) return done(true); // 取不到定义:fail-closed 照旧过闸 return done(def.renderer === "form"); }); }
为什么这样写:linklist/hyperlink/richtext 存 OA/外部、永无实例,不过闸才是对的;未知 renderer 宁可锁,不可放。
外层单源归一的 absUrl:经 OA 同源代理时自动拼 /seeyon/leonapi 前缀,直连时为空——公网 embed 空白的根治。
function platformApi() { var base = apiBase(); // 直连→"";代理→"/seeyon/leonapi" return absUrl(base + "/api/leon/embed?flow=" + flow); } // V8.5.3 教训:absUrl 必须定义在外层闭包,GATE 内层不可见即 ReferenceError
为什么这样写:V8.5.3 把 absUrl 只定义在 GATE 内层闭包,外层 targetUrl 调用即抛错、被 mount-catch 吞掉退化为纯文本——作用域即故障域。
每条都是攻坚现场真实发生的:现象 → 根因 → 解法。
| 技术难点 | 现象与根因 | 解决法 |
|---|---|---|
| 填写态退化纯文本,点击无反应 | V8.5.3 把 targetUrl 改成调 absUrl,但 absUrl 只定义在 GATE 内层闭包——外层每次 mount 都抛 ReferenceError,被 catch 吞掉只剩静态文字。与网络、闸门状态无关,必现。 | 外层补与 GATE 同逻辑的 absUrl();platformApi 单源归一;V8.5.5 发版,公网双重验证对版。 |
| 网络抖动一次,组件永久悬挂 | GATE.check 失败分支写了 url: url,该作用域无此变量 → done() 永不执行 → mount() 悬挂。只在校验请求失败一次时触发。 | verifyUrl 先存变量 + done() 加 try/catch 保护;失败走可见 fail-closed 锁定,不再静默。 |
| 公网 embed 点开空白,内网正常 | 控件 JS 把 embed 地址写死为平台内网 PLATFORM,浏览器必须能直连 192.168.11.70:8506;公网用户直连不上。 | 平台 EMBED 页 PREFIX 按 location.pathname 自适应;OA targetUrl 走 /seeyon/leonapi 同源代理(servlet 自动补 X-API-Key)。 |
| 改完静态资源,前端看不到生效 | StaticExpiresFilter 只缓存 *.html(180 秒);改 .js/.css 即时生效,改 .html 必须重启 OA 域。 | leonConfig.html 发版后重启 Apusic mydomain(约 8 分钟就绪),6888 与公网双重验 md5。 |
| 信道接口 401,普通 token 永远过不去 | affairs/pending 等信道接口要求 channelId;普通 token 无 channelId,DataSynchronization 门禁直接 401。orgMember 等非信道接口一直正常。 | OA JVM 加 -DisIgnoreDataSyncAccessCheck=true 旁路(8023 通用版,systemd zyoa-8023 托管);kysec 环境下走 sudo kill -TERM + systemctl 拉起。 |
| FIELD_INFO 解析不全,字段字典缺块 | dbms_lob.substr 静默截断 4000 字符;mysql CLI batch 转义反斜杠导致大字段校验失真。 | 分段 4000 拼接取回;大字段用 HEX() 取回再本地 unhexlify;SYSDBA 默认 schema 不是 SEEYON_OA,一律带 schema 前缀。 |
| 类型感知前:linklist 字段必锁,误伤 | 网关对所有 formId/fieldId 必检,但只有 fillin-submit 建实例+封存;linklist/hyperlink/richtext 永无实例 → fresh 浏览器必锁 NO_INSTANCE_FOR_KEY。 | V8.6.1+typegate:闸门只管 renderer=form,其余 passthrough 直渲 + console 标注;未知 renderer 照旧 fail-closed。 |