docs-web-logo
使用指南

配置关联规则

关联规则主要包含匹配逻辑和未匹配逻辑，本文将指导您如何配置认证源关联规则。

第一步：匹配规则

匹配规则是指当您使用认证源进行SSO登录成功时，通过配置哪组属性字段将认证源中的用户和OneID中的用户匹配成功。

举例：

假设认证源中有用户甲、用户乙，俩人信息如下：

姓名用户唯一标识手机号邮箱用户登录名
甲ABC12345616012020101abc@163.comabcTest
乙ABC98765416088890009xyz163.comxyzTest

OneID中有用户甲一、甲二、甲三、甲四、乙一、乙二，四人信息如下：

姓名用户ID手机号邮箱登录用户名
甲一XYZ12345616012020101无无
甲二DEF123456无abc@163.com无
甲三HMN123456无无abcTest
甲四ABC123456无无BestTest
乙一XYZ98765416088890009无无

配置单匹配项

场景一：如果匹配逻辑配置为「用户唯一标识」等于「用户ID」；如图： img 此时，当用户通过认证源中甲进行SSO登录成功时，OneID登录后配成功甲四；

场景二：如果匹配逻辑配置为「手机号」等于「手机号」；如图： img 此时，当用户通过认证源中甲进行SSO登录成功时，OneID登录后配成功甲一；

场景三：如果匹配逻辑配置为「邮箱」等于「邮箱」；如图： img 此时，当用户通过认证源中甲进行SSO登录成功时，OneID登录后配成功甲二；

场景四：如果匹配逻辑配置为「用户登录名」等于「登录用户名」；如图： img 此时，当用户通过认证源中甲进行SSO登录成功时，OneID登录后配成功甲三；

配置双匹配项

场景五：如果匹配逻辑配置为「用户唯一标识」等于「用户ID」或「手机号」等于「手机号」；如图： img 此时，当用户通过认证源中乙进行SSO登录成功时，OneID登录后配成功乙一；

同时，如果认证源中需要匹配的字段不在默认字段中时，您可以通过「自定义脚本」方式进行配置。具体您可以参考自定义脚本。

第二步：新建用户规则

当您使用认证源进行SSO登录成功，但是通过匹配规则未能找到对应的OneID用户时。此时OneID提供两种执行逻辑。

  1. OneID拒绝此用户登录。
  2. OneID通过认证源登录成功时返回的用户属性字段进行新建用户并登录。即：JIT模式（Just In Time）及时录入

新建用户规则项

  1. 管理员可以根据用户数据要求及认证源侧数据规则进行配置新建用户属性字段匹配项。
  2. OneID要求用户姓名必须啊填写，否则将新建失败。所以，「user.name 用户姓名」无法删除。
  3. OneID要求用户联系手机号、联系邮箱和登录用户名三个属性字段中至少填写其中一项。所以，如果三项全部删除将无法保存成功。
  4. 新建用户规则必须和匹配规则保持一致，否则新建的成功的用户，在下一次登录时，仍匹配失败，进而导致反复创建用户。所以，OneID在配置新建用户规则时，会自动关联匹配规则。关联的规则无法在新建用户规则中修改和删除，只能通过匹配规则修改和删除，新建用户规则会自动关联变化。 img

如果认证源中需要配置的字段不在默认字段中时，您可以通过「自定义脚本」方式进行配置。具体您可以参考自定义脚本。