CloudDM 4.8.0 adds GreptimeDB as a DataSource
Skip to main content

WeCom authentication

WeCom identity provider verifies CloudDM sign-in before users access DataSources

Organizations that use WeCom can let users sign in to CloudDM with their organization-managed accounts. CloudDM manages WeCom 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 WeCom on the CloudDM sign-in page, their browser opens the WeCom sign-in page.
  • After sign-in, WeCom redirects the browser back to CloudDM with an authorization code.
  • CloudDM exchanges the code for user information and completes sign-in.

Configure the provider​

  1. Sign in to CloudDM with permission to manage integrations.
  2. Open Integrations > SSO and click Add.
  3. Select WeCom.
  4. Enter Corp ID, Agent ID, and App Secret, then choose a Default Role.
  5. Click Add.

Verify sign-in​

Sign out and select WeCom on the CloudDM sign-in page. Verify that authorization returns you to CloudDM and that a first-time user receives the configured default role.

WeCom app setup​

info

You can use the same app for sign-in and WeCom approvals, or configure them separately. Refer to the provider's official documentation for current field names and screens.

Before you begin

  1. Sign in to the WeCom admin console.
  2. Prepare a domain name that can reach your CloudDM deployment.

Create the app

  1. Open App Management > Apps > Create App. Create a WeCom app (Chinese interface)
  2. Enter the app details, set its availability to the members or departments that need CloudDM, and save it. App icons are available under Resource downloads. Enter WeCom app details (Chinese interface)

Configure the app

  1. Copy AgentId and Secret from the app details. Find the WeCom app credentials (Chinese interface)
  2. Copy the CorpId from the bottom of My Company. Find the WeCom company ID (Chinese interface)
  3. Under Web Authorization and JS-SDK in the app details, set the trusted domain and complete WeCom's domain verification. Configure the WeCom trusted domain (Chinese interface)
  4. Add the CloudDM server's public outbound IP address under Trusted Company IPs. Configure trusted company IPs (Chinese interface)
  5. Set the app homepage in the app details. Configure the WeCom app homepage (Chinese interface)

Open the app

  1. Open the WeCom client and find the CloudDM app in the workbench. Find CloudDM in the WeCom workbench (Chinese interface)
  2. Open the app and choose WeCom sign-in in CloudDM.

FAQ​

Sign-in reports that token retrieval failed with Remote host terminated the handshake.

Check Trusted Company IPs and confirm that the CloudDM server's current public outbound IP address is on the allowlist.