跳到主内容

概述

目前,casdoor已经支持更灵活的邀请码方式进行用户注册。 一旦管理员以邀请码为必选项打开注册页面,用户只有拥有有效的邀请码才能注册。

添加邀请码到注册项

使用邀请码的主要有两种方式,默认添加的是一个随机字符串码,由随机数字和字母组成。 为了更灵活,邀请码还支持正则匹配来匹配多个不同的邀请码。 邀请

邀请属性

Casdoor通过以下属性管理邀请

  • Organization:拥有邀请的组织
  • Name:唯一的邀请名称
  • Display name:显示的邀请名称
  • Code:邀请码,你可以填写具体的邀请码字符串,也可以填写正则表达式
  • Default code:用于在邀请链接中填充默认的邀请码。 对于随机生成的邀请码,默认码与邀请码相同。 对于正则表达式形式的代码,你需要自己填写符合代码中的正则表达式规则的默认代码
  • Quota:邀请码可以使用的最大次数
  • Used count:邀请码已被使用的次数
  • Application:允许使用此邀请码的应用。 选择ALL使其对组织下的所有应用都可用
  • Username:使用此邀请注册时需要的特定用户名
  • Email:使用此邀请注册时需要的特定电子邮件
  • Phone:使用此邀请注册时需要的特定电话
  • State:邀请的状态

默认邀请

默认邀请中的邀请码是一个随机生成的数字和字母的字符串,且Quota设置为1,只能使用一次。 应用默认设置为ALL,这意味着对应此邀请的组织下的所有应用都可以使用此邀请码。

默认邀请

如果邀请码是为特定用户设置的,你希望用户使用给定的usernameemailphoneinvitation code注册,你可以通过填写相应的字段来限制用户的注册。 如果字段为空或者在注册页面上没有配置,casdoor不会强制验证这些字段

配置对应邀请码的用户信息

当需要重复使用邀请码时,你可以将Quota设置为一个较大的值,例如,如果你希望这个邀请码被使用10次,那么你可以将Quota设置为10。 当你希望停止使用此邀请码注册时,你也可以通过修改邀请的状态为Suspended来实现。

邀请配额和状态

注意事项

当在邀请中配置了usernameemailphone时,quota不应大于一。 这是因为用户的usernameemailphone应该是唯一的,多个用户不应该能够使用相同的usernameemailphone进行注册。

正则匹配邀请

有时候需要大量的邀请码进行用户注册,一一生成邀请码可能非常低效。 Casdoor支持通过正则表达式匹配来验证邀请码。 例如,通过将Code设置为"[a-z]2333",任何匹配此正则表达式的邀请码都将被成功匹配为有效的邀请码。

正则匹配邀请

备注

在使用正则表达式验证邀请码时,每个匹配正则表达式的邀请码只能使用一次,Quota仍然可以限制使用次数。 例如,当Code"[a-z]2333"Quota是2时,只有最多两个匹配正则表达式的邀请码可以成功使用。

邀请链接

Casdoor支持复制对应邀请的邀请链接。 邀请链接中的邀请码对应于Default code字段。 因此,对于使用正则表达式的邀请,必须手动填写Default code以生成正确的邀请链接。 此外,当使用邀请链接注册时,注册页面将自动填充由对应邀请码的邀请设置的某些字段信息。

邀请链接

对应邀请链接的注册页面

演示