We actively support the following versions of Soul Foods Analytics with security updates:
| Version | Supported |
|---|---|
| 1.0.x | ✅ |
| < 1.0 | ❌ |
We take the security of Soul Foods Analytics seriously. If you believe you have found a security vulnerability, please report it to us as described below.
Please do not report security vulnerabilities through public GitHub issues.
Instead, please report them via email to: security@soulfoods.com
Include the following information in your report:
- Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
- Full paths of source file(s) related to the manifestation of the issue
- The location of the affected source code (tag/branch/commit or direct URL)
- Any special configuration required to reproduce the issue
- Step-by-step instructions to reproduce the issue
- Proof-of-concept or exploit code (if possible)
- Impact of the issue, including how an attacker might exploit the issue
- Initial Response: Within 48 hours of receiving your report
- Status Update: Within 7 days with a more detailed response
- Resolution: Security fixes will be prioritized and released as soon as possible
- We will acknowledge receipt of your vulnerability report within 48 hours
- We will provide an estimated timeline for addressing the vulnerability
- We will notify you when the vulnerability has been fixed
- We will publicly disclose the vulnerability after a fix has been released
-
Keep Dependencies Updated
pip install --upgrade soul-foods-analytics
-
Use Virtual Environments
python -m venv venv source venv/bin/activate -
Validate Input Data
- Always validate CSV files before processing
- Check data sources for integrity
- Use the built-in data validation features
-
Secure Dashboard Deployment
- Don't expose the dashboard to public internet without authentication
- Use HTTPS in production
- Configure proper firewall rules
-
Code Security
- Follow secure coding practices
- Validate all inputs
- Use parameterized queries if database access is added
- Avoid hardcoded secrets
-
Dependency Management
- Regularly update dependencies
- Use
pip-auditto check for known vulnerabilities - Pin dependency versions in production
-
Testing
- Include security tests in the test suite
- Test input validation
- Test error handling
- The application processes sales data that may contain sensitive business information
- Ensure proper access controls are in place when deploying
- Consider data encryption for sensitive datasets
- The Dash application runs a web server that should be properly secured
- Default configuration is for development only
- Production deployments should use proper authentication and HTTPS
- The application reads CSV files from the file system
- Ensure proper file permissions are set
- Validate file paths to prevent directory traversal attacks
Security updates will be released as patch versions and will be clearly marked in the changelog. Users are encouraged to update to the latest version as soon as possible.
- GitHub Security Advisories
- Release notes in CHANGELOG.md
- Email notifications to registered users (if applicable)
Subject: Security Vulnerability - CSV Injection in Data Processor
Description: The DataProcessor class does not properly validate CSV input,
potentially allowing CSV injection attacks when processing untrusted data files.
Steps to Reproduce:
1. Create a CSV file with malicious formulas
2. Process the file using DataProcessor
3. Observe potential code execution
Impact: Potential code execution when processing untrusted CSV files
Subject: Security Vulnerability - XSS in Dashboard
Description: The dashboard does not properly sanitize user input in region
selection, potentially allowing cross-site scripting attacks.
Steps to Reproduce:
1. Start the dashboard
2. Inject malicious script in region parameter
3. Observe script execution
Impact: Potential XSS attacks against dashboard users
We use the following tools to maintain security:
- Bandit: Python security linter
- Safety: Dependency vulnerability scanner
- pip-audit: Python package vulnerability scanner
- GitHub Security Advisories: Automated vulnerability detection
# Install security tools
pip install bandit safety pip-audit
# Run security scan
bandit -r pink_morsel_analysis/
# Check dependencies
safety check
pip-audit
# Or use make command
make security-checkFor security-related questions or concerns, please contact:
- Email: security@soulfoods.com
- PGP Key: Available upon request
We appreciate the security research community and will acknowledge researchers who responsibly disclose vulnerabilities to us.
- Repository: quantium-pink-morsel-analysis
- Forked from: vagabond-systems/quantium-starter-repo
Note: This security policy is subject to change. Please check back regularly for updates.