Огляд
Casdoor зберігає користувачів у своїй таблиці user. При впровадженні Casdoor вам не потрібно мігрувати користувачів вручну — використовуйте синхронізатор для імпорту та підтримки актуальності даних користувачів з вашого наявного джерела.
Підтримувані синхронізатори
Casdoor підтримує такі типи синхронізаторів:
- Database: Синхронізація користувачів з будь-якої бази даних, що підтримується Xorm (MySQL, PostgreSQL, SQL Server, Oracle, SQLite). Див. синхронізатор бази даних.
- Azure AD: Синхронізація користувачів з Azure Active Directory за допомогою Microsoft Graph API. Див. синхронізатор Azure AD.
- Active Directory: Синхронізація користувачів з Microsoft Active Directory через LDAP. Див. синхронізатор Active Directory.
- Google Workspace: Синхронізація користувачів з Google Workspace за допомогою Admin SDK API. Див. синхронізатор Google Workspace.
- Keycloak: Імпорт користувачів безпосередньо з баз даних Keycloak. Див. синхронізатор Keycloak.
- Okta: Синхронізація користувачів з Okta через API користувачів Okta. Див. синхронізатор Okta.
- SCIM: Витяг користувачів з будь-якого постачальника ідентифікації, сумісного з SCIM 2.0. Див. синхронізатор SCIM.
- AWS IAM: Імпорт користувачів та груп з облікового запису AWS через API IAM. Див. синхронізатор AWS IAM.
- WeCom: Отримання користувачів з організацій WeCom через API. Див. синхронізатор WeCom.
- DingTalk: Імпорт користувачів з організацій DingTalk через API. Див. синхронізатор DingTalk.
- Lark: Імпорт користувачів з організацій Lark (Feishu) через API відкритої платформи Lark. Див. синхронізатор Lark.
Усі синхронізатори мають спільний інтерфейс, тому нові джерела можна додавати без зміни решти системи.
Підтримувані атрибути користувача
Синхронізатори можуть зіставляти широкий набір атрибутів: дані профілю, облікові дані (паролі, WebAuthn, MFA), налаштування безпеки (білий список IP, верифікація) та активність (історія входів, зміни паролів). Складні дані (наприклад, облікові дані WebAuthn, Face ID) зберігаються у форматі JSON.
Синхронізація та виявлення змін
Casdoor обчислює хеш для кожного користувача на основі таких полів, як пароль і телефон. Коли хеш для заданого Id користувача змінюється, Casdoor вважає цього користувача оновленим і застосовує зміну. Це дозволяє здійснювати двосторонню синхронізацію між таблицею користувачів Casdoor та системою-джерелом.
Порядок синхронізації та помилки
Кожний запуск, чи то перший після увімкнення синхронізатора, запланований запуск, чи запущений кнопкою Sync, спочатку синхронізує групи, а потім користувачів, щоб групи, на які посилаються користувачі, вже існували. Це стосується всіх типів синхронізаторів. Для типів, що ще не підтримують групи (наприклад, Database), крок синхронізації груп виконується без дій.
Помилки не зупиняють синхронізатор або сервер Casdoor. Casdoor додає кожну помилку разом із часовою міткою до поля Error text синхронізатора: помилки першого запуску, запланованих запусків та синхронізації груп. Невдала синхронізація груп не зупиняє синхронізацію користувачів. Поле Error text зберігає останні 64 КБ.
Обробка паролів
Якщо віддалене джерело не надає значення пароля для користувача (поле порожнє або не зіставлене), синхронізатор повністю пропускає колонку пароля та залишає наявний пароль у Casdoor незмінним. Це запобігає випадковому очищенню паролів, встановлених користувачами безпосередньо в Casdoor, віддаленими системами.