Certificate Management

Important Update

BB now includes automatic certificate management. Manual certificate creation using external tools is no longer required.

Overview

BB automatically handles TLS certificate creation and management to ensure secure HTTPS communication between components. This includes:

  • Automatic certificate generation during initialization
  • Integration with your system's trust store
  • Certificate renewal management
  • Browser security compatibility

How It Works

When you initialize BB or enable TLS security, the system:

  1. Creates a local Certificate Authority (CA)
  2. Generates a server certificate signed by the CA
  3. Adds the CA to your system's trust store (requires your computer's login password)
  4. Configures BB to use the new certificates for secure communication

Certificate Types

Local CA Certificate

The Certificate Authority (CA) certificate is:

  • Created once during initial setup
  • Added to your system's trust store
  • Used to sign server certificates
  • Valid for 10 years by default

Server Certificate

The server certificate is:

  • Generated for the BB API server
  • Signed by your local CA
  • Valid for 1 year by default
  • Automatically renewed when needed

Browser Security

Modern browsers require valid HTTPS certificates for secure connections. BB's automatic certificate management ensures:

  • No browser security warnings
  • Secure WebSocket connections
  • Protected API communication
  • Data encryption in transit

Certificate Management

Use the bb secure command to manage certificates:

# Enable TLS (recommended)
bb secure on

# Check certificate status
bb secure status

# Disable TLS (not recommended)
bb secure off

Certificate Renewal

BB automatically handles certificate renewal:

  • Monitors certificate expiration dates
  • Renews server certificates before expiry
  • Maintains continuous secure operation
  • No manual intervention required

Related Documentation

Advanced Configuration

For advanced users, BB supports custom certificate configuration:

  • Custom certificate paths
  • Inline PEM certificate content
  • Custom validity periods
  • Manual trust store management

See the CLI Documentation for detailed configuration options.