Learn how to migrate your users from Gigya's IAM platform to Auth0.
Gigya Acquired by SAP
SAP announced an agreement to acquire Gigya's Customer Identity and Access Management (IAM) platform on September 24, 2017. The acquisition has now taken place. To learn about key features to reassess when your IAM platform is acquired, please check out SAP to Acquire Gigya: What's Next for Identity Management?
How to Migrate to Auth0 IAM Platform
At Auth0, our goal is to provide the best authentication and identity management solution that is also simple and easy for developers to work with. This means that migration into (and out of) the Auth0 platform is straightforward for developers while also providing a seamless experience for users.
Auth0 supports bulk user import as well as a user import/export extension to migrate existing users from another service into Auth0. Auth0 is also offering the database migration feature free to all Gigya customers.
Let's explore how these features work.
Note: Auth0 also provides a Gigya migration tutorial in the Docs here.
Set Up an Auth0 Application
An Auth0 Application represents your app and allows use of Auth0 for user authentication. You can create a new Application by signing into your Auth0 Dashboard and clicking on the + NEW APPLICATION button.
Doing so will present a screen like the one pictured below:
Enter a Name for your Application and select the type of technology, then click the Create button.
At this stage, there are two options to move your Gigya database contents into Auth0. You can export your Gigya users and then import them into your new Auth0 database, or you can enable automatic migration.
Important Note: The automatic migration option requires that the Gigya account subscription remains active until all users have signed in, since migration occurs at login. If the Gigya service or APIs will be heavily changed or sunsetted before you think your users will have a chance to log in on their own, you should use the Import Gigya Users to Auth0 option instead.
Import Gigya Users to Auth0
If you'd like to import your existing Gigya IAM users to Auth0, the next step is to create a database. You can click the Connections > Database item in the sidebar of the Dashboard, or visit the Database section of the Dashboard directly via this link. Click the + CREATE DB CONNECTION button to create a new database in Auth0.
You will then be presented with the following screen:
Fill in your desired database Name and other desired settings, then click the Create button.
Connect Database to Application
Now you'll need to connect your database with your Application. In the Applications tab of your database settings, find the Client you created under the Applications Using This Connection heading and toggle it to the "on" position. Your Application and database are now connected.
Export Gigya Users
The user export must be done from your Gigya account. Each Gigya customer has different needs, so the user data that will be exported may adhere to different schema. Auth0 expects a specific user schema. You can view Auth0's user schema in detail here.
You should follow the instructions in the IdentitySync documentation to transform your Gigya database's user data to Auth0's schema. For an example of a dataflow, check out Export from Gigya to SFTP. You can export your transformed data to one of the supported file formats. In this case, JSON is desired.
Import Users to Auth0 with User Import/Export Extension
You can now import users one of two different ways. First we'll cover using an Auth0 Extension. Click on the Extensions link in the Dashboard sidebar, or visit the Extensions section directly here. In the provided list, find the User Import / Export extension and install it.
Once the extension is installed, you can click it to open an import/export interface that looks like this:
You can now drag your exported Gigya users JSON file into the designated upload area and select the database you created earlier. Click the Start Importing Users button and your import will be underway.
Import Users to Auth0 with Management API
As an alternative option to using the User Import/Export extension, you can follow the instructions in the Bulk Import Users to Auth0 documentation to leverage the Auth0 Management API to create a job to add your users to your database. Simply upload your exported users JSON file and fill in the provided form to generate a curl command to import users:
Set Up Automatic Migration From Gigya to Auth0
Auth0's database migration feature will be enabled for no extra charge for Gigya customers who want to migrate their users to Auth0. This migration process is gradual and unobtrusive to users, but does require time. When a user logs in, their data is updated and added to Auth0's database. Because there is no bulk migration or forced password reset in this approach, if the movement of users to Auth0 is time-sensitive, you will likely want to use one of the import strategies detailed above instead.
The automatic database migration flow is as follows:
You can learn more about this process here: Migrate A User Database to Auth0.
This approach requires that the customer's Gigya account and APIs remain active until the migration is complete. If you're interested in taking this approach, you can set up a Custom Database in Auth0 and enable automatic migration by following the instructions here: Auth0: Enable Automatic Migration.
Migrating users into and out of Auth0's Identity and Access Management platform is simple! Auth0 provides a powerful and easy-to-use IAM solution for admins, developers, and end users. The Auth0 platform supplies robust extensibility and friendly user interface tools to help administrators manage user identities, including password resets, provisioning, blocking, and deleting users. Migration of users to and from Auth0 is easy, as is social IdP implementation, enterprise federation, Single Sign-On, and security features such as Multi-factor Authentication, and Breached Password Detection.