GenAuth DocsDocuments
Concepts
User Guide
Development Integration
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Concepts
User Guide
Development Integration
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Old version
User Guide
  • Quick Start

  • Authentication

  • Access Control

  • Authorization

  • Adaptive MFA

  • User Account Management

  • User Directory Management

  • Applications

  • Become a Federation Authentication Identity Provider

  • Connect External Identity Providers (IdP)

  • WeChat Ecosystem Full Scenario Capabilities

  • Migrate Users to GenAuth

  • Security Settings

  • Branding

  • Automation

  • Audit Logs

  • Setting

  • FAQ

¶ Lazy migration of users to GenAuth

Update time: 2025-04-11 11:21:15
Edit

¶ Migration process

GenAuth supports smooth migration of users from a custom database to GenAuth without downtime. When this function is enabled, the following effects will be produced on login and registration requests:

Authentication request:

  • The user will use the custom data script you configured to authenticate the user for the first time. After successful authentication, it will be migrated to the GenAuth database. Otherwise, it will prompt that the user does not exist or the password is incorrect.
  • The user does not need to change the account password.
  • The user's subsequent authentication will go through the GenAuth database.
  • When all users have been successfully authenticated at least once, the database migration is completed smoothly.

Registration request:

  • When registering a user, it will first check whether it exists in the GenAuth database. If it already exists, an error prompt will be returned.
  • If the user does not exist in the GenAuth database, the getUser interface will be used to check whether the user exists in the custom database. If it already exists, an error prompt will be returned.
  • If the user does not exist in both the GenAuth database and the custom database, the registration is successful.

¶ Configuration script

You need to write the Login and Search user scripts in the GenAuth console (opens new window), Connect to identity source - Custom database page. For details, please see:

  • [Write login script](./configuration/#Write database operation script).
  • [Write search user script](./configuration/#Write database operation script).

¶ Verify the migration effect

After you enable user data migration, you can verify the fully migrated users in the following ways:

  • Use the [management API to get a list of users or search for users](/reference/sdk-for-node/management/UsersManagementClient.md#Get a list of users).
  • View users in the GenAuth console (opens new window) User Management - User List page.

¶ After user migration is complete

After all users have been migrated, close the custom database.

  • Migration process
  • Configuration script
  • Verify the migration effect
  • After user migration is complete

User identity management

Integrated third-party login
Customized authentication process

Enterprise internal management

Single sign-on
Multi-factor authentication
Permission management

Developer

Development Documentation
GitHub (opens new window)

Company

official@genauth.ai
16th Floor, Building B, Beichen Century Center, Chaoyang District, Beijing (Total)
Room 406, 4th Floor, Block B, No. 200, Tianfu Fifth Street, High-tech Zone, Chengdu (Branch)

© Beijing Steamory Technology Co., Ltd.