I actively support version 1.0.x and above.
| Version | Supported |
|---|---|
| 1.0.x | ✅ |
| < 1.0 | ❌ |
If you discover a security vulnerability in this integration, please handle it responsibly:
- Do NOT open a public issue
- Do NOT disclose the vulnerability publicly until it has been addressed
To report a security problem:
- Go to Security Advisories
- Click "Report a vulnerability"
- Provide detailed information about the vulnerability:
- Description of the issue
- Steps to reproduce
- Potential impact
- Suggested fix (if you have one)
Alternatively, you can email security concerns directly to the maintainer.
- Acknowledgment: Within 48 hours
- Initial Assessment: Within 5 business days
- Regular Updates: Every 5-7 days until resolved
- Resolution: Security issues are prioritized and will be addressed as quickly as possible
When using this integration:
- Protect Your Token: Never share your SmartThings Personal Access Token
- Use HTTPS: Ensure your Home Assistant instance uses HTTPS
- Keep Updated: Always use the latest version of the integration
- Monitor Access: Regularly review your SmartThings token permissions
- Webhook Security: The localtunnel provides encrypted communication, but be aware it creates an externally accessible endpoint
- Tokens are stored encrypted in Home Assistant's configuration
- Tokens are never logged or exposed in debug output
- Revoke tokens immediately if you suspect compromise
- Use minimum required token scopes
- Webhook endpoints use unique, randomly generated identifiers
- All webhook communication is encrypted via HTTPS
- Webhook signatures should be validated (future enhancement)
- Webhooks are automatically cleaned up when integration is removed
When a security vulnerability is fixed:
- A security advisory will be published
- Users will be notified through GitHub
- A new release will be created with the fix
- The CHANGELOG will include security-related changes
- Credit will be given to the reporter (if desired)
Thank you for helping keep SmartThings Community Edition secure! 🔒