用途:让外部用户通过嵌入式 iframe 创建、编辑、保存和共享 Domo 内容,包括仪表板、卡片、警报、报表和数据源。该方案与只读嵌入不同,采用 Domo Identity Broker 配合 JWT 认证。
主要能力:服务端先认证用户并生成带身份、角色和路由属性的 JWT;用 Domo 提供的共享密钥签名;再构造编辑 URL:{IDP_URL}/jwt?token={jwt_token};客户端直接把该 URL 作为 iframe src 渲染,无需 POST 表单。Identity Broker 校验 JWT 后按角色把用户路由到正确的 Domo 实例。支持 SAML2、OIDC、JWT、OAuth2,嵌入场景常用 JWT。JWT 必需字段包括 sub、exp、jti 及路由属性;常用可选字段有 name、email、role、employee_id、title、department、location、phone、locale、timezone、groups 等。角色分为 Admin、Privileged、Editor、Participant。支持 comse 分隔或多值数组映射到多个实例,并支持通过 destination 参数深链到页面或卡片。
使用方式:需与 Domo CSM 配置 Identity Broker,提供实例 URL、认证方式、路由属性键及属性到实例的映射。所需环境变量为 IDP_URL、JWT_SECRET、KEY_ATTRIBUTE。服务端可用 Node.js/TypeScript 或 Python 生成 JWT,建议有效期 5 分钟,算法 HS256,jti 使用 UUID v4。
限制:只读嵌入使用 OAuth→embed token→POST 表单流程,编辑嵌入使用 JWT→Identity Broker URL→iframe src 流程,二者不同。KEY_ATTRIBUTE 名称需与 CSM 约定一致,映射值必须与 Domo 实例映射完全匹配。编辑嵌入按角色授予完整 Domo 会话,应保守分配角色,建议外部用户使用 Editor 或 Participant。切勿在客户端暴露 JWT_SECRET。其余细节暂未提供。