Skip to content

Security: lyfmail-official/ebb

Security

SECURITY.md

Security Policy

Thank you for helping keep Ebb secure.

Ebb is a privacy-first menstrual cycle tracker designed so that sensitive reproductive health data remains private and protected.

Because this project handles extremely sensitive health data, security and responsible disclosure are critically important.


Supported Versions

We recommend using the latest version of Ebb.

Version Supported
Latest ✅ Yes
Older releases ⚠️ Limited support
Deprecated versions ❌ No

Security updates are applied to the most recent stable version.


Reporting a Vulnerability

If you discover a security vulnerability in Ebb, please report it responsibly and privately.

Do NOT create a public GitHub issue for security vulnerabilities.

Instead, please contact us directly.

Security Contact

Email:

ebb@lyfmail.com

Please include the following information:

• Description of the vulnerability
• Steps to reproduce the issue
• Potential impact
• Suggested mitigation (if known)
• Proof-of-concept (if available)

This helps us assess and resolve the issue faster.


Responsible Disclosure Guidelines

We ask security researchers to follow these guidelines:

• Allow reasonable time for fixes before public disclosure
• Do not exploit vulnerabilities for malicious purposes
• Do not access or modify data belonging to other users
• Do not perform denial-of-service attacks
• Respect user privacy at all times

We greatly appreciate responsible disclosure that helps protect users.


Response Timeline

Our typical response process:

Step Expected Time
Initial response 48 hours
Investigation 3-7 days
Fix development 7-14 days
Public advisory After patch release

Complex vulnerabilities may require additional time.


Security Architecture Overview

Ebb was designed with a privacy-first architecture.

Key principles:

• No centralized server storage
• Local encrypted data only
• Zero-knowledge design
• No analytics or tracking
• No third-party SDKs

Because the application does not store user data on servers, many traditional data breach risks are eliminated.


Cryptography

Ebb uses modern browser cryptography APIs.

Security design includes:

• AES-256 encryption
• PBKDF2 key derivation
• WebCrypto API implementation
• Client-side encryption before storage

All encryption occurs locally on the user's device.

No keys are transmitted to external servers.


Scope

The following components are considered in scope for security reports:

• Client-side encryption implementation
• Local data storage mechanisms
• Data privacy protections
• Service worker and offline functionality
• User interface data exposure risks

Out-of-scope issues may include:

• Browser vulnerabilities
• Operating system vulnerabilities
• Issues in unrelated third-party software


Security Goals

The primary security goals of Ebb are:

  1. Protect reproductive health data
  2. Prevent unauthorized data access
  3. Ensure transparency through open source
  4. Minimize attack surface by avoiding servers
  5. Provide verifiable privacy guarantees

Acknowledgements

We appreciate the work of independent security researchers who help strengthen the safety of open-source software.

Responsible disclosure helps ensure that Ebb remains a trusted privacy-first health application.


Contact

Security inquiries:

ebb@lyfmail.com

General project inquiries:

ebb@lyfmail.com

There aren't any published security advisories