Configure Feishu SSO for Verdent Team
Connect Feishu to Verdent Team for centralized enterprise sign-in
Verdent Team supports Feishu single sign-on (SSO). Once configured, members with an approved corporate email domain can verify their identity with their company Feishu account.
Feishu SSO lets your team use its existing identity system, reduces separate credentials, and gives the Team Owner one place to manage access.
How Feishu SSO works
The Team Owner creates a custom enterprise app in the Feishu Open Platform, then adds its credentials and corporate email domains to Verdent Team.
When a member enters a matching corporate email on the Verdent sign-in page, Verdent sends them to Feishu for authorization and verifies the email returned by Feishu.
Members must have a corporate email in the Feishu directory. Members without one cannot sign in through Feishu SSO.
Before you begin
You need:
- A Feishu enterprise administrator account that can create custom apps
- Owner access to the Verdent Team
- Your team's corporate email domain, such as
yourcompany.com
Setup usually takes about 5 minutes.
Open the SSO settings
- Sign in to Verdent and switch to the Team you want to configure.
- Open Settings in the Team console.
- Select SSO.
- Click Connect SSO.
Keep Verdent and the Feishu Open Platform open while you complete the setup.
Configure the Feishu app
Create a custom enterprise app
Open the Feishu Open Platform, enter the Developer Console, and click Create custom enterprise app. Enter a name, upload an icon, and create the app.
Get the app credentials
Open Credentials & Basic Info and locate the App ID and App Secret:
| Feishu credential | Verdent SSO field |
|---|---|
| App ID | Client ID |
| App Secret | Client Secret |
Treat the App Secret as a password. If you reset it in Feishu, update the Client Secret in Verdent.
Add the redirect URL
Open Development Configuration → Security Settings and add this Redirect URL:
https://login.verdent.ai/passport/sso/callbackThe URL must match exactly: use https, do not add a trailing /, and remove surrounding spaces. An incorrect value causes Feishu error 20029.
Grant permissions
Open Development Configuration → Permissions and grant:
| Permission | Scope |
|---|---|
| Read basic user information | contact:user.base:readonly |
| Read user email information | contact:user.email:readonly |
Verdent uses these permissions to identify members by name and corporate email.
Publish the app
Open Version Management & Release, create a version, and submit it for release. Members can use the app only after it is published.
Complete the connection in Verdent
Return to the Feishu SSO configuration in Verdent and enter:
| Verdent field | Value |
|---|---|
Client ID | Feishu App ID |
Client Secret | Feishu App Secret |
Email domain | Corporate email domain |
You can add up to 5 corporate domains. Public domains such as Gmail are not supported.
Save the configuration and confirm that Feishu SSO is enabled on its configuration card. You can disable it temporarily without deleting the connection.
Member sign-in experience
After SSO is enabled, members:
- Enter an email from a configured domain on the Verdent sign-in page.
- Confirm that they want to continue with SSO.
- Authorize access in Feishu.
- Return to Verdent after authorization.
If the entered email differs from the corporate email returned by Feishu, Verdent asks the member to confirm the Feishu email and uses it for authentication.
Test and manage the configuration
Before rolling SSO out to everyone, test it with a regular member whose Feishu account has a corporate email. Sign out, enter that email, complete Feishu authorization, and confirm that the member returns to Verdent and can access the Team.
From Team → Settings → SSO, the Team Owner can view domains and connection status, enable or disable SSO, update credentials, reconfigure a failed connection, or delete it.
Troubleshooting
Feishu error 20029: Invalid redirect URL
In Feishu, open Development Configuration → Security Settings and confirm that https://login.verdent.ai/passport/sso/callback was added exactly as shown.
Verdent says the Client ID or Client Secret is invalid
Copy the App ID and App Secret again from Credentials & Basic Info. If the secret was reset, use the latest value.
The app is unavailable during sign-in
Confirm that you created and published a version under Version Management & Release.
The email is empty after sign-in
Add a corporate email to the member's profile in the Feishu directory, then try again.
The member is not sent to Feishu SSO
Confirm that the email matches a configured domain and that Feishu SSO is enabled in Verdent.