分享链接

Omniscol中的分享链接是一个带签名的URL,无需事先登录即可访问以下内容:

  • 某个班级或某位教师的课表,
  • 指定的录入界面,例如可用时间,
  • 以只读方式查看缺勤管理模块,
  • 面向外部团队的特定视图(审核、沟通)。

公开课表的访问为只读。不过,某些内部分享链接可以允许有限的操作,例如填写某个指定的表单。典型的例子是教师可用时间的录入链接:学校可以连同截止日期发给教师,而无需为其创建Omniscol登录账户。

安全

每个链接都内嵌一个已签名的JWT。对于网页链接和API链接,签名取决于生成链接的账户及其密码的哈希值。对于iCal链接,校验哈希的构造原理相同。由此产生四个结果:

  1. 必须设置有效期——链接会在您选定的日期自动失效。这是一道重要的保护:不存在永久有效的链接。
  2. 更改密码后失效——如果创建链接的账户更改了密码(或改成相同的密码,这同样会改变随机盐值),该账户生成的所有链接会立即失效。
  3. 创建者账户失效则链接失效——如果该账户被停用或删除,它创建的链接将停止工作。
  4. 范围有限——链接只开放预设的视图或操作。请勿将其描述为对账户的全局访问。

如需面向大范围分发,请使用明确标识的服务账户,而不是个人账户。服务账户会成为所发出链接在管理上的创建者,当某次分享需要作废时,可以轮换或停用该账户。

与API令牌的区别

方面 分享链接 API令牌
适用对象 在浏览器中的人 第三方软件
权限 范围受限,通常只读 取决于所选的接口
使用场景 临时分发 软件集成
认证 URL中的JWT Authorization请求头中的JWT
所需级别 创建者的角色 管理权限

创建链接

分享按钮会出现在可分享的界面上(课表、可用时间、缺勤)。点击它,选择有效期,然后复制所需格式的URL。

另请参阅