Skip to content

Security: mpaulosky/dotfiles

docs/SECURITY.md

Security Policy

Supported Versions

The following versions of AINotesApp are currently supported with security updates:

Version Supported
0.1.x
< 0.1

Note: This is an early-stage project. Security updates will be provided for the latest 0.1.x release. Once the project reaches 1.0, we will maintain security support for the current major version and one previous major version.

Security Features

AINotesApp implements the following security measures:

Authentication & Authorization

  • ASP.NET Core Identity - User authentication and password management
  • Per-user data isolation - Users can only access their own notes
  • Authorization checks - All CQRS handlers verify user ownership
  • Secure password storage - Passwords are hashed using Identity's default algorithms

Data Protection

  • SQL injection protection - Entity Framework Core parameterized queries
  • XSS protection - Blazor's automatic HTML encoding
  • CSRF protection - Built-in anti-forgery tokens
  • HTTPS enforcement - Recommended for production deployments

API Security

  • OpenAI API key protection - Stored in user secrets or environment variables
  • Input validation - All commands validate user input
  • Error handling - Sensitive information not exposed in error messages

Database Security

  • User isolation - Database queries filtered by UserId
  • Migration safety - Code-first migrations with version control
  • Connection string security - Stored in appsettings.json (excluded from source control for production)

Reporting a Vulnerability

If you discover a security vulnerability in AINotesApp, please report it responsibly:

How to Report

Email: matthew.paulosky@outlook.com
Subject: [SECURITY] AINotesApp Vulnerability Report

Please do NOT open a public GitHub issue for security vulnerabilities.

What to Include

When reporting a security vulnerability, please include:

  1. Description - Clear description of the vulnerability
  2. Impact - Potential security impact and severity
  3. Steps to Reproduce - Detailed steps to reproduce the vulnerability
  4. Affected Versions - Which versions are affected
  5. Suggested Fix - If you have ideas for mitigation (optional)
  6. Your Contact Info - How we can reach you for follow-up

Response Timeline

  • Initial Response: Within 48 hours of report submission
  • Status Update: Within 7 days with assessment and timeline
  • Fix Timeline:
    • Critical vulnerabilities: Within 7 days
    • High severity: Within 14 days
    • Medium/Low severity: Within 30 days

Disclosure Policy

  • We will work with you to understand and validate the vulnerability
  • We will develop and test a fix before public disclosure
  • We will credit you in the security advisory (unless you prefer anonymity)
  • We request that you do not publicly disclose the vulnerability until we have released a fix

Security Advisories

Security updates will be published:

Security Best Practices for Contributors

When contributing to AINotesApp, please follow these security guidelines:

Code Review

  • All code changes require review before merging
  • Security-sensitive changes require additional scrutiny
  • Never commit secrets, API keys, or passwords

Testing

  • Add security-focused tests for authorization checks
  • Test boundary conditions and edge cases
  • Verify user isolation in integration tests

Dependencies

  • Keep NuGet packages up to date
  • Review dependency security advisories
  • Use dotnet list package --vulnerable to check for known vulnerabilities

Secrets Management

  • Use User Secrets for local development (dotnet user-secrets)
  • Use Environment Variables for production
  • Never commit appsettings.Production.json with secrets
  • Add sensitive files to .gitignore

Data Validation

  • Validate all user input in CQRS handlers
  • Use parameterized queries (Entity Framework Core does this automatically)
  • Sanitize data before rendering in Blazor components (Blazor does this automatically)

Known Security Considerations

Current Limitations

  • OpenAI API calls - Notes content is sent to OpenAI for AI features (embeddings, summaries, tags)
  • Local development - Uses SQL Server Express with Trusted Connection
  • No rate limiting - Consider implementing rate limiting for production
  • No audit logging - User actions are not currently logged

Recommendations for Production

  1. Use HTTPS - Enable HTTPS and HSTS
  2. Secure connection strings - Use Azure Key Vault or similar
  3. Enable logging - Add security event logging
  4. Rate limiting - Implement API rate limiting
  5. Regular updates - Keep .NET and dependencies updated
  6. Security headers - Add security headers (CSP, X-Frame-Options, etc.)
  7. Monitor dependencies - Use GitHub Dependabot for security alerts

Security Resources


Thank you for helping keep AINotesApp secure!

There aren’t any published security advisories