分享链接
Omniscol中的分享链接是一个带签名的URL,无需事先登录即可访问以下内容:
- 某个班级或某位教师的课表,
- 指定的录入界面,例如可用时间,
- 以只读方式查看缺勤管理模块,
- 面向外部团队的特定视图(审核、沟通)。
公开课表的访问为只读。不过,某些内部分享链接可以允许有限的操作,例如填写某个指定的表单。典型的例子是教师可用时间的录入链接:学校可以连同截止日期发给教师,而无需为其创建Omniscol登录账户。
安全
每个链接都内嵌一个已签名的JWT。对于网页链接和API链接,签名取决于生成链接的账户及其密码的哈希值。对于iCal链接,校验哈希的构造原理相同。由此产生四个结果:
- 必须设置有效期——链接会在您选定的日期自动失效。这是一道重要的保护:不存在永久有效的链接。
- 更改密码后失效——如果创建链接的账户更改了密码(或改成相同的密码,这同样会改变随机盐值),该账户生成的所有链接会立即失效。
- 创建者账户失效则链接失效——如果该账户被停用或删除,它创建的链接将停止工作。
- 范围有限——链接只开放预设的视图或操作。请勿将其描述为对账户的全局访问。
如需面向大范围分发,请使用明确标识的服务账户,而不是个人账户。服务账户会成为所发出链接在管理上的创建者,当某次分享需要作废时,可以轮换或停用该账户。
与API令牌的区别
| 方面 | 分享链接 | API令牌 |
|---|---|---|
| 适用对象 | 在浏览器中的人 | 第三方软件 |
| 权限 | 范围受限,通常只读 | 取决于所选的接口 |
| 使用场景 | 临时分发 | 软件集成 |
| 认证 | URL中的JWT | Authorization请求头中的JWT |
| 所需级别 | 创建者的角色 | 管理权限 |
创建链接
分享按钮会出现在可分享的界面上(课表、可用时间、缺勤)。点击它,选择有效期,然后复制所需格式的URL。