Обзор

В настоящее время 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. Следовательно, для приглашений, использующих регулярные выражения, стандартный код должен быть заполнен вручную для генерации правильной ссылки на приглашение. Кроме того, при регистрации с использованием ссылки на приглашение, страница регистрации автоматически заполнит определенную информацию поля, установленную приглашением, соответствующим пригласительному коду.

Демонстрация