Lark syncer
The Lark syncer imports users from your Lark (飞书) organization into Casdoor. It authenticates as an app, walks the department tree recursively, and pulls each member's profile.
Необхідні умови
Create a Lark app at the Lark Open Platform. The app needs the following permissions:
contact:user.base:readonly— Read basic user infocontact:department.base:readonly— Read department structure
After publishing the app to your organization, copy the App ID and App Secret from the app's credentials page.
Конфігурація
Create a new syncer in Casdoor (Syncers → Add) and fill in:
| Поле | Значення |
|---|---|
| Організація | Target Casdoor organization |
| Name | A unique name for this syncer |
| Type | Жайворонок |
| Client ID | Your Lark App ID |
| Client Secret | Your Lark App Secret |
The database-related fields (database type, port, table name, etc.) are not used for the Lark syncer and can be left empty.
Field mappings
| Lark field | Casdoor field | Примітки |
|---|---|---|
user_id | Id | Stable internal user ID |
ім'я | DisplayName | User's display name |
електронна пошта | Електронна пошта | Primary email |
мобільний | Телефон | Mobile number |
avatar.avatar_origin | Аватар | Original-size avatar URL |
job_title | Заголовок | Job title |
стать | Стать | 1 = Male, 2 = Female |
OAuth login binding
When a user is synced from Lark, their Lark user_id is stored in the lark field on the Casdoor user. Synced users can sign in via the Lark OAuth provider without a separate account link step.
Running the syncer
Click Test Connection to verify your App ID and Secret before enabling. Toggle Is enabled for scheduled sync, or click Sync to run immediately.
The syncer fetches the complete department tree starting from the root, deduplicates users who belong to multiple departments, and handles pagination automatically.