The security of this library is important to us, especially given its intended use by government agencies. We appreciate responsible disclosure of security vulnerabilities.
DO NOT report security vulnerabilities through public GitHub issues.
Instead, please report security vulnerabilities by emailing:
- Primary: [security@adhocteam.us]
- Subject Line: "[SECURITY] USAi API Node.js Library - [Brief Description]"
Include the following information:
- 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 it
When using this library in government environments:
- Environment Variables: Always use environment variables for API keys
- Network Security: Ensure TLS 1.2+ for all communications
- Credential Rotation: Regularly rotate API keys and credentials
- Audit Logging: Enable comprehensive logging for security audits
- Access Control: Limit library usage to authorized personnel only
- Updates: Keep the library updated to the latest secure version
This project implements comprehensive supply chain security measures:
- GuardDog Scanning: Automated detection of malicious packages, typosquatting, and supply chain attacks
- Dependency Auditing: Daily npm audit scans for known vulnerabilities
- License Compliance: Automated license checking against approved government licenses
- Secrets Detection: Continuous monitoring for exposed credentials
- Multi-layered Protection: npm audit, Snyk, CodeQL, and GuardDog provide complementary coverage
We use GuardDog to protect against:
- Malicious npm packages in dependencies
- Typosquatting attacks
- Code obfuscation and hidden payloads
- Unauthorized network communication
- Install script vulnerabilities
- Dependency confusion attacks
The scan runs automatically on:
- Every push to main branch that modifies dependencies
- Daily at 2 AM UTC
- Manual workflow dispatch
CI blocks high/critical npm audit findings via npm run audit:check, which
honors documented, time-boxed exceptions in .audit-allowlist.json.
Each exception must record a reason and an expiry date; expired entries fail CI
until re-reviewed. Current exceptions:
| Advisory | Package | Severity | Status | Review by |
|---|---|---|---|---|
| GHSA-fc5q-39xc-vjpf (CVE-2026-112366) | picomatch (dev-only, transitive via Jest) |
High | No patched release exists yet (fix pending upstream in micromatch/picomatch#194). Not included in the published package; exploitation requires attacker-controlled glob patterns in local test tooling. Will be removed once picomatch 4.0.8+ ships. | 2027-02-16 |
For federal agencies and government users:
- FedRAMP Compliance: Review against your agency's FedRAMP requirements
- ATO Process: Include this library in your Authority to Operate reviews
- FISMA Compliance: Ensure usage aligns with FISMA requirements
- Security Controls: Implement appropriate NIST 800-53 controls
- Incident Response: Include in your cybersecurity incident response plans
For non-security related questions, please use:
- GitHub Issues: For bugs and feature requests
- GitHub Discussions: For general questions
Thank you for helping keep this library secure! ๐บ๐ธ