Feishu authentication
Organizations that use Feishu can let users sign in to CloudDM with their organization-managed accounts. CloudDM manages Feishu as a separate SSO provider.
The provider screenshots in this guide show its Chinese interface.
How it works
- The integration uses OAuth 2.0.
- When users choose Feishu on the CloudDM sign-in page, their browser opens the Feishu sign-in page.
- After sign-in, Feishu redirects the browser back to CloudDM with an authorization code.
- CloudDM exchanges the code for user information and completes sign-in.
Configure the provider
- Sign in to CloudDM with permission to manage integrations.
- Open Integrations > SSO and click Add.
- Select Feishu.
- Enter App ID, App Secret, and API Timeout (seconds), then choose a Default Role.
- Click Add.
Verify sign-in
Sign out and select Feishu on the CloudDM sign-in page. Verify that authorization returns you to CloudDM and that a first-time user receives the configured default role.
Feishu app setup
info
You can use the same app for sign-in and Feishu approvals, or configure them separately. Refer to the provider's official documentation for current field names and screens.
Before you begin
- Sign in to the Feishu Open Platform and select your organization.
- If you already have an app, add your account under Custom App > Member Management. Otherwise, create one below.
Create the app
- Open App Development > Feishu Apps > Create App.

- Enter the app details and click Save. App icons are available under Resource downloads.

Configure the app
- In Credentials and Basic Information, copy App ID and App Secret.

- To read email addresses and mobile numbers at first sign-in, open Permission Management > Add Permissions > App Permissions and enable
contact:user.email:readonlyandcontact:user.phone:readonly. Without these permissions, users can enter their details when they first sign in.
- In Security Settings, add the CloudDM server's public outbound IP address to the allowlist and set the redirect URL to the CloudDM callback, such as
http://192.168.0.100:8222/callback/auth.
- In Version Management and Release, publish the app and set who can use it.
