Authentication Settings
v1.0.0
3 min read
4 views
Last updated: 12 hours ago
Authentication Settings
Control how users register and verify their accounts in your marketplace.
Accessing Auth Settings
Navigate to Settings > Auth in your admin panel.
Account Verification Settings
Verification Required:
- Toggle ON to require new users to verify their accounts
- Toggle OFF to let users access immediately after registration
- Recommended: Keep ON to reduce spam accounts
Verification Method: Choose how users verify their accounts:
- Admin Manual - You manually approve each user from dashboard
- Email - Users verify via email link (automated)
Verification Expiry Period:
- Set how long (in minutes) the verification link remains valid
- Default: 1440 minutes (24 hours)
- Example: 60 = 1 hour, 1440 = 24 hours
Password Reset Expiry Period:
- How long (in minutes) password reset links remain valid
- Default: 120 minutes (2 hours)
- Shorter time = more secure
Authentication Screen
Background Image:
- Upload a wallpaper for login/register pages
- Accepted formats: JPG, PNG, JPEG, GIF, SVG
- Creates branded experience for users
Default User Levels
Default Buyer Level:
- Select which level new buyers start at
- Levels control permissions and limits
- Usually set to most basic buyer level
Default Seller Level:
- Select which level new sellers start at
- Controls what sellers can do initially
- Usually set to basic seller level
Social Login Configuration
The system supports 5 social login methods:
1. Facebook Login:
- Enable/Disable toggle
- Facebook Client ID field
- Facebook Client Secret field
2. Twitter Login:
- Enable/Disable toggle
- Twitter Client ID field
- Twitter Client Secret field
3. Google Login:
- Enable/Disable toggle
- Google Client ID field
- Google Client Secret field
4. GitHub Login:
- Enable/Disable toggle
- GitHub Client ID field
- GitHub Client Secret field
5. LinkedIn Login:
- Enable/Disable toggle
- LinkedIn Client ID field
- LinkedIn Client Secret field
How to Setup Social Login
Example: Setting up Google Login
- Go to Google Cloud Console
- Create new project or select existing
- Enable Google+ API
- Create OAuth 2.0 credentials
- Add authorized redirect URI:
yourdomain.com/auth/google/callback
- Copy Client ID and Client Secret
- In admin panel:
- Toggle "Enable Google Login" ON
- Paste Client ID
- Paste Client Secret
- Save changes
Best Practices
For New Marketplaces:
- Start with email verification only
- Keep verification required ON
- Set reasonable expiry times
- Add social logins after launch
For Security:
- Keep verification expiry short (24 hours)
- Password reset expiry even shorter (2 hours)
- Use manual approval for high-risk regions
- Monitor failed verification attempts
Troubleshooting
Verification emails not sending:
- Check SMTP configuration first
- Verify email templates exist
- Check spam folders
Social login not working:
- Verify Client ID and Secret are correct
- Check callback URLs match exactly
- Ensure APIs are enabled in provider dashboard
- Clear cache after changes
Users stuck in verification:
- Check verification method setting
- If manual, check pending verifications
- Verify email service is working
Tags:
authentication
login
registration