Жайворонок
Це приклад того, як налаштувати провайдера OAuth Жайворонок.
Крок 1: Створіть додаток Жайворонок
Спочатку вам потрібно створити новий додаток на Платформі відкритих розробок Жайворонок та активувати його. Ви можете знайти App ID та App Secret у базовій інформації вашого додатку.

Далі, додайте URL перенаправлення <your-casdoor-domain>/callback (наприклад, http://localhost:7001/callback) у налаштуваннях безпеки вашого додатку.

Крок 2: Створіть провайдера OAuth Жайворонок
Тепер створіть провайдера OAuth Жайворонок у Casdoor. Заповніть необхідну інформацію.
| Назва | Назва в Жайворонок |
|---|---|
| Category | Choose OAuth |
| Type | Choose Lark |
| Client ID | App ID obtained from Step 1 |
| Client secret | App Secret obtained from Step 1 |

Тепер ви можете використовувати Жайворонок як сторонній сервіс для завершення аутентифікації.
Username Handling
Casdoor uses a fallback mechanism to ensure user accounts are created successfully even when Lark's OAuth response has incomplete data. The username field follows this priority:
- UserId - Primary identifier used when available
- UnionId - Links users across multiple Lark organizations
- OpenId - Always present, used as final fallback
This ensures authentication succeeds reliably since OpenId is guaranteed in Lark's OAuth response.