Огляд
Наразі 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. Тому, для запрошень, що використовують регулярні вирази, стандартний код має бути заповнений вручну для генерації правильного посилання на запрошення. Крім того, при реєстрації за допомогою посилання на запрошення, сторінка реєстрації автоматично заповнює певну інформацію поля, встановлену запрошенням, що відповідає коду запрошення.