Skip to content

Settings & Configuration

Configure bPass to meet your organization's needs with comprehensive settings for security, functionality, and integrations. These settings control both user experience and system behavior.

General Settings

Configure the basic application settings that define your bPass instance's identity, branding, and core functionality.

Navigation: Settings → Settings → General

dd

Application Configuration

Site Identity

  • Site Name - Your organization's name or application title (max 10 characters)

    • Keep it short and memorable
    • Appears in the browser title, login screens, and notifications
    • Examples: "ACME Corp", "MyTeam", "DevOps"

  • Tag Line - A brief slogan or description that appears alongside your site name

    • Provides additional context about your organization
    • Appears on login pages and welcome screens
    • Examples: "Secure Password Management", "Enterprise Security Solutions"

  • App Icon - Upload a custom logo or icon for your organization

    • Recommended size: 512x512 pixels or larger
    • Supports PNG, JPG, and SVG formats
    • Appears in browser tabs, mobile bookmarks, and the application header

System Configuration

  • Website URL - The primary URL where your bPass instance is hosted
    • Critical for proper functionality of links, redirects, and email templates
    • Must match the URL in your browser for proper operation
    • Include the protocol (https://) and domain
  • Important: Only change this if the displayed URL doesn't match your browser's address bar
    • Incorrect changes may cause issues with file storage and application links

User Registration Settings

  • Allow Public Registration - Controls whether new users can register themselves
    • When Enabled: Anyone can create an account at /auth/register
    • When Disabled: Only administrators can add new users from the admin panel
    • Security Consideration: Disable for private organizations or when user access should be controlled
    • Best Practice: Enable for public-facing instances, disable for internal corporate use

Configuration Impact

Site Name & Branding

Your site name and tagline appear in:

  • Browser window titles
  • Email templates and notifications
  • Login and registration screens
  • Password sharing invitations
  • Mobile app interfaces
  • API documentation

Website URL Configuration

The website URL is used for:

  • Generating absolute links in emails
  • Redirect URLs after authentication
  • API endpoint documentation
  • File upload and download links
  • OAuth callback URLs
  • WebSocket connection endpoints

Registration Policy

The registration setting affects:

  • Public access to account creation
  • Onboarding workflows
  • Security posture
  • Administrative overhead
  • User management complexity

Best Practices

Naming Guidelines

  1. Site Name

    • Use your organization's common name or abbreviation
    • Avoid special characters or numbers unless part of your brand
    • Consider how it appears in email subjects and browser tabs
    • Test how it looks on mobile devices

  2. Tag Line

    • Keep it under 50 characters for best display
    • Focus on your core value proposition
    • Avoid technical jargon unless appropriate for your audience
    • Consider multilingual users if applicable

Security Recommendations

  1. Public Registration

    • Enable only if you need open access
    • Consider implementing approval workflows for new accounts
    • Monitor new registrations for suspicious activity
    • Have a clear acceptable use policy

  2. URL Configuration

    • Always use HTTPS in production
    • Ensure the URL matches your SSL certificate
    • Test all functionality after URL changes
    • Document the URL change for your team

Technical Considerations

  1. Logo Guidelines

    • Use vector formats (SVG) when possible for crisp display
    • Provide high-resolution images for mobile devices
    • Ensure good contrast for accessibility
    • Test appearance in both light and dark themes

  2. URL Changes

    • Plan URL changes during maintenance windows
    • Update any external integrations or bookmarks
    • Clear browser caches after changes
    • Verify email templates still work correctly

Troubleshooting

Common Issues

Logo Not Displaying

  • Check file format is supported (PNG, JPG, SVG)
  • Verify file size is under 10MB
  • Ensure proper file permissions
  • Try uploading a different image format

URLs in Emails Are Wrong

  • Verify the Website URL setting matches your domain
  • Check that the protocol (https://) is included
  • Clear application cache after URL changes
  • Test with a password reset email

Registration Page Not Found

  • Ensure public registration is enabled
  • Check web server routing configuration
  • Verify the /auth/register route is accessible
  • Review application logs for routing errors

Configuration Validation

Before saving changes:

  1. Test the Website URL - Visit the URL in a new browser tab
  2. Verify Logo Display - Check how the logo appears on different pages
  3. Test Email Links - Send a test email to verify links work correctly
  4. Check Mobile View - Ensure branding looks good on mobile devices

Integration Notes

The general settings integrate with:

  • Email Configuration - Site name appears in email headers and footers
  • WebSocket Settings - Website URL used for connection endpoints
  • User Management - Registration settings affect user creation workflows
  • API Documentation - Website URL used for example endpoints
  • Mobile Applications - Branding and URLs used for app configuration

Getting Help

Documentation

  • User Guides - Access comprehensive user documentation
  • Admin Guides - Technical administration documentation
  • API Reference - Complete API documentation
  • Video Tutorials - Step-by-step video guides
  • Best Practices - Security and usage recommendations

Support Options

  • Knowledge Base - Searchable help articles
  • Community Forums - User community and discussions
  • Professional Support - Direct technical support
  • Training Services - Professional training and onboarding
  • Custom Development - Enterprise customization services

Need help configuring bPass? Start with our installation guide or explore specific configuration topics using the links above.