If you discover a security vulnerability in Citation Sync Action, please report it privately to help protect the community.
DO NOT open a public issue for security vulnerabilities.
Instead, please report security issues by:
-
GitHub Security Advisories (Preferred):
- Go to the Security tab
- Click "Report a vulnerability"
- Fill out the form with details
-
Direct Contact:
- Contact @Adamtaranto directly via GitHub
- Include "SECURITY" in the subject line
- Provide detailed information about the vulnerability
When reporting a vulnerability, please include:
- Description of the vulnerability
- Steps to reproduce the issue
- Potential impact of the vulnerability
- Affected versions (if known)
- Suggested fix (if you have one)
- Your contact information for follow-up
- Initial Response: Within 48 hours
- Status Update: Within 7 days
- Fix Timeline: Depends on severity
- Critical: Within 7 days
- High: Within 14 days
- Medium: Within 30 days
- Low: Next regular release
- Security vulnerabilities will be handled privately until a fix is available
- We will coordinate with you on the disclosure timeline
- After a fix is released, we will publish a security advisory
- Credit will be given to reporters (unless anonymity is requested)
We support the following versions with security updates:
| Version | Supported |
|---|---|
| 1.x.x | ✅ |
| < 1.0 | ❌ |
We recommend always using the latest stable release.
When using this action:
- Use Specific Versions: Pin to specific versions or major version tags (e.g.,
v1) - Review Permissions: Ensure
contents: writepermission is necessary for your use case - Protect Tokens: Use
secrets.GITHUB_TOKENor carefully manage PATs - Enable Branch Protection: Protect your default branch to prevent unauthorized changes
- Review Changes: Review the action's code before using it in production
- Monitor Updates: Watch for security advisories and update regularly
This action requires contents: write permission to:
- Commit changes to CITATION.cff
- Create and push tags
- Push to the default branch
Mitigation: The action only modifies CITATION.cff and related tags. It does not access other files or secrets.
This action creates new tags automatically.
Mitigation: Tag creation only occurs when CITATION.cff needs updating. The action validates all changes before committing.
The action could potentially trigger itself in a loop.
Mitigation: Commits include [skip ci] by default to prevent workflow re-triggering. The workflow also checks if the last commit was made by the action.
This action has minimal dependencies:
- GitHub Actions checkout action
- Standard bash/git utilities available in GitHub Actions runners
We monitor dependencies for security vulnerabilities and update them as needed.
We appreciate security researchers and users who help keep Citation Sync Action secure. Thank you for reporting vulnerabilities responsibly!