From 583e15745f8f2def9fe7d3c4244da8247331e505 Mon Sep 17 00:00:00 2001 From: MacBook Date: Mon, 4 May 2026 04:55:04 +0200 Subject: [PATCH] docs: improve transparency in privacy policy and readme --- PRIVACY.md | 37 ++++++++++++++++++++----------------- README.md | 5 ++--- 2 files changed, 22 insertions(+), 20 deletions(-) diff --git a/PRIVACY.md b/PRIVACY.md index 6230876..64487f8 100644 --- a/PRIVACY.md +++ b/PRIVACY.md @@ -1,27 +1,30 @@ # Privacy Policy -KoalaSync is built with a **Privacy-First** architecture. We believe that your browsing habits and watch history are your business, not ours. +KoalaSync is designed with a **Security-First & Volatile** architecture. This means we prioritize keeping your data out of persistent storage, though certain technical data must be processed temporarily to ensure service stability and security. -## 1. Zero External Requests -The KoalaSync extension and its official marketing website are designed to be completely self-contained. -- **No CDNs**: We do not load scripts or styles from external Content Delivery Networks. -- **No Google Fonts**: We use a modern system font stack to avoid tracking by third-party font services. -- **No Analytics**: There are no tracking pixels, telemetry, or analytics scripts (like Google Analytics or Mixpanel) in the codebase. +## 1. Data Processing (In-Memory Only) +KoalaSync does not use a database. All active session data exists only in the server's RAM and is purged immediately when no longer needed. +- **Session Data**: To synchronize playback, the server must temporarily hold your `peerId`, `username`, and the `title` of the video you are watching. This is deleted as soon as you leave the room. +- **Room Passwords**: If you set a room password, it is stored only as a secure **bcrypt hash** in RAM. The server never sees or stores your plaintext password. -## 2. Data Sovereignty -- **Self-Hostable**: You can host your own relay server using our Docker image, giving you 100% control over your data. -- **Memory-Only State**: The relay server stores all room data in RAM. Nothing is written to a database or disk. When a room is empty, it is purged immediately. -- **No Logs**: The official relay server (`sync.shik3i.net`) does not log user IP addresses or room activity. +## 2. Security & Rate Limiting +To prevent abuse and brute-force attacks, the following data is processed: +- **Brute-Force Protection**: If multiple failed password attempts are detected, the server stores the `IP address` and `Room ID` in a temporary RAM-based lockout list for a maximum of 15 minutes. +- **Connection Rate Limiting**: IP addresses are tracked for 60 seconds to prevent connection-flooding (DoS) attacks. +- **Console Logging**: The official relay server (`sync.shik3i.net`) outputs connection events (including IP addresses) to the server console for real-time monitoring. These logs are ephemeral and are not archived, sold, or linked to any persistent user identity. ## 3. Extension Permissions -KoalaSync requires the following permissions to function: -- `storage`: To remember your username and server preferences locally. -- `tabs` & `scripting`: To detect video elements on pages you visit so they can be synchronized. -- ``: Necessary because KoalaSync works on any website with a `