概述
目前,casdoor已经支持更灵活的邀请码方式进行用户注册。 一旦管理员以邀请码为必选项打开注册页面,用户只有拥有有效的邀请码才能注册。
使用邀请码的主要有两种方式,默认添加的是一个随机字符串码,由随机数字和字母组成。 为了更灵活,邀请码还支持正则匹配来匹配多个不同的邀请码。
邀请属性
Casdoor通过以下属性管理邀请
Organization
:拥有邀请的组织Name
:唯一的邀请名称Display name
:显示的邀请名称Code
:邀请码,你可以填写具体的邀请码字符串,也可以填写正则表达式Default code
:用于在邀请链接中填充默认的邀请码。 对于随机生成的邀请码,默认码与邀请码相同。 对于正则表达式形式的代码,你需要自己填写符合代码中的正则表达式规则的默认代码Quota
:邀请码可以使用的最大次数Used count
:邀请码已被使用的次数Application
:允许使用此邀请码的应用。 选择ALL
使其对组织下的所有应用都可用Username
:使用此邀请注册时需要的特定用户名Email
:使用此邀请注册时需要的特定电子邮件Phone
:使用此邀请注册时需要的特定电话State
:邀请的状态
默认邀请
默认邀请中的邀请码是一个随机生成的数字和字母的字符串,且Quota
设置为1,只能使用一次。 应用默认设置为ALL
,这意味着对应此邀请的组织下的所有应用都可以使用此邀请码。
如果邀请码是为特定用户设置的,你希望用户使用给定的username
、email
、phone
和invitation code
注册,你可以通过填写相应的字段来限制用户的注册。 如果字段为空或者在注册页面上没有配置,casdoor不会强制验证这些字段
当需要重复使用邀请码时,你可以将Quota
设置为一个较大的值,例如,如果你希望这个邀请码被使用10次,那么你可以将Quota
设置为10。 当你希望停止使用此邀请码注册时,你也可以通过修改邀请的状态为Suspended
来实现。
当在邀请中配置了username
、email
或phone
时,quota
不应大于一。 这是因为用户的username
、email
和phone
应该是唯一的,多个用户不应该能够使用相同的username
、email
或phone
进行注册。
正则匹配邀请
有时候需要大量的邀请码进行用户注册,一一生成邀请码可能非常低效。 Casdoor支持通过正则表达式匹配来验证邀请码。 例如,通过将Code
设置为"[a-z]2333"
,任何匹配此正则表达式的邀请码都将被成功匹配为有效的邀请码。
在使用正则表达式验证邀请码时,每个匹配正则表达式的邀请码只能使用一次,Quota
仍然可以限制使用次数。 例如,当Code
是"[a-z]2333"
且Quota
是2时,只有最多两个匹配正则表达式的邀请码可以成功使用。
邀请链接
Casdoor支持复制对应邀请的邀请链接。 邀请链接中的邀请码对应于Default code字段。 因此,对于使用正则表达式的邀请,必须手动填写Default code以生成正确的邀请链接。 此外,当使用邀请链接注册时,注册页面将自动填充由对应邀请码的邀请设置的某些字段信息。