集成概览
Omniscol可以通过多种方式接入您的信息系统,您可以按需选择。
概览表
| 方式 | 用途 | 数据流向 |
|---|---|---|
| iCal | 让教师、学生在个人日历中查看自己的课表 | Omniscol → 日历 |
| 分享链接 | 以只读方式发布课表,或按场景开放定向录入 | Omniscol → 公开网页 |
| Iframe | 将课表嵌入与Omniscol同一域名下的页面;在外部网站上会被阻止(出于安全考虑) | Omniscol → 同一域名 |
| Omniscol API | 系统之间的集成,权限与选项取决于账户 | 取决于配置 |
| MCP | 将兼容MCP的AI智能体连接到Omniscol | AI智能体 ↔ Omniscol |
| OAuth2 / OIDC(服务端) | 连接第三方服务:需注册客户端、用户授权,并使用限定范围的令牌(MCP和OneRoster的基础) | 服务 ↔ Omniscol |
| OIDC / SSO(登录) | 通过身份提供方(Google Workspace、Microsoft Entra ID、通用OIDC)验证用户身份 | 取决于配置 |
| 与外部系统同步 | 连接器框架:Aurion、Auriga、Edusign,其他连接器按项目添加 | 双向 |
| 信息显示屏 | 在公共屏幕上显示课表 | Omniscol → 屏幕 |
选择合适的集成方式
- 向教师、学生发布课表——订阅 iCal。
- 向家长或审计人员开放只读访问—— 分享链接。
- 从您的ERP / 信息系统同步学生——参见 与外部系统同步,其中列出了可用的连接器。如果列表中没有您的ERP, 请与Omniscol支持团队商定新增连接器。
- 单点登录——OIDC / SSO。
- 外部AI助手接入账户(需已启用该选项)—— 兼容的客户端使用MCP。
- 在校内公共区域显示—— 信息显示屏。
安全最佳实践
- 在已启用OIDC / SSO时,用它来验证真实用户的身份。
- API令牌仅用于系统之间的集成,权限范围保持最小,并定期轮换。
- 为分享链接设置较短的有效期。
- 不要把API令牌放进公开的Git仓库。