Quick Start Guide - Multi-Method Authentication

Get started with Fabrixly-IDS multi-method authentication in 5 minutes.

Prerequisites

• Node.js 16+ installed
• PostgreSQL running

Servers started:

npm run start:server    # Identity Server (port 3000)
cd console && npm run dev  # Console (port 5173)
cd test-client && npm start  # Test Client (port 4000)

Step 1: Choose Your Authentication Mode

Fabrixly-IDS supports 4 authentication modes:

Step 2: Configure Your Client

Option A: Using Admin Console (Recommended)

1. Login as System Admin
   • Email: sysadmin@system.com
   • Password: admin123
2. Navigate to Clients
   • Click "Clients" in sidebar
3. Edit Client
   • Find "Client App 1"
   • Click edit icon
4. Configure Authentication
   • Go to "User Authentication" tab
   • Select your preferred mode
   • Toggle mobile login if needed
   • Choose OTP delivery method
   • Click "OK" to save

Open Console

https://ids.fabrixly.com

Option B: Using Test Scripts (Quick)

# For 2FA (recommended for testing)
npx ts-node src/scripts/test-2fa.ts

# For passwordless
npx ts-node src/scripts/test-otp-only.ts

# For flexible mode
npx ts-node src/scripts/test-flexible.ts

# View current configuration
npx ts-node src/scripts/view-auth-config.ts

Step 3: Test Authentication

1. Click "Login with SSO"
2. Follow the flow based on your mode:Password Only:OTP Only:2FA:Flexible:
   • Enter: alice@examplecorp.com
   • Enter: password123
   • Click "SIGN IN"
   • ✓ Immediate login
• Enter: alice@examplecorp.com
• Click "SEND OTP"
• Check server console for OTP
• Enter OTP code
• Click "VERIFY OTP"
• ✓ Login complete
• Enter: alice@examplecorp.com
• Enter: password123
• Click "CONTINUE"
• Check server console for OTP
• Enter OTP code
• Click "VERIFY OTP"
• ✓ Login complete
• Option 1: Enter email + password → Immediate login
• Option 2: Enter email only → OTP flow

Open Test Client

https://ids.fabrixly.com

Step 4: Find Your OTP Code

During development, OTP codes are logged to the server console:

# Look for this in your server terminal:
[CommunicationService] Generated OTP: 123456 for user: <user-id>
[CommunicationService] OTP: 123456

Copy the 6-digit code and enter it in the login form.

Test Users

Use these credentials for testing:

Alice:

• Email: alice@examplecorp.com
• Password: password123
• Mobile: +1234567890 (if mobile login enabled)

Bob:

• Email: bob@examplecorp.com
• Password: password123

Common Scenarios

Scenario 1: Enable Passwordless Login

# Configure OTP-only mode
npx ts-node src/scripts/test-otp-only.ts

# Test
1. Go to https://ids.fabrixly.com
2. Click "Login with SSO"
3. Enter email only
4. Get OTP from console
5. Login with OTP

Scenario 2: Add Two-Factor Authentication

# Configure 2FA mode
npx ts-node src/scripts/test-2fa.ts

# Test
1. Go to https://ids.fabrixly.com
2. Enter email + password
3. Get OTP from console
4. Complete 2FA

Scenario 3: Enable Mobile Login

# Configure mobile login
npx ts-node src/scripts/test-mobile-login.ts

# Test
1. Login with: +1234567890
2. Instead of: alice@examplecorp.com

Troubleshooting

OTP Not Showing?

• Check server console output
• Look for [CommunicationService] logs
• Verify OTP delivery method is configured

Login Form Looks Wrong?

• Clear browser cache
• Refresh the page

Check client configuration:

npx ts-node src/scripts/view-auth-config.ts

Can't Login?

• Verify credentials (see Test Users above)
• Check auth mode configuration
• Ensure servers are running
• Check server logs for errors

Next Steps

1. Explore Other Modes
   • Try all 4 authentication modes
   • Test mobile number login
   • Experiment with different configurations
2. Read Full Documentation
   • Authentication Guide
   • Configuration Reference
   • Security Best Practices
3. Customize for Your App
   • Configure via Console UI
   • Adjust OTP delivery method
   • Set up team-based access
4. Production Setup
   • Configure email/SMS service
   • Enable HTTPS
   • Set up rate limiting
   • Review security settings

Quick Reference

Configuration Commands

# View config
npx ts-node src/scripts/view-auth-config.ts

# Test modes
npx ts-node src/scripts/test-password-only.ts
npx ts-node src/scripts/test-otp-only.ts
npx ts-node src/scripts/test-2fa.ts
npx ts-node src/scripts/test-flexible.ts
npx ts-node src/scripts/test-mobile-login.ts

URLs

• Identity Server: https://ids.fabrixly.com
• Admin Console: https://ids.fabrixly.com
• Test Client: https://ids.fabrixly.com
• API Docs: https://ids.fabrixly.com/api-docs

Default Credentials

• System Admin: sysadmin@system.com / admin123
• Test User: alice@examplecorp.com / password123

Need Help? Check the full documentation or troubleshooting guide.