> ## Content Index > Fetch the complete content index at: https://blog.fabrixly.com/llms.txt > Use this file to discover other available public pages before exploring further. # Quick Start Guide — Fabrixly-IDS Multi-Method Authentication - URL: https://blog.fabrixly.com/quickstart-guide/ - Published: 2026-07-07T03:08:35.000Z - Updated: 2026-07-07T07:07:35.000Z - Author: Fabrixly - Tags: Documentation, Setup, Fabrixly-IDS # 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: ```bash 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: | Mode | Icon | Description | Best For | | ------------ | ---- | ----------------- | -------------- | | **Password** | 🔑 | Traditional login | Internal tools | | **OTP Only** | 📱 | Passwordless | Consumer apps | | **2FA** | 🔐 | Password + OTP | High security | | **Flexible** | ⚡ | User choice | Mixed users | ## 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) ```bash # 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: ```bash # Look for this in your server terminal: [CommunicationService] Generated OTP: 123456 for user: [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 ```bash # 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 ```bash # 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 ```bash # 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: ```bash 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](./AUTHENTICATION.md) - [Configuration Reference](./AUTHENTICATION.md#configuration-guide) - [Security Best Practices](./AUTHENTICATION.md#security-considerations) 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 ```bash # 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](https://ids.fabrixly.com/?ref=blog.fabrixly.com) - Admin Console: [https://ids.fabrixly.com](https://ids.fabrixly.com/?ref=blog.fabrixly.com) - Test Client: [https://ids.fabrixly.com](https://ids.fabrixly.com/?ref=blog.fabrixly.com) - API Docs: [https://ids.fabrixly.com/api-docs](https://ids.fabrixly.com/api-docs?ref=blog.fabrixly.com) ### Default Credentials - **System Admin:** `sysadmin@system.com` / `admin123` - **Test User:** `alice@examplecorp.com` / `password123` --- **Need Help?** Check the [full documentation](./AUTHENTICATION.md) or [troubleshooting guide](./AUTHENTICATION.md#troubleshooting).