s3files is pre-1.0 software. Security fixes are issued only against the
latest tagged release on the main branch. Older tags are not patched.
| Version | Supported |
|---|---|
Latest release on main |
✅ |
| Older tags | ❌ |
Please do not open a public GitHub issue for security vulnerabilities.
Use GitHub's Private Vulnerability Reporting instead, which keeps the report private until a fix is published:
- Go to the Security tab of this repository.
- Click Report a vulnerability.
- Fill in a clear description, reproduction steps, affected version, and the impact you observed (e.g. credential exposure, arbitrary file write outside the virtualization root, privilege escalation).
If you cannot use Private Vulnerability Reporting, you may instead contact the maintainer through the email address shown in their GitHub profile.
- Affected version / commit SHA
- Steps to reproduce, ideally with a minimal repro
- Expected vs. actual behavior
- Impact assessment (confidentiality / integrity / availability)
- Any suggested mitigation, if known
This is a personal open-source project, not a vendor product, so response times are best-effort:
- Initial acknowledgement: within 7 days
- Triage and severity assessment: within 14 days
- Fix or mitigation plan: depends on severity; critical issues are prioritized
You will be credited in the release notes for the fix unless you request otherwise.
In scope:
- The
s3fileshost process and its handling of S3 credentials, ProjFS callbacks, local file writes, and the.s3files-lost+foundquarantine directory. - Code under
src/andtests/in this repository.
Out of scope (please report these to the upstream project instead):
- Vulnerabilities in AWS SDK for .NET
- Vulnerabilities in
Microsoft.Windows.ProjFSor the underlyingPrjFlt.syskernel component - Vulnerabilities in the .NET runtime or Native AOT toolchain
- Issues that require an attacker who already has write access to the user's machine or to the target S3 bucket
s3filesuses the standard AWS SDK credential chain. Treat the host process as having the same trust level as any other tool that has access to those credentials.- The virtualization root is a normal Windows directory; standard NTFS ACLs apply. Do not place the root in a directory that other, less-trusted users on the machine can read or write.
- The
.s3files-lost+founddirectory may contain copies of local edits that lost a sync conflict. Treat its contents with the same sensitivity as the bucket itself.