自动登录

Shayan Taslim更新

自动登录功能可让 UserJot 将已登录用户的会话从你的产品带到公开反馈看板、路线图、更新日志、帮助中心和内嵌内容中,无需再次提示登录。

小组件可以自行识别用户;自动登录是工作区设置,允许系统使用该身份将用户登录到你的公开页面、内嵌内容和 Swift SDK。

启用自动登录

  1. 前往设置 → 登录。

  2. 在 Authentication 下,开启 Automatic login。

  3. 如需使用服务器验证的会话,也请启用要求签名令牌(启用自动登录后,此选项才会显示)。

自动登录仅适用于 Starter 或 Professional 套餐。免费套餐中可以看到此开关,但无法使用。

“要求签名令牌”的作用

普通的 uj.identify 调用会在浏览器中运行,访客可以对其进行编辑。启用 Require signed tokens 后,UserJot 会拒绝未签名的 identify 调用,要求将公司成员关系包含在签名令牌中(忽略未签名的客户端 companies,并显示 UNSIGNED_COMPANY_IGNORED 警告),并且只接受由你的服务器使用 HS256 JWT 签名的身份(或 Swift SDK 中的 HMAC-SHA256 签名)。请参阅 Signed identity,了解服务器端示例。

工作原理

  1. 前往设置 → 登录,开启自动登录。

  2. 在您的产品中安装小组件。

  3. 用户会话加载后调用 uj.identify(...)(如果需要,传入已签名的 token)。传入 email 只有在现有 UserJot 账户的电子邮件地址已确认时,才会关联到该账户。

  4. 从你的应用链接到公开的 UserJot URL(即你的 userjot.com 地址或自定义域名)。

HTML
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>

用户访问项目域名的链接时,SDK 会自动附加会话;你无需自行将令牌添加到 URL 中。调用 uj.identify 后,内嵌内容也会自动使用相同的交换机制。

JavaScript
if (user) {
  uj.identify({ token: user.userJotToken });
} else {
  uj.logout();
}

限制

  • 不适用于公开看板上的工作区管理员或所有者。 自动登录不会将工作区管理员或所有者登录到公开看板(测试看板自动登录时,请始终使用普通客户账户;团队成员可直接使用其 UserJot 账户登录公开看板,或通过 SSO 重定向登录)。在 in-app widget 中,已签名的 uj.identify 令牌可用于管理员和所有者,同步 traits 和 companies,同时保留由控制面板管理的姓名、头像和电子邮件地址不变。

  • 与单点登录不同。自动登录会将你应用内的小组件会话带入公开页面;单点登录则会将看板上的登录按钮替换为跳转到你自己的登录页面。

  • 严格模式会默认拒绝访问。启用要求签名令牌后,如果令牌缺失或无效,系统会通过 IDENTIFY_FAILED 拒绝 uj.identify,并保持访客未登录状态。

故障排除

用户仍然看到登录提示

  • 确认已在设置 → 登录中启用自动登录。

  • 确认在包含该链接的页面上已加载小组件 SDK,并且点击链接前已运行 uj.identify。

  • 确认链接指向正确的 userjot.com 子域名或自定义域名。

  • 请确认你没有使用工作区管理员或所有者的电子邮件地址测试公开看板自动登录。

已要求使用签名令牌,但登录仍然失败

  • 确认 uj.identify 接收的是使用 HS256 和当前 项目密钥签名的 token。

  • 确认 iss 与你的 项目 ID 一致,aud 为 userjot,并且 iat 和 exp 均为 Unix 秒数,且设置了 exp - iat <= 3600(有效期最长为 1 小时)。

  • 检查 uj.identify 返回的 Promise,查看其中的 IDENTIFY_FAILED。

后续步骤

这是否解答了您的问题?