Skip to main content

Migration Guide

Migrating users from your existing identity system to cidaas is a critical step in your integration journey. This guide provides comprehensive information on all aspects of user migration, from planning to execution.

Migration Overview​

User migration involves transferring user accounts, credentials, and associated data from your legacy system to cidaas. The migration process ensures that your users can seamlessly continue using your services without interruption.

Planning Your Migration

Before starting the technical migration, review these planning guides:

  • Migration Planning Guide - Strategic guidance on merging sources, defining attributes, and handling social providers
  • Instance Setup Guide - Complete configuration guide for hosted pages, fields, consents, verification methods, and applications

Technical Implementation

For step-by-step technical guidance, see the User Migration Guide which covers API usage, data mapping, and security considerations.

Migration Procedures​

Choose the migration approach that best fits your requirements:

One-Time Migration​

Migrate all users at once from your legacy system. Ideal for:

  • Complete system replacement
  • Small to medium user bases
  • When you can schedule a maintenance window

Use when: You want to migrate all users in a single operation and then decommission the old system.

Long-Term Sync Migration​

Continuously synchronize users from your source system to cidaas. Ideal for:

  • Gradual migration
  • Large user bases
  • When you need to run both systems in parallel

Use when: You need to migrate users over an extended period while keeping both systems operational.

Bidirectional Sync Migration​

Keep user data synchronized in both directions between cidaas and your source system. Ideal for:

  • Complex system landscapes
  • When multiple systems need to stay in sync
  • Legacy system integration

Use when: You need to maintain synchronization between cidaas and your existing system in both directions.

Migration Topics​

Password Migration​

Learn how to migrate passwords with different hashing algorithms. Understand:

  • Supported hashing algorithms
  • Password hash format requirements
  • Migration mode configuration

Native Clients Migration​

Special considerations for migrating users from native mobile applications:

  • Mobile app user migration
  • Token migration
  • Device management

API Reference​

For detailed API documentation, see the User Migration API Reference.

Quick Start Checklist​

Use this checklist to get started with migration:

  • Complete Migration Planning (merging sources, defining attributes)
  • Review your current user data structure
  • Map source data fields to cidaas user entity structure
  • Choose the appropriate migration procedure
  • Configure migration mode in cidaas
  • Set up authentication for migration API (Client Credentials flow)
  • Test migration with a small user subset
  • Plan password migration strategy if applicable
  • Schedule migration window (for one-time migration)
  • Monitor migration progress
  • Verify migrated user data
  • Plan user communication strategy

For a comprehensive planning checklist, see the Migration Planning Guide.

Next Steps​

After completing user migration, proceed to the Integration Guide to learn about:

  • Best practices for integrating cidaas
  • Client-specific integration patterns
  • Available plugins and devkits
  • Advanced configuration options