● 由 Leon 开发 · Python Flask · SQLite · 达梦 · HMAC 票据

致远 OA 二开管理平台

OA 数据只进一个门:达梦生产库只读直连、OA 流程操作双通道代理、组织架构与用户资料对外接口、单点登录票据换入、已结束表单零写入覆盖——其他平台无法直连生产库、无法持有 OA 会话,本平台是唯一流通枢纽。

达梦只读直连 · 112 张表单撤回/终止/退回HMAC 票据 SSO/api/ext 对外接口oa-overlay 零写入fail-closed 闸门
自上而下通读即可
01 / 概括

OA 只放壳,数据与渲染全在平台

定位、难点、技术框架——30 秒建立全貌。

定位致远 OA 是壳,平台是里子

致远 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 流程操作,只能经本平台的枢纽与对外接口消费数据。

难点四个真问题

框架技术栈与运行形态

语言/形态
Python Flask dev server(threaded)· 原生 JS 无框架 · SQLite 三库
只读数据源
达梦 172.168.10.97:5236 / SEEYON_OA(Leon 只读):CAP_FORM_DEFINITION、FORMMAIN_xxxx(112 张)、ORG_MEMBER/ORG_PRINCIPAL、COL_SUMMARY
操作通道
OAWebSession(DES+EvpKDF 模拟登录)+ OA REST(172.168.10.42:8012):撤回 / 终止 / 退回 / 转办 / 导出
登录
OA 是唯一身份源:HMAC-SHA256 一次性票据(120 秒)+ yztsso Cookie(12h)+ OA 会话 30s 缓存,多 OA 入口任一认到即放行
数据
fillin.sqlite(表单实例与封存)· leon_types.sqlite(7 种组件类型)· monthly_export.db(映射 37 / 历史 11,最大 16.4MB)
运维
无 systemd,setsid nohup 拉起,看护进程补拉;git 每日自动备份;公网 8506 裸端口映射(绕过 WAF,已知风险)
02 / 架构

数据怎么流,红线压在哪一层

三条主链路,每条各守一条红线。

链路 A读数:达梦直连 → 平台 → 消费方

达梦生产库
只读 · Leon
→ oa_hub 中转
31 读白名单 · 审计
→ 表单/导出/覆盖
112 张表单
→ 业务浏览器

FIELD_INFO 超 4000 字符必须分段拼接;SYSDBA 默认 schema 不是 SEEYON_OA,一律带 schema 前缀;生产库禁写,违者 sidecar 覆盖代替。

链路 B办事:浏览器 → 平台 → OA 会话代办

用户浏览器
平台登录态
→ OA_USER_SESSIONS
按用户缓存 OA 会话
→ OA REST/Web
撤回/退回/导出
→ 流程往前走

撤回必须 POST + _json_params(缺 body 即“从页面获取数据失败”);退回目标节点必须是历史节点(传未走过节点会被静默退回上一节点);isCircleBack 归一 0/1。

链路 C换票:OA → 票据 → 平台放行

OA 登录态
JSESSIONID
→ /leonapi/sso
HMAC 票据 120s
→ 平台验票
nonce 防重放
→ yztsso 12h

无状态:每次页面访问回 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,无免部署方案
03 / 代码

四段核心代码

生产语言实录,按难度递进:签票 → 核验 → 闸门 → 代理。

C1签票:OA 侧 HMAC 一次性票据

票据格式 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。

C2核验:四个 OA 入口依次问,任一认到即放行

生产 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 秒熔断跳过。

C3闸门:类型感知,只锁“能验”的

网关 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 宁可锁,不可放。

C4代理:embed 地址永不写死内网

外层单源归一的 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 吞掉退化为纯文本——作用域即故障域。

04 / 优化

主要优化

每条都是攻坚现场真实发生的:现象 → 根因 → 解法。

技术难点现象与根因解决法
填写态退化纯文本,点击无反应 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。
📖 说明书📐 说明文档🕘 日志