Version | Supported |
---|---|
0.1.x | ✅ |
I take the security of Flux Shell seriously. If you believe you have found a security vulnerability, please follow these steps:
- DO NOT open a public issue
- Send a description of the vulnerability to [email protected]
- Include the following information:
- Type of vulnerability
- Full path to source file(s) related to the vulnerability
- Steps to reproduce
- Impact of the vulnerability
- (Optional) Suggested fix
You can expect:
- Acknowledgment of your report within 48 hours
- Regular updates on my progress
- Credit in the security advisory (unless you prefer to remain anonymous)
Flux Shell includes a plugin system that can execute arbitrary code. To minimize risk:
- Only install plugins from trusted sources
- Review plugin source code before installation
- Use the built-in code review feature:
flux plugin install <url>
- Plugins run with the same permissions as the shell itself
- Internal environment variables are stored encrypted
- Use
env -s KEY=VALUE internal
for sensitive data - System environment variables are stored in plain text
- Config files are stored in user space only
- Permissions are set to
600
(user read/write only) - Sensitive data should not be stored in the config file
-
Plugin Installation
# Review code before installing flux plugin install <url> # Choose [O]pen for code review
-
Sensitive Data
# Store sensitive data as internal variables flux env -s API_KEY=secret internal
-
Configuration
# Check file permissions ls -l ~/.config/rip.choco.flux/config.fl # Should show: -rw------- (600)
- Environment variable encryption
- Plugin code review system
- Permission checks on startup
- Secure configuration storage
- Input sanitization
- Path traversal prevention
Please check my GitHub Issues tagged with security
for any known security issues.
Security updates will be released as patch versions (0.1.x) and announced through:
- GitHub Security Advisories
- Release Notes
- Our official website
To audit your Flux Shell installation:
-
Check plugin sources:
flux plugin list
-
Review environment variables:
flux env -l internal flux env -l system
-
Verify configuration permissions:
ls -l ~/.config/rip.choco.flux/
We welcome security improvements! To contribute:
- Fork the repository
- Create a security enhancement
- Submit a pull request with detailed description
I can be reached at:
- Email: [email protected]
- PGP Key: choco.rip/pgp-key.txt
We'd like to thank all security researchers who have helped improve Flux Shell's security. See our CONTRIBUTORS.md file for details.