EduOpenAI Core 文档/其他网校域名接入
其他网校域名接入
注册域名 → 后台白名单审核 → iframe/直链调用 → 防盗链生效
除智训宝Pro 外，其他网校（或客户自建站点）也可以将 EduOpenAI Core 生成的互动课堂嵌入自己的页面播放。核心路径：注册域名 → 后台白名单审核 → 播放调用（iframe/直链）→ 防盗链生效。
接入流程
- 确认课堂可发布：课堂已生成完成，且资产发布授权为「允许」（/my-assets 或 /admin 资产管理中确认）
- 提交域名申请（apply）：用户/运营在 /admin「白名单管理」提交域名申请，填写目标网校域名（如
study.school.com）与可见性范围；提交后状态为applied - 管理员审核（review）：管理员在「白名单管理」对申请执行审核，通过后状态
applied → active，启用后即可播放；对失效/违规域名可随时撤销（revoke），撤销后立即停止放行 - 配置播放白名单：若需 iframe 嵌入，
ALLOWED_FRAME_ANCESTORS构建时加入该域名（需重新 build） - 引用播放链接：在网校课时/页面中以 iframe 或直链引用课堂播放地址（见下方调用方式）
- 验证防盗链：播放请求带目标域名 Referer，白名单命中即放行；未命中返回 403
提示
OSS Referer 配置：Bucket 的 Referer 白名单需与
data/referer-whitelist.json 中 active 域名清单保持一致，播放时两层白名单同时命中才能正常加载 OSS 播放资源；任何一侧新增/撤销域名后，须同步另一侧配置。调用方式
| 方式 | 说明 | 适用场景 |
|---|---|---|
| iframe 嵌入 | <iframe src="{播放地址}" …></iframe>，需 CSP frame-ancestors + 防盗链白名单双放行 | 网校课程页内嵌互动课堂 |
| 直链跳转 | 课堂播放地址直接作为页面/按钮链接，新窗口打开 | 简单入口/预告页 |
| 静态播放产物 | 已发布课堂的 OSS 静态版（index.html），无需 Core 服务端 | 离线/轻量播放 |
播放地址与鉴权
- 在线课堂：
https://maic.eduopenai.com/classroom/{id}（生产环境切换为 www.eduopenai.com） - URL 令牌鉴权：站点配置 ACCESS_CODE 时，请求需携带
?access_code={ACCESS_CODE}（跨域 iframe 不依赖 Cookie） - 防盗链白名单：
data/referer-whitelist.json中 applied→active 的域名生效；public 可见性资产直接放行
与「发布到智训宝」的关系
「发布到智训宝」是面向智训宝Pro 的完整发布链路（课堂 → OSS 静态产物 → 创建课时 → 课时内 iframe 嵌入）；本页面向其他网校/自建站点：只要课堂已发布（OSS 产物存在）且目标域名通过白名单，即可直接引用播放地址。
注意
生产环境上线（www.eduopenai.com）后，播放地址与 CORE_BASE_URL 需同步切换为生产域名；域名接入申请联系运营（管理员在 /admin 白名单管理审核）。