Перейти до основного вмісту

Огляд

Casdoor зберігає користувачів у своїй таблиці user. При впровадженні Casdoor вам не потрібно мігрувати користувачів вручну — використовуйте синхронізатор для імпорту та підтримки актуальності даних користувачів з вашого наявного джерела.

Підтримувані синхронізатори​

Casdoor підтримує такі типи синхронізаторів:

Усі синхронізатори мають спільний інтерфейс, тому нові джерела можна додавати без зміни решти системи.

Підтримувані атрибути користувача​

Синхронізатори можуть зіставляти широкий набір атрибутів: дані профілю, облікові дані (паролі, WebAuthn, MFA), налаштування безпеки (білий список IP, верифікація) та активність (історія входів, зміни паролів). Складні дані (наприклад, облікові дані WebAuthn, Face ID) зберігаються у форматі JSON.

Синхронізація та виявлення змін​

Casdoor обчислює хеш для кожного користувача на основі таких полів, як пароль і телефон. Коли хеш для заданого Id користувача змінюється, Casdoor вважає цього користувача оновленим і застосовує зміну. Це дозволяє здійснювати двосторонню синхронізацію між таблицею користувачів Casdoor та системою-джерелом.

Порядок синхронізації та помилки​

Кожний запуск, чи то перший після увімкнення синхронізатора, запланований запуск, чи запущений кнопкою Sync, спочатку синхронізує групи, а потім користувачів, щоб групи, на які посилаються користувачі, вже існували. Це стосується всіх типів синхронізаторів. Для типів, що ще не підтримують групи (наприклад, Database), крок синхронізації груп виконується без дій.

Помилки не зупиняють синхронізатор або сервер Casdoor. Casdoor додає кожну помилку разом із часовою міткою до поля Error text синхронізатора: помилки першого запуску, запланованих запусків та синхронізації груп. Невдала синхронізація груп не зупиняє синхронізацію користувачів. Поле Error text зберігає останні 64 КБ.

Обробка паролів​

Якщо віддалене джерело не надає значення пароля для користувача (поле порожнє або не зіставлене), синхронізатор повністю пропускає колонку пароля та залишає наявний пароль у Casdoor незмінним. Це запобігає випадковому очищенню паролів, встановлених користувачами безпосередньо в Casdoor, віддаленими системами.