Bulk migration
The bulk migration strategy allows you to move all your user data to Authgear at once using the User Import API. Bulk migration is ideal when you want to stop using your old authentication system immediately and start using Authgear.
Once you import your users, you'll need to implement a middleware or server-side logic that uses Authgear user sessions to protect resources. As a result, all users will be logged out and will be required to log in again using Authgear's authentication flow.
In this guide, you'll learn how to move your user data from your old authentication provider to Authgear using the bulk migration strategy.
Step 1: Export User Data from Old System
Export all your user data from the old authentication system you're moving from.
The following example shows rows in the users
table of an application.
You can export users from any authentication system, including your own custom-built system. Then, reformat the data to match Authgear's Import User API schema.
Step 2: Reformat User Data into Support JSON Format
Reformat your exported user data to a JSON document that follows the Import User API schema.
You can then use the reformatted JSON document with the Import API to import your user data.
Here's the example users
table from earlier reformatted:
Step 3: Import Formatted User Data
Import your formatted user data you formatted via a POST HTTPS request to the _api/admin/users/import
endpoint of the User Import API.
The above JavaScript code imports the data from our example users
table using the Import User API. The API requires a valid Admin API JWT for authentication.
Learn more about using the Import User API here.
Step 4: Use Authgear Session in Middleware or Server-side Logic
Now that you have successfully imported your users to Authgear, you can start using Authgear session to protect the pages in your application.
To do this, implement a middleware or server-side logic that uses Authgear session.
Note: Deploying the middleware or server-side logic that uses Authgear session means all users will be logged out and be required to log in again using Authgear's authentication flow.
The following is an example of a simple Express.js application with a middleware that uses Authgear session:
This example app uses the "Bearer <access token>" to protect the /protected
route. Learn more about verifying access tokens and using Authgear in your backend here.
Step 5: Authenticate Your Users with Authgear
Update your app to allow users to log back in using Authgear's authentication flow.
You can use any of our SDKs for the following platforms to integrate Authgear into your app seamlessly:
Or manually add Authgear as an OAuth 2.0 provider.
Done! Now, your user can log in to your app and use the same user account from your old authentication provider.
Last updated
Was this helpful?