Skip to content

免登录流程

免登录对接

免登录是指用户在对接方系统中点击链接后，直接跳转到北极服务系统中，无需再次输入用户名和密码。需要对接方系统服务器侧实现如下步骤：

  1. 确保用户已在北极系统中存在，如果不存在，则需要先创建用户
  2. 基于用户的唯一标志（登录名、手机号或者邮箱）调用接口生成 authData
  3. 将 authData 拼接到网址的的 authData 参数中，生成免登录链接
  4. 用户点击链接，跳转到北极服务系统中，使用 authData 登录后无感知使用功能系统

需要注意的点：

  • https://host:port/#/?authData= + authData 数据，需注意路径中 # 要保留
  • 如果需要用户处于某个工作区，则需要保重用户已加入工作区，并且在生成 authData 的接口参数中带入 project_id
  • 添加用户到工作区参考文档添加用户到工作区

下面是一个简单的免登录网址样例：

https://hello.world/#/?authData=%7B%22uid%22%3A%22149ca8f3654c4ed469814969b88a3dd4%22%2C%22nickname%22%3A%22%E6%98%B5%E7%A7%B0%22%2C%22status%22%3A1%2C%22token%22%3A%22eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7InVpZCI6IjE0OWNhOGYzNjU0YzQ5Yjg4YTNkZDRlZDQ2OTgxNDk2Iiwic2Vzc2lvbiI6IjM6NWNmZGUzOTIwODc3NDU1YWJiMzhmZTIwMGJkMWRiNDMifSwiZXhwIjoxNjkxODA3NDUyfQ.SJNy8dox6A9QBREVSJL9NZV8ZopGKOuAUwPxl1cHVZA%22%2C%22t%22%3A1%2C%22tier%22%3A1%2C%22role%22%3A1%2C%22language%22%3A%22zh-CN%22%7D