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:
- Creates a local Certificate Authority (CA)
- Generates a server certificate signed by the CA
- Adds the CA to your system's trust store (requires your computer's login password)
- 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.