User Management Overview

cidaas User Management provides capabilities for creating, managing, and organizing user accounts. This guide introduces core concepts and workflows.

Quick Reference

Task	Method	Guide
Add Users	Self-registration, Admin creation, Invitations	User Onboarding
Configure Registration	Set required/optional fields	Field Settings
Update Profiles	User or admin updates	Update Account
Organize Users	Groups and roles	User Groups
Search Users	Advanced search filters	User Search

cidaas supports three ways to add users:

Method	How It Works	Use Case	Guide
Self-Registration	User completes form → Verification email → Login	Public-facing apps	Register User
Admin-Created	Backend creates via API → Welcome email → Login	Automated provisioning	Create User
Invitations	Admin sends invite → User completes → Auto-assigned to groups	Controlled onboarding	Invite User

First Step: Configure registration fields

Task	Process	Configuration	Guide
User Registration	Form → Account created → Verification email → Login	Set fields, enable verification	Register User
Email/Phone Change	Request → Code sent → Verify → Updated	Auto-enabled	Email/Mobile Change
Profile Updates	User/admin updates → Saved (with verification if required)	Configure editable fields	Update Account
Account Linking	Merge accounts from different login methods	Configure linking	Account Linking

Component	Description
Unique ID (`sub`)	Unique identifier for each user
Login Methods	Email, phone, username, or social login (Google, Facebook, etc.)
Profile Data	Standard fields (name, email, phone) + custom fields
Account Status	Verified, pending verification, or declined

Concept	Purpose	Example
Groups	Organize users into collections	"Employees", "Customers", "Admins"
Roles	Define what users can do	"Admin" (create/delete users), "User" (view own profile)

Key Point: Roles are assigned within groups. Users can belong to multiple groups with different roles in each.

Feature	Description	Guide
Progressive Registration	Collect additional user data over time	Progressive Registration
User Search	Advanced search and filtering	User Search
User Deletion	Remove accounts and handle data retention	User Deletion
Account Structure	Deep dive into data model	Account Structure