SuperAPI AI 工具集

edit-embed

通用与其它

查看项目

更新于 10-15 23:39

技能介绍

用途:让外部用户通过嵌入式 iframe 创建、编辑、保存和分享 Domo 内容(仪表板、卡片、提醒、报告、数据源)。使用 Domo Identity Broker 配合 JWT 认证,与只读嵌入有本质区别。只读嵌入见 programmatic-filters,客户端过滤见 jsapi-filters。

主要能力:服务端验证用户并生成含身份、角色与路由属性的 JWT;用 Domo 提供的共享密钥签名;构造编辑 URL {IDP_URL}/jwt?token={jwt_token};客户端将该 URL 直接作为 iframe src(无需 POST 表单);Identity Broker 校验 JWT 并按角色把用户路由到正确的 Domo 实例。

使用方式:需先与 Domo CSM 配置 Identity Broker,提供实例 URL、认证方式(JWT)、路由属性键及属性到实例的映射。获得 Broker URL、JWT 签名密钥(UUID)和属性键配置。环境变量:IDP_URL、JWT_SECRET、KEY_ATTRIBUTE。JWT 必填字段:sub、exp、jti 及路由属性;常用可选字段含 name、email、role、groups 等。角色有 Admin、Privileged、Editor、Participant,外部用户通常应为 Editor 或 Participant。签名算法用 HS256,建议 exp 设为 5 分钟。可用 destination 参数深度链接到页面或卡片。

限制与注意:密钥不得暴露到客户端,须用环境变量或密钥管理。jti 需用 UUID v4 防重放;映射值须与 Domo 实例映射完全一致,并建议使用稳定值。编辑嵌入按角色授予完整 Domo 会话,角色分配应保守。