fix: harden channel access and refresh server dependencies

This commit is contained in:
Loki 2026-10-24 13:57:29 +02:00
parent 84df32a9de
commit b14f036bdb
Signed by: boba
GPG key ID: 253067914055423B
23 changed files with 1242 additions and 720 deletions

1109
Cargo.lock generated

File diff suppressed because it is too large Load diff

View file

@ -12,18 +12,16 @@ edition = "2024"
license = "GPL-3.0" license = "GPL-3.0"
authors = ["VNOX Contributors"] authors = ["VNOX Contributors"]
repository = "https://github.com/loki5512344/Vnox" repository = "https://github.com/loki5512344/Vnox"
rust-version = "1.85" rust-version = "1.94"
[workspace.dependencies] [workspace.dependencies]
tokio = { version = "1.52", features = ["full"] } tokio = { version = "1.54", features = ["fs", "io-util", "macros", "net", "rt-multi-thread", "sync", "time"] }
serde = { version = "1", features = ["derive"] } serde = { version = "1", features = ["derive"] }
serde_json = "1" serde_json = "1"
ed25519-dalek = { version = "2", features = ["rand_core"] } ed25519-dalek = { version = "3", features = ["rand_core"] }
x25519-dalek = { version = "2", features = ["static_secrets"] } x25519-dalek = "3"
chacha20poly1305 = "0.10" chacha20poly1305 = "0.11"
argon2 = "0.5" rand = "0.10"
rand = "0.8"
opus = "0.3"
uuid = { version = "1", features = ["v4"] } uuid = { version = "1", features = ["v4"] }
hex = "0.4" hex = "0.4"
hkdf = "0.13" hkdf = "0.13"
@ -31,5 +29,4 @@ sha2 = "0.11"
tracing = "0.1" tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] } tracing-subscriber = { version = "0.3", features = ["env-filter"] }
anyhow = "1" anyhow = "1"
thiserror = "2"
toml = "1.1" toml = "1.1"

View file

@ -1,15 +1,15 @@
# ─── Stage 1: Build ─────────────────────────────────────────────────────────── # ─── Stage 1: Build ───────────────────────────────────────────────────────────
FROM rust:1.85-slim-bookworm AS builder FROM rust:1.99-slim-bookworm AS builder
RUN apt-get update && \ RUN apt-get update && \
apt-get install -y --no-install-recommends \ apt-get install -y --no-install-recommends \
pkg-config libssl-dev libopus-dev cmake && \ pkg-config cmake protobuf-compiler && \
rm -rf /var/lib/apt/lists/* rm -rf /var/lib/apt/lists/*
WORKDIR /build WORKDIR /build
COPY . . COPY . .
RUN cargo build --release --package vnox-gateway RUN cargo build --locked --release --package vnox-gateway
# ─── Stage 2: Runtime ───────────────────────────────────────────────────────── # ─── Stage 2: Runtime ─────────────────────────────────────────────────────────
FROM debian:bookworm-slim FROM debian:bookworm-slim

View file

@ -1,15 +1,15 @@
# ─── Stage 1: Build ─────────────────────────────────────────────────────────── # ─── Stage 1: Build ───────────────────────────────────────────────────────────
FROM rust:1.85-slim-bookworm AS builder FROM rust:1.99-slim-bookworm AS builder
RUN apt-get update && \ RUN apt-get update && \
apt-get install -y --no-install-recommends \ apt-get install -y --no-install-recommends \
pkg-config libssl-dev libopus-dev cmake && \ pkg-config cmake protobuf-compiler && \
rm -rf /var/lib/apt/lists/* rm -rf /var/lib/apt/lists/*
WORKDIR /build WORKDIR /build
COPY . . COPY . .
RUN cargo build --release --package vnox-voice-node RUN cargo build --locked --release --package vnox-voice-node
# ─── Stage 2: Runtime ───────────────────────────────────────────────────────── # ─── Stage 2: Runtime ─────────────────────────────────────────────────────────
FROM debian:bookworm-slim FROM debian:bookworm-slim

View file

@ -5,7 +5,7 @@
**Not Discord. Not TeamSpeak. Not someone else's cloud.** **Not Discord. Not TeamSpeak. Not someone else's cloud.**
[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE) [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/rust-1.85%2B-orange.svg)](https://www.rust-lang.org/) [![Rust](https://img.shields.io/badge/rust-1.94%2B-orange.svg)](https://www.rust-lang.org/)
[![Status: Phase 1](https://img.shields.io/badge/status-phase%201%20%E2%80%94%20implemented-yellow.svg)](docs/00-status.md) [![Status: Phase 1](https://img.shields.io/badge/status-phase%201%20%E2%80%94%20implemented-yellow.svg)](docs/00-status.md)
--- ---
@ -117,7 +117,7 @@ See [docs/00-status.md](docs/00-status.md) for a full breakdown.
## Quick start ## Quick start
**Requirements:** Rust 1.85+, a running [VNOX Client](../VNOX-Client/) **Requirements:** Rust 1.94+, a running [VNOX Client](../VNOX-Client/)
```bash ```bash
# Terminal 1 — gateway # Terminal 1 — gateway
@ -135,9 +135,10 @@ The client connects to `127.0.0.1:7600` by default. Config reference: [dev/READM
docker-compose up docker-compose up
``` ```
### Opus on Windows ### Build dependencies
`audiopus_sys` builds libopus from source via CMake. CMake 4.x policy flag is already set in `.cargo/config.toml` — no manual steps needed. Gateway builds require `protoc` (for example, `protobuf-compiler` on Ubuntu).
The voice relay forwards encoded packets and does not require libopus; the codec is a client dependency.
--- ---

View file

@ -0,0 +1,56 @@
# Vnox: регистрация, устройства и аватары
Статус: продуктовая и техническая спецификация. Регистрация Hub пока не реализована. Клиентский редактор аватара реализуется отдельно; до появления API сохраняет реальное изображение локально.
## Вход и создание аккаунта
Для первого Hub: «Продолжить с GitHub» и «Войти по почте» с одноразовым кодом. Регистрация и вход — один понятный поток; после подтверждения нового аккаунта выбираются свободный handle, отображаемое имя и необязательный аватар. Пароль Vnox на первом этапе не требуется. Google и другие провайдеры добавляются позже при необходимости.
Постоянный user_id создаёт Hub; он не равен ни email, ни GitHub username. Провайдер GitHub идентифицируется origin/provider + стабильным числовым ID из проверенного API-ответа. Для будущих OIDC-провайдеров — issuer + subject. Ник провайдера и совпадающий email не используются для автоматического объединения аккаунтов.
Связать второй способ входа можно из аутентифицированного аккаунта после повторного подтверждения; требуется доказать владение добавляемым способом. Отвязка последнего способа входа запрещена без настроенного восстановления. Добавление/отзыв устройств, email и способов входа сопровождаются уведомлениями.
## GitHub OAuth
Клиент открывает системный браузер. Hub хранит OAuth client_secret, принимает provider callback, проверяет state/PKCE и получает подтверждённую identity через GitHub API. Клиенту возвращается одноразовый код Vnox для конкретного login attempt с PKCE, а не GitHub bearer token в URL.
Запрашиваются минимальные права для identity; доступ к репозиториям не нужен. Если email не используется для входа/backup, не требовать дополнительный доступ к приватной почте. Provider tokens не передаются серверам сообществ; если после входа API не нужен, не держать долгоживущие GitHub refresh/access tokens без причины.
Системный браузер предпочтительнее embedded webview. Callback/loopback адреса фиксируются, одноразовые коды короткоживущие и связаны с инициировавшим их клиентом. GitHub OAuth и собственный обмен app↔Hub имеют отдельные state/PKCE-контексты.
## Почта
Код одноразовый, криптографически случайный, с коротким сроком, ограниченным числом попыток и rate limits по попытке/адресу/источнику. Ответы не раскрывают существование аккаунта. Коды и ссылки не логируются; хранить защищённое проверяемое представление с серверным секретом, не голый hash низкоэнтропийного кода.
Email подтверждает контроль почтового ящика, а не сильную защищённость аккаунта. Для владельцев серверов и авторов пакетов нужны усиленная проверка/passkey либо другое явно выбранное MFA перед чувствительными действиями. В обычном интерфейсе passkey можно предложить после первого входа. Конкретную WebAuthn библиотеку и платформенную поддержку проверить перед реализацией.
## Устройства и E2EE
У каждого устройства отдельный ключ и список активных сессий с возможностью отзыва. Способ входа в профиль не является ключом расшифрования переписки. Восстановление GitHub/email не расшифровывает старые E2EE сообщения автоматически.
Для добавления доверенного устройства требуется подтверждение действующим устройством или секрет восстановления зашифрованной копии ключей. При полной потере ключей возможен возврат к профилю с новым crypto identity, но старую историю обещать нельзя; контакты видят смену identity. Максимальная задержка отзыва сессий и режим при недоступном Hub определяются общим протоколом.
Существующая локальная identity переносится в Hub только после доказательства владения, не по совпадению nickname. Аккаунт Hub и криптографическая identity нельзя склеивать неявно.
## Редактор аватара
В профиле: «Изменить фото» → нативный выбор PNG/JPEG/WebP → квадратный диалог с круглой маской. Пользователь двигает изображение, меняет масштаб ползунком или колесом, видит итог в круге; доступны «Сбросить», «Отмена», «Сохранить».
При открытии кадр центрирован и заполняет круг без пустых краёв. Смещение ограничивается так, чтобы итоговый квадрат полностью покрывался изображением. Ориентация фотографии учитывается до расчёта размеров. Сохраняется квадратный PNG 256×256; круг — маска отображения, а не потеря пикселей по краям. Никакого растягивания исходника по осям.
Первоначальные ограничения клиента: исходный файл до10MiB, сторона до4096px, лимит памяти декодера64MiB. Ограничения проверяются при чтении/декодировании, ошибки показываются в диалоге. SVG, внешние URL и анимации не поддерживаются в первой версии. Оригинал не сохраняется после нормализации; выходной PNG не переносит исходные EXIF/геометки. Отмена и ошибка не заменяют прежний аватар; запись атомарная.
До Hub API аватар собственный/локальный и не выдаётся за синхронизированный с друзьями. Впоследствии Hub принимает нормализованное изображение, повторно проверяет/перекодирует его, обновляет avatar_id/revision и доступ по политике профиля. Изображение хранится до замены/удаления профиля; правило DM-вложения «4 дня» не применяется. Старые версии и кэши очищаются по отдельной политике.
## Ещё решения до публичного запуска
- Подтверждение первого владельца сервера и его восстановление без захвата чужого сервера.
- Сроки сессий, отзыв устройств, резервные коды и политика восстановления ключей.
- Email delivery: SMTP, ограничения, защита от рассылочного абьюза и доступность писем.
- Видимость профиля/email/присутствия; жалобы, блокировки и ограничения поиска.
- Приглашения с сроком/числом использований, закрытые сообщества и удаление аккаунта.
- Хранение аватаров отдельно от временных DM-файлов и версий marketplace.
Источники: [GitHub OAuth](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps), [RFC8252: native apps](https://datatracker.ietf.org/doc/html/rfc8252), [OWASP: linking/authentication](https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html), [email verification](https://cheatsheetseries.owasp.org/cheatsheets/Email_Validation_and_Verification_Cheat_Sheet.html).
Размещение сервера за NAT требует отдельного решения по доступности: публикация в Hub не открывает TCP/UDP-порты. Для первого self-hosted этапа нужен доступный адрес/IPv6 или настройка port forwarding/VPN; центр не обещает автоматически проксировать голос.

View file

@ -0,0 +1,99 @@
# Vnox: серверные WASM-плагины и маркетплейс
Статус: архитектурное предложение по запросу пользователя. Реального runtime/API/маркетплейса пока нет. Старый `VNOX-Server/docs/community/plugins.md` описывает Deno/JS и пример modbot; новый план заменяет это направление после фиксации контракта.
## Модель
Бот — это серверный плагин, которому выдана отдельная bot identity. Другие плагины могут только добавлять команды, расписания или обработку событий без видимого бота. Плагин устанавливает уполномоченный администратор конкретного сообщества; установка на один сервер не запускает его на всех клиентах или серверах.
Модератор, приветствия, опросы и игровая статистика — первые примеры. Музыкальные боты с декодированием/внешними источниками и обработка голосового содержимого — позднее расширение, не базовая возможность.
## Runtime и общий API
Основной кандидат — Wasmtime в составе `vnox-server`. Общий версионированный контракт Vnox Plugin API описывается WIT; каждый поддержанный язык должен пройти одинаковые контрактные тесты. Один скомпилированный engine может переиспользоваться, но память/Store, права, очередь и состояние изолируются для каждого экземпляра плагина. Нельзя считать WASM защитой от любых ошибок host runtime.
Не давать по умолчанию WASI filesystem/sockets/environment/process access. Доступ к функциям Vnox идёт через узкие host interfaces: команды чата, события, ограниченное KV-хранилище, таймеры, настройки и разрешённые HTTP-запросы. Не использовать native DLL/so или Python/Lua без sandbox как основной формат маркетплейса.
## Языки
| Язык | Способ | Порядок |
|---|---|---|
| Rust | Компиляция в WASM component, SDK с типами Plugin API | Первый SDK и эталонные тесты |
| Lua | Упакованный WASM-интерпретатор с Vnox-адаптером API | Отдельный прототип после API; не обещать готовый прямой Lua→component toolchain |
| Python | Component toolchain/упакованный interpreter, адаптер API | Отдельный проверяемый этап; размер и холодный старт измеряются |
| JS/TS и другие | Component toolchain и адаптер того же API | По необходимости после первых SDK |
Владельцу сервера не нужны установленные rustc, lua или python: устанавливается готовый пакет с runtime-зависимостями внутри. Исходники собираются у автора/в изолированном CI, а не произвольным install-script на сервере пользователя. Для Lua/Python нельзя обещать все пакеты pip, C-расширения или обычный OS API. Поддержка объявляется после работающего примера и измерения ресурсов, а не по одному наличию слова WASM.
## События и исполнение
Плагин подписывается только на разрешённые события: slash-команда, вход/выход участника, сообщение разрешённого канала, изменение роли, таймер. Для slash-команд можно работать без доступа ко всей переписке. Доступ к содержимому чата — отдельное явно видимое разрешение, не автоматическая часть установки бота.
Очереди ограничены. Плагин не исполняется под глобальной блокировкой каналов или БД и не находится в критическом пути передачи голоса. На переполнение/таймаут предусмотрены отказ, счётчик ошибок и автоматическое отключение при повторении. Семантика повторной доставки и event_id документируется; side effects должны уметь дедуплицировать повтор события.
Синхронная премодерация, блокирующая публикацию сообщения до ответа плагина, если понадобится, получает отдельный контракт с лимитом времени и явным fail-open/fail-closed. Базовые асинхронные боты не задерживают принятие сообщения всеми остальными плагинами.
## Разрешения
- `commands.register`: заявить команды в своём namespace.
- `messages.send`: писать от bot identity в выбранные каналы.
- `messages.read`: получать содержимое только выбранных каналов.
- `messages.moderate`: удалять/модерировать сообщения по политике сервера.
- `members.moderate`: отдельные действия mute/kick/ban с ограничением иерархии.
- `storage.kv`: ограниченное хранилище в namespace экземпляра.
- `timers.schedule`: ограниченное количество задач.
- `http.fetch`: запросы через host broker только к разрешённым назначениям.
Host проверяет права и scope на каждом вызове. Manifest описывает запрос, а не выдаёт полномочия. Контекст содержит plugin instance, bot actor и, для пользовательской команды, пользователя-инициатора; бот не может дать ему административные действия без отдельной проверки. Право управлять ролями не должно позволять назначить привилегии выше разрешённых боту.
Ключи Hub/server identity, сессии других пользователей, БД целиком, host env и глобальная E2EE-личка недоступны плагинам сообщества. События уже фильтруются до передачи в WASM. Если в будущем бот станет явным участником шифрованного разговора, это отдельная пользовательская модель с предупреждением, а не обход E2EE через admin API.
HTTP broker ограничивает URL/домены, редиректы, разрешённые адреса после DNS resolution, размер ответа, время и число запросов. Доступ к loopback, приватной инфраструктуре и cloud metadata закрыт по умолчанию. Fuel не ограничивает время зависшего host HTTP-вызова, поэтому ему нужны собственные timeout/cancellation и квоты.
## Ограничение ресурсов
У каждого экземпляра есть потолок памяти/таблиц/стека, CPU budget с fuel/epoch interruption, время события, количество одновременных операций, глубина очереди, объём KV, логов и исходящего трафика. Значения определяются по измерению Rust/Lua/Python примеров; одинаковый лимит fuel может давать разные возможности интерпретируемому и компилируемому коду.
Ошибка/ловушка плагина завершает его обработчик, а не штатную работу сервера. Обновлять runtime по исправлениям безопасности. Не обещать защиту от всех багов самого Wasmtime/host; отделение runner в дочерний процесс может обсуждаться как дополнительная изоляция в рамках одной поставки, не как отдельная голосовая машина.
## Пакет
Пакет `.vnoxp`: manifest, WASM component, ограниченные assets, лицензия и сведения о происхождении сборки. Manifest включает namespaced plugin_id, версию, поддерживаемый Plugin API, host compatibility, entrypoint, запрашиваемые права и config schema. Все составляющие перечислены с digest; версия immutable и не заменяется другим содержимым под тем же номером.
Архив безопасно распаковывается с лимитами количества/размера файлов, без path traversal, ссылок и исполняемых install hooks. Секреты конфигурации задаются владельцем отдельно и не попадают в опубликованный пакет или логи.
## Маркетплейс на Hub
Hub хранит каталог авторов и плагинов, версии, пакеты, документацию, changelog, compatibility, требуемые права, жалобы и статусы публикации/отзыва. Пакеты хранятся по собственной release retention policy: правило DM-файлов «20 МБ / 4 дня» сюда не применяется.
Автор подписывает релиз. Подпись связывает пакет с автором и защищает целостность, но не доказывает отсутствие вредоносного поведения. Публикация проходит автоматическую проверку структуры/imports/лимитов и совместимости; для широких прав нужно отдельное рассмотрение. Отдельно показываются «автор подтверждён», «автоматические проверки пройдены» и «проверенная версия» с областью ревью. Не использовать общий значок «безопасно».
Первый маркетплейс бесплатный: каталог, установка, версии и права. Платежи/подписки не входят в MVP. Локальная установка файла остаётся доступной администратору с теми же проверками и sandbox; отсутствие Hub не останавливает уже установленный плагин.
## Установка и обновление
1. Администратор открывает каталог из управления сервером.
2. Выбирает конкретную версию, читает права и назначает каналы/лимиты.
3. Сам сервер скачивает пакет, проверяет manifest, совместимость, подписи/хэши и локально выданные права.
4. Пакет запускается в изолированном экземпляре; настройки и состояние принадлежат этому экземпляру.
5. По умолчанию обновления предлагаются, а не выполняются молча. Новые права никогда не принимаются автоматически.
6. Обновление проверяется до переключения; rollback кода не должен портить KV после миграции схемы. Нужны версия схемы, согласованная миграция и snapshot только данных плагина.
Администратору доступны остановить/удалить, отозвать права/секреты, посмотреть ограниченные логи, CPU/память, ошибки и версию. Каталог может отозвать распространение опасной версии, но это не гарантирует её мгновенную остановку на офлайн-серверах; локальная политика обновления статуса задаётся явно.
## План
1. Общий контракт и модель авторизации, один Rust-плагин приветствий и slash-команда без чтения чата.
2. Изоляция, квоты, таймеры, namespaced KV, обработка сбоев и повторов; негативные тесты.
3. Lua SDK/runner, затем Python component: проверить общий API, нагрузку и зависимости.
4. Установка локального подписанного пакета, lifecycle и обновления без расширения прав.
5. Реестр пакетов Hub и управление установкой из клиента. JS/TS при наличии запроса.
До внедрения Plugin API сначала исправить права/протокол основной платформы: плагин не должен получать полномочия через существующие обходы handlers.
## Первичные источники
- Wasmtime security: https://docs.wasmtime.dev/security.html
- Fuel/epoch interruption: https://docs.wasmtime.dev/examples-interrupting-wasm.html
- Component language support: https://component-model.bytecodealliance.org/language-support.html
- WIT interfaces: https://component-model.bytecodealliance.org/design/wit.html

View file

@ -0,0 +1,179 @@
# Vnox: предложение по серверной архитектуре
Статус: выбранное архитектурное направление по обратной связи пользователя; точные API и криптографические протоколы ещё проектируются. Новый дизайн клиента утверждён и реализуется отдельно. Сервер сообщества всегда обслуживает свой голос локально; отдельные голосовые машины исключены из плана.
## Продуктовая модель
Система состоит из центрального `vnox-hub` и независимых `vnox-server`. Hub — одна логическая служба глобальной сети; каждый сервер сообщества запускается одной программой, объединяющей gateway, голос, SQLite и каталог файлов. Отдельные голосовые машины не проектируются.
Одна обычная установка сервера — одно основное сообщество. Существующие guild_id сохраняются для корректной области прав и совместимости данных; миграция многогильдейских установок потребует отдельного решения. Первый клиентский этап сохраняет одно активное подключение к серверу; удобное одновременное присутствие в нескольких сообществах потребует менеджера соединений.
### Ответственность Hub
- Постоянные user_id, уникальный handle, публичный профиль, зарегистрированные устройства и их отзыв.
- Глобальные друзья, запросы, блокировки и настройки видимости присутствия.
- Реестр server_id, ключей, подтверждённых адресов, описаний, версий протокола и состояния доступности.
- Публичный поиск только для серверов, включивших публикацию. Регистрация ID не означает публичность.
- Персональная очередь зашифрованных личных сообщений и синхронизация между устройствами. Hub хранит ciphertext и служебные метаданные, а не ключи расшифрования. Сам E2EE-протокол и восстановление истории требуют отдельной спецификации.
### Ответственность сервера сообщества
Каналы, категории, роли, членство, приглашения, сообщения и история сообщества, файлы, голосовые комнаты, локальная модерация и аудит. Дружба в Hub не даёт доступа к закрытому сообществу. Hub не получает историю каналов для поиска и не передаёт голосовые пакеты.
Глобальные личные сообщения идут через Hub, а не через случайный общий сервер друзей. Старые server-local DM не превращаются в глобальные автоматически: нужна явная миграция с учётом ключей и участников. Межсерверную федерацию сообщений первой версии не строим.
## Регистрация и доверие серверу
1. Сервер локально создаёт identity; приватный ключ остаётся у владельца.
2. Владелец авторизуется в Hub и регистрирует сервер, доказывая владение ключом. Hub проверяет управление заявленным endpoint и выдаёт постоянный server_id.
3. Hub подписывает запись, связывающую server_id, ключ и адреса, с версией/сроком действия. Клиент проверяет подпись записи и владение сервером соответствующим ключом. TLS остаётся обязательным сетевым механизмом доверия согласно выбранной политике сертификатов; запись Hub не оправдывает отключение проверки TLS.
4. Переезд на другой адрес сохраняет ID. Смена ключа требует подтверждённой процедуры, записи смены и обновления доверия; потерянный ключ не заменяется молча.
5. Публичность настраивается отдельно: public — индексируется; unlisted — доступ по приглашению/точному ID; private — сведения только разрешённым пользователям. Приватный адрес не публикуется в общедоступных ответах реестра.
`server_id` доказывает связь с зарегистрированной identity, а не честность администратора. Знание ID не является правом доступа. Heartbeat показывает свежесть наблюдения о доступности, а не гарантирует доступность для любого клиента.
### Что можно проверить у сборки
Официальные артефакты подписываются и проверяются при установке/обновлении, привязываются к исходникам и процессу сборки. Воспроизводимость позволяет независимо сравнить результат сборки. Это не доказывает, что удалённая машина сейчас исполняет этот артефакт.
Присланный сервером hash/version или ответ на тестовый запрос не является доказательством исполняемого кода. Поэтому интерфейс показывает отдельные факты: «identity зарегистрирована», «endpoint подтверждён», «совместимость проверена», «версия заявлена сервером». Не выдавать значок «безопасный сервер» или «точно неизменённый код» на этой основе.
Удалённая аттестация требует отдельного доверенного источника измерений и связывания с текущей сессией. TPM/TEE и подобная инфраструктура не входят в MVP и не дают абсолютной гарантии отсутствия ошибок, утечек или вредоносного администратора.
## Профиль, устройства и приватность
user_id постоянный; handle уникальный и может меняться по политике переименования; отображаемые имена не обязаны быть уникальными. Сообщество может иметь локальный nickname. Авторизация устройства отделена от права администратора сервера; чужому серверу не передаётся универсальный токен Hub.
Вход на сервер использует доказательство владения ключом устройства и короткоживущее, привязанное к этому server_id подтверждение Hub. Конкретный формат подтверждений, защита от повторов и отзыв задаются общим протоколом. Устройства и учётная запись различаются, чтобы отзыв одного устройства не требовал менять глобальную identity. Протокол обязан задать максимальную задержку отзыва уже активных community-сессий: при недоступном Hub немедленный глобальный отзыв не гарантируется. Верхняя граница задаётся сроком авторизации и политикой проверки свежести, а не бессрочным кэшем.
Поиск людей по умолчанию — точный handle/ID или общие сообщества с разрешённой видимостью. Нельзя перечислять всех пользователей. Запросы в друзья ограничиваются настройками получателя и лимитами. Блокировки действуют и на запросы/DM. Где пользователь находится и во что играет, видно только выбранной аудитории.
Шифрование DM не скрывает автоматически метаданные от Hub: получателей, время, объём и факт связи. Обычные каналы сообщества доступны его серверу; шифрование транспорта не означает E2EE. Восстановление аккаунта и ключей истории — разные процедуры: сброс входа сам по себе не расшифровывает старую историю.
## Сроки хранения глобальной лички
Решение пользователя: сообщения Hub хранятся 7 дней; вложения до 20 МБ хранятся 4 дня. Это политика глобальных DM, не автоматическое ограничение истории сообществ.
- Время задаётся сервером в UTC: message.expires_at = accepted_at + 7×24 часа; attachment.expires_at = upload_completed_at + 4×24 часа. Прочтение, скачивание и повтор запроса с тем же idempotency key не продлевают срок.
- Неотправленные/незавершённые загрузки имеют отдельный короткий TTL и учитываются в квотах; нельзя хранить файлы бессрочно, не завершив сообщение.
- При expires_at API немедленно прекращает выдачу ciphertext и скачивание. Фоновая очистка удаляет объекты, записи, производные данные и кэши с повтором после ошибок и контролем отставания. Нужно задать и проверить отдельный SLA физического удаления до публичного запуска.
- Вложение может исчезнуть раньше сообщения. Клиент показывает срок до отправки и «Срок хранения файла истёк» после, не бесконечную загрузку. Ключ вложения и его метаданные передаются внутри E2EE сообщения.
- Лимит «20 МБ» трактуем как 20 000 000 байт исходного файла. Допустимый размер шифрованной загрузки определяется выбранным форматом с ограниченным overhead; Hub ограничивает реально принятые байты потока, а не доверяет Content-Length. Точные пределы ciphertext фиксируются в спецификации вложений.
- Ограничивается не только один файл: нужны суммарные квоты, число параллельных/незавершённых загрузок и скорость запросов. Лимит 20 МБ сам по себе не ограничивает суммарную нагрузку.
- Вложения приватные: проверка участника DM на каждый download, непрозрачные object_id, отсутствие общедоступных вечных URL. Пересылка ссылки не отменяет истечение срока.
- По умолчанию payload DM и файлы не включаем в долговременные backup. Для оперативных снимков/реплик и журналов задать срок, очистку и защиту от воскрешения expired данных при restore. В логи не попадают текст сообщений, ключи и содержимое файлов.
- Клиентский кэш учитывает expires_at и очищается; давно офлайн-устройство очищается при следующем запуске/синхронизации. Нельзя гарантировать удаление сохранённой получателем копии, скриншота или данных на изменённом клиенте. TTL на Hub не является доказательством стирания всех копий или форензического стирания носителя.
## Безопасность: отдельная спецификация перед глобальными DM
Нужно проектировать протокол и жизненный цикл ключей целиком, а не выбирать только название шифра. Перед реализацией зафиксировать угрозы: подмена сервера/устройства, злонамеренный Hub, утрата устройства, повторы, потери и перестановка пакетов, недоступность центра, вредоносные вложения и исчерпание ресурсов.
1. Сеть: актуальная поддерживаемая реализация TLS 1.3 с проверкой сертификатов; TLS и E2EE решают разные задачи.
2. Личка: проверенная реализация протокола асинхронного обмена с обновлением ключей (семейство Signal key agreement + ratchet — кандидат, не уже выбранная библиотека). Double Ratchet не заменяет первичную аутентификацию, управление устройствами и проверку ключей собеседника.
3. Устройства: отдельные авторизованные ключи, подтверждение добавления, отзыв, заметное изменение identity и возможность сверить fingerprint/QR. Ключи расшифрования остаются на устройствах. Компрометация Hub не должна позволять незаметную подмену доверенного устройства; точная модель transparency/verification требует разбора.
4. Вложения: отдельный случайный ключ на объект, аутентифицированное шифрование на клиенте, ключ внутри E2EE сообщения. Hub хранит ciphertext. Сервер не может одновременно не знать plaintext и обещать его антивирусную проверку; не запускать и не открывать активные файлы автоматически. Ограничивать парсеры превью и распаковку на клиенте.
5. Реализация: библиотеки и их поддержку/лицензии проверить отдельно; никаких собственных схем nonce, обмена ключами или групповой криптографии. Нужны независимое ревью и тесты на replay, tampering, смену/отзыв ключей, потерю пакетов, дубли, истечение TTL и восстановление после сбоя.
Текущий client/server E2EE не считается готовой основой глобальной лички: UI-аудит обнаружил отправку обычным DmSend и несогласованное использование message_id при расшифровании. До согласованного исправления нельзя показывать подтверждённое сквозное шифрование или незаметно отправлять plaintext вместо encrypted DM.
Источники для проработки: [Double Ratchet](https://signal.org/docs/specifications/doubleratchet/), [Sesame: несколько устройств и асинхронные сессии](https://signal.org/docs/specifications/sesame/), [OWASP: ограничения и обработка загрузок](https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html).
## Поиск, доступность и отказ центра
В каталог попадают явно опубликованные карточки: название, описание, язык, теги и политика вступления. Публичный поиск исключает приватные каналы и списки друзей. Модерация каталога, жалобы, rate limits и защита от массовой регистрации нужны до общего публичного запуска.
Уже установленные локальные подключения к серверам не проверяют Hub на каждом сообщении. При недоступности Hub они продолжают работу в рамках своей действующей авторизации. Серверы запускаются с сохранённой identity и регистрацией; отключение центра не выключает голос активных сообществ.
Новый глобальный вход, поиск, изменения друзей и глобальная очередь DM при отказе центра недоступны. Повторное подключение известных участников по кэшированным подтверждениям допускается только в пределах явного срока и политики отзыва; не обещать неограниченную офлайн-авторизацию. Просроченный кэш не превращается в доверенный автоматически. Прямое подключение по сохранённому адресу не обходит локальные bans и права.
## Сценарий подключения
1. Владелец запускает сервер и получает одноразовый способ назначения владельца. Нельзя автоматически назначать владельцем первого произвольного сетевого клиента.
2. Пользователь добавляет адрес или приглашение. Клиент получает подписанную Hub запись server_id и проверяет TLS/владение ключом; смена ключа не принимается молча.
3. Пользователь предъявляет привязанное к серверу подтверждение глобальной identity и доказывает владение авторизованным ключом устройства. Права на конкретном сервере определяются локально.
4. Сервер проверяет допуск: приватное сообщество требует приглашения/существующего членства; публичное может разрешать самостоятельный вход. Подключение к узлу само по себе не даёт доступ ко всем данным.
5. Сервер отправляет согласованный снимок доступных каналов, участников и настроек плюс курсор событий. Затем идут обновления. Границу снимка и потока фиксировать явно, чтобы не терять события между ними.
## Раздельные состояния
`ConnectionSession` хранит аутентификацию, устройство и курсор синхронизации. `VoiceSession` хранит отдельное участие в комнате. Выбранная переписка — клиентское состояние; сервер проверяет доступ к каждому запросу истории или отправки.
Подписки разделяются по объёму: изменения структуры и счётчики непрочитанного для доступных каналов; подробный поток сообщений для открытых разговоров. Переход в текстовый канал или DM не изменяет голос. Доступ перепроверяется при изменении ролей, kick/ban и отзыве приглашения; активные подписки и голос могут быть отозваны.
## Сообщения и восстановление
Команда отправки содержит client_request_id, целевой conversation_id и контент. Сервер проверяет права и лимиты, назначает итоговые ID/время/порядок, сохраняет запись и возвращает подтверждение отправителю. Повтор с тем же ключом в рамках отправителя/устройства возвращает прежний результат, а не создаёт дубль.
Для истории нужны курсоры со стабильным порядком (не один timestamp), пагинация и непрочитанное на основе позиции прочтения. Для reconnect — durable события или версионированное состояние с явной полной пересинхронизацией при невозможности догнать. Запись сообщения и события должна быть согласована транзакцией; outbox понадобится при отдельном фоне доставки.
Потеря событий из очереди не должна ограничиваться записью в лог. Переполненный клиент получает resync_required либо отключается с возможностью догнать. Сетевой reader непрерывно собирает кадры; writer обслуживает ограниченную очередь. Медленный клиент не блокирует обработку других клиентов. Парсинг неполного кадра не должен терять состояние при отмене ожидания.
## Права и членство
Один общий сервис авторизации обслуживает handlers. Права проверяются на сервере для чтения, истории, отправки, редактирования, удаления, управления каналами/ролями, приглашений и голосового подключения/передачи. Решение учитывает фактическое членство, владельца, роли и channel overrides с явно определённым порядком применения. Управление ролями не должно позволять повысить себя выше выданных полномочий.
Выход из сообщества затрагивает только самого пользователя; удаление другого — отдельная проверяемая команда kick. Приватный join не обходит invite. Удаление членства, назначений ролей и обновление активных сессий должны быть согласованы.
## Голос
Gateway проверяет подключение к комнате и выдаёт короткоживущий допуск, связанный с пользователем, сессией, комнатой и локальным голосовым модулем сервера. Клиент регистрируется на локальном голосовом модуле из настоящего UDP-сокета; адрес не берётся из TCP-порта. Relay проверяет допуск и подтверждение владения сессией. Одного знания channel_id или endpoint недостаточно.
Использовать единую модель channel_id между хранилищем, протоколом и relay. При необходимости компактный числовой идентификатор выдаётся явным отображением, а не parse строкового имени. Пакеты несут явный номер последовательности/epoch; потеря пакета не сбивает расшифровку последующих. Аудит текущего кода выявил усечение sequence до32бит при построении nonce: до повторного использования необходимо обновить ключи/сессию или завершить соединение. Обновление crypto-crates само по себе эту протокольную проблему не устраняет. Нужны replay window, ограничения размера/скорости и обновление ключей/nonce space.
Heartbeat сохраняет молчащих слушателей. Выход, kick, ban, смена комнаты и отзыв прав очищают допуск и маршрут. Jitter и смешивание относятся к отдельным потокам отправителей; итоговую задержку оценивать с учётом буферов relay и клиента.
Криптографический режим голоса остаётся открытым решением: transport encryption до доверенного relay либо настоящее групповое E2EE с управлением ключами и их сменой при изменении состава. Текущий relay нельзя называть работающим E2EE без проверки распределения ключей. Не проектировать собственную групповую криптографию поверх текущего session crypto без отдельного протокольного разбора.
## Хранение и эксплуатация
SQLite — простой стартовый backend. PostgreSQL остаётся альтернативой, проверяемой теми же сценариями; сам выбор PostgreSQL не даёт кластеризацию. Переход к нескольким gateway требует согласованных сессий, маршрутизации и событий.
Нужны последовательные миграции БД, восстановление сохранённых каналов при старте, корректный shutdown, диагностика состояния и проверяемый backup/restore. Резервная копия включает БД, файлы, конфигурацию и identity сервера; секреты защищаются отдельно. Presence отражает живые сессии и не восстанавливается как вечный ONLINE из БД.
Вложения — отдельный этап: хранилище объектов/каталог, лимиты, квоты и проверка права скачивания. Административные операции имеют отдельные права и журнал; admin API по умолчанию локальный, удалённый доступ явно защищён.
## Приоритет реализации
Минимальный Hub включает реестр, identity, друзей и поиск. Глобальный E2EE mailbox, синхронизация устройств и восстановление истории — следующий отдельный этап, а не условие запуска первого реестра. До этого личные сообщения явно помечаются как server-local; их нельзя показывать как уже глобальные.
1. Зафиксировать границы Hub/сообщества и общий protocol crate, подключить клиент к Protobuf/TLS.
2. Создать минимальный Hub: registry, server_id/ключи, user_id/устройства и привязанные к серверу подтверждения. Глобальные друзья/поиск идут следующим слоем, DM — после спецификации E2EE.
3. Закрыть авторизацию членства и операций; восстановление данных и миграции.
4. Разделить просмотр переписки, подписки и VoiceSession.
5. Согласовать UDP registration, ID, heartbeat и криптографический режим голоса.
6. Доставка с подтверждением, идемпотентность, история и reconnect/resync.
7. Проверить два клиента: сообщения, голос, переключение, обрыв, повторная отправка, kick и рестарт сервера.
8. Затем обсуждения/вложения и расширение глобальных функций. Отдельные голосовые машины исключены. Межсерверная федерация позже и только при реальной потребности.
## Подтверждённые ограничения текущего кода
- `domain/session.rs`: единственный channel_id объединяет текст и голос.
- `handler/deliver.rs`: доставка по текущему каналу; глобальные события требуют проверки области видимости.
- `handler/run.rs`: Lagged только логируется; read_encrypted содержит read_exact внутри select.
- `handler/content/chat.rs`: время клиента сохраняется, если ненулевое; нет полноценного ack отправителю.
- `handler/guild/members.rs`: join добавляет членство напрямую; leave принимает чужой user_id без kick-проверки.
- `gateway/src/lib.rs`: при создании State используется new_store; существующий load_channels_to_cache не подключён.
- `net/state.rs`: signalling голоса — broadcast строк JSON внутри процесса.
- `voice-node/src/runner.rs`: UDP отправитель самостоятельно добавляется по channel_id.
- Клиент сериализует JSON, gateway использует Protobuf; это блокирует совместный сценарий до согласования протокола.
## Источники по границам проверки кода
- Sigstore: проверка подписей артефактов — https://docs.sigstore.dev/cosign/verifying/verify/
- Reproducible Builds: что означает воспроизводимость — https://reproducible-builds.org/docs/definition/
- IETF RFC 9334: модель доверия и evidence для remote attestation — https://www.rfc-editor.org/rfc/rfc9334.html
Эти механизмы решают разные задачи. Подпись дистрибутива не является удалённой аттестацией процесса.
## Согласование старой документации
`docs/05-features/central-hub.md` описывает прежний необязательный Hub без хранения DM; `docs/02-protocol/identity.md` отрицает центральный реестр. Они требуют обновления перед реализацией нового контракта. Этот документ фиксирует новое направление и не утверждает, что Hub уже реализован.
## Плагины и маркетплейс
Новое направление: WASM-плагины на сервере сообщества, общий Plugin API и SDK для Rust/Lua/Python; Wasmtime — основной кандидат. Каталог и immutable release-пакеты находятся в Hub. Плагины работают с явными правами и лимитами, не получают глобальную E2EE-личку или полный доступ к host. Отдельные голосовые машины не требуются. Подробная модель: [plugins-and-marketplace.md](plugins-and-marketplace.md).
## Регистрация и профили
Для первого Hub предлагаются GitHub OAuth и email-код, с устойчивым внутренним user_id, явной привязкой способов входа и отдельными ключами устройств. Подробности и UX редактора аватара: [accounts-and-avatars.md](accounts-and-avatars.md).

View file

@ -0,0 +1,50 @@
# Server dependency refresh
Rust edition 2024; installed rustc1.99.0; declared workspace+children rust-version1.94 (SQLx0.9.0 requires1.94). Old declaration1.85 was already false. Older1.94 toolchain not independently tested.
| Dependency | Old lock versions | New lock versions |
|---|---|---|
| anyhow | 1.0.103 | 1.0.104 |
| argon2 | 0.5.3 | removed |
| axum | 0.8.9 | 0.8.9 |
| bitflags | 2.13.0 | 2.13.2 |
| chacha20poly1305 | 0.10.1 | 0.11.0 |
| ed25519-dalek | 2.2.0 | 3.0.0 |
| hex | 0.4.3 | 0.4.3 |
| hkdf | 0.13.0 | 0.13.0 |
| opus | 0.3.1 | removed |
| prost | 0.13.5 | 0.14.4 |
| prost-build | 0.13.5 | 0.14.4 |
| rand | 0.8.6, 0.9.4, 0.10.2 | 0.10.3 |
| rcgen | 0.13.2 | 0.14.10 |
| rustls | 0.23.41 | 0.23.46 |
| rustls-pki-types | 1.15.0 | 1.15.1 |
| serde | 1.0.228 | 1.0.229 |
| serde_json | 1.0.150 | 1.0.154 |
| sha2 | 0.10.9, 0.11.0 | 0.10.9, 0.11.1 |
| sqlx | 0.9.0 | 0.9.0 |
| thiserror | 2.0.18 | 2.0.21 |
| tokio | 1.52.3 | 1.54.1 |
| tokio-rustls | 0.26.4 | 0.26.6 |
| toml | 1.1.2+spec-1.1.0 | 1.1.8+spec-1.1.0 |
| tower | 0.5.3 | 0.5.3 |
| tracing | 0.1.44 | 0.1.44 |
| tracing-subscriber | 0.3.23 | 0.3.23 |
| uuid | 1.23.4 | 1.29.0 |
| x25519-dalek | 2.0.1 | 3.0.0 |
Removed unused direct declarations: argon2, opus, thiserror, tower, rustls-pki-types; serverd serde/serde_json. tower/pki-types/thiserror remain transitively where needed. Removed unused Axum ws feature; trimmed Tokio full to fs/io-util/macros/net/rt-multi-thread/sync/time.
Crypto/RCGen migrations: rand rng/trait updates, Key/Nonce owned array conversions, CertifiedKey.signing_key. Two crypto regression tests check independent Python-cryptography fixture and tamper rejection. No wire/algorithm semantics changes.
Verified: cargo check --workspace; cargo test --workspace (33 tests); cargo build --workspace; cargo clippy --all-targets -- -D warnings; cargo fmt --check; git diff --check. cargo audit --no-fetch --json:0 vulnerabilities,0 warnings (before7 vulnerabilities plus unsound/yanked warnings). Advisory DB was freshly fetched immediately before baseline.
Limitations: no end-to-end network runtime test, no older MSRV toolchain run, no assurance against unknown vulnerabilities. Existing u32 nonce counter space/rekey limitation remains protocol follow-up.
Keep Axum for admin HTTP/Hub, Tokio for runtime+raw TCP/UDP, SQLx for SQLite/PostgreSQL, rustls and RustCrypto/Dalek libraries rather than reimplement. Main gateway is LNEx over raw TCP, not Axum WebSocket.
Registry discrepancy: crates.io API reported old toml0.9.8 while Cargo registry resolved existing1.1 line to1.1.8+spec-1.1.0; no downgrade made.
Sources: https://docs.rs/axum/latest/axum/ https://docs.rs/prost/latest/prost/ https://rustsec.org/ and crates.io API/Cargo registry metadata.
Docker builder images updated from Rust1.85 to verified available rust:1.99-slim-bookworm; builds use --locked. Removed unnecessary libopus/libssl packages, added protobuf-compiler. Docker images were not built during this task. Official stable toolchain manifest currently reports1.99.1; local validations used installed1.99.0, without changing workstation-global Rust.

View file

@ -3,6 +3,7 @@ name = "vnox-gateway"
description = "VNOX gateway — auth, channels, sessions, permissions" description = "VNOX gateway — auth, channels, sessions, permissions"
version.workspace = true version.workspace = true
edition.workspace = true edition.workspace = true
rust-version.workspace = true
license.workspace = true license.workspace = true
authors.workspace = true authors.workspace = true
repository.workspace = true repository.workspace = true
@ -24,27 +25,23 @@ x25519-dalek.workspace = true
chacha20poly1305.workspace = true chacha20poly1305.workspace = true
hkdf.workspace = true hkdf.workspace = true
sha2.workspace = true sha2.workspace = true
argon2.workspace = true
rand.workspace = true rand.workspace = true
tracing.workspace = true tracing.workspace = true
tracing-subscriber.workspace = true tracing-subscriber.workspace = true
anyhow.workspace = true anyhow.workspace = true
thiserror.workspace = true
toml.workspace = true toml.workspace = true
uuid.workspace = true uuid.workspace = true
hex.workspace = true hex.workspace = true
axum = { version = "0.8", features = ["ws"] } axum = "0.8"
tower = "0.5"
sqlx = { version = "0.9", features = ["sqlite", "postgres", "runtime-tokio", "tls-rustls"] } sqlx = { version = "0.9", features = ["sqlite", "postgres", "runtime-tokio", "tls-rustls"] }
bitflags = "2" bitflags = "2"
prost = "0.13" prost = "0.14"
# TLS 1.3 support # TLS 1.3 support
rustls-pki-types = "1"
rustls = "0.23" rustls = "0.23"
tokio-rustls = "0.26" tokio-rustls = "0.26"
rcgen = "0.13" rcgen = "0.14"
[build-dependencies] [build-dependencies]
prost-build = "0.13" prost-build = "0.14"

View file

@ -1,6 +1,5 @@
use anyhow::Result; use anyhow::Result;
use ed25519_dalek::SigningKey; use ed25519_dalek::SigningKey;
use rand::rngs::OsRng;
use serde::{Deserialize, Serialize}; use serde::{Deserialize, Serialize};
use std::path::Path; use std::path::Path;
@ -41,7 +40,7 @@ impl ServerIdentity {
return Ok(Self { signing_key }); return Ok(Self { signing_key });
} }
let signing_key = SigningKey::generate(&mut OsRng); let signing_key = SigningKey::generate(&mut rand::rng());
let verifying_key = signing_key.verifying_key(); let verifying_key = signing_key.verifying_key();
let pubkey_hex = hex::encode(verifying_key.to_bytes()); let pubkey_hex = hex::encode(verifying_key.to_bytes());

View file

@ -11,9 +11,9 @@ pub fn verify_auth(challenge: &[u8; 32], pubkey: &[u8; 32], signature: &[u8; 64]
/// Random 32-byte challenge nonce for HELLO. /// Random 32-byte challenge nonce for HELLO.
pub fn new_challenge() -> [u8; 32] { pub fn new_challenge() -> [u8; 32] {
use rand::RngCore; use rand::Rng;
let mut n = [0u8; 32]; let mut n = [0u8; 32];
rand::thread_rng().fill_bytes(&mut n); rand::rng().fill_bytes(&mut n);
n n
} }
@ -21,11 +21,10 @@ pub fn new_challenge() -> [u8; 32] {
mod tests { mod tests {
use super::*; use super::*;
use ed25519_dalek::{Signer, SigningKey}; use ed25519_dalek::{Signer, SigningKey};
use rand::rngs::OsRng;
#[test] #[test]
fn verify_auth_accepts_valid_signature() { fn verify_auth_accepts_valid_signature() {
let sk = SigningKey::generate(&mut OsRng); let sk = SigningKey::generate(&mut rand::rng());
let vk = sk.verifying_key(); let vk = sk.verifying_key();
let challenge = [7u8; 32]; let challenge = [7u8; 32];
let sig = sk.sign(&challenge); let sig = sk.sign(&challenge);
@ -34,7 +33,7 @@ mod tests {
#[test] #[test]
fn verify_auth_rejects_tampered_challenge() { fn verify_auth_rejects_tampered_challenge() {
let sk = SigningKey::generate(&mut OsRng); let sk = SigningKey::generate(&mut rand::rng());
let vk = sk.verifying_key(); let vk = sk.verifying_key();
let challenge = [7u8; 32]; let challenge = [7u8; 32];
let sig = sk.sign(&challenge); let sig = sk.sign(&challenge);

View file

@ -445,7 +445,13 @@ pub struct ChannelRecord {
} }
impl Storage { impl Storage {
pub async fn create_channel(&self, id: &str, name: &str, kind: &str, guild_id: Option<&str>) -> Result<bool> { pub async fn create_channel(
&self,
id: &str,
name: &str,
kind: &str,
guild_id: Option<&str>,
) -> Result<bool> {
match &self.pool { match &self.pool {
Pool::Sqlite(p) => { Pool::Sqlite(p) => {
let result = sqlx::query( let result = sqlx::query(
@ -552,7 +558,8 @@ impl Storage {
"voice" => ChannelKind::Voice, "voice" => ChannelKind::Voice,
_ => ChannelKind::Text, _ => ChannelKind::Text,
}; };
crate::domain::channels::create(channel_store, &ch.id, &ch.name, kind, ch.guild_id).await; crate::domain::channels::create(channel_store, &ch.id, &ch.name, kind, ch.guild_id)
.await;
} }
Ok(()) Ok(())
} }

View file

@ -98,14 +98,26 @@ pub async fn handle_channel_create(
let guild_id = req.guild_id.clone(); let guild_id = req.guild_id.clone();
let created = channels::create(&state.channels, &channel_id, &channel_name, kind.clone(), guild_id.clone()).await; let created = channels::create(
&state.channels,
&channel_id,
&channel_name,
kind.clone(),
guild_id.clone(),
)
.await;
// Persist to DB (best-effort, log and continue on failure). // Persist to DB (best-effort, log and continue on failure).
#[allow(clippy::collapsible_if)] #[allow(clippy::collapsible_if)]
if created { if created {
if let Err(e) = state if let Err(e) = state
.storage .storage
.create_channel(&channel_id, &channel_name, kind.as_str(), guild_id.as_deref()) .create_channel(
&channel_id,
&channel_name,
kind.as_str(),
guild_id.as_deref(),
)
.await .await
{ {
warn!("failed to persist channel to storage: {e}"); warn!("failed to persist channel to storage: {e}");

View file

@ -29,18 +29,10 @@ pub async fn join(
state: &State, state: &State,
addr: SocketAddr, addr: SocketAddr,
) -> Result<()> { ) -> Result<()> {
let prev_channel = session::get(&state.sessions, session_id) let Some(sess) = session::get(&state.sessions, session_id).await else {
.await
.and_then(|s| s.channel_id);
if prev_channel.as_deref() == Some(channel_id) {
return Ok(()); return Ok(());
} };
let prev_channel = sess.channel_id;
if let Some(prev) = prev_channel {
channels::leave(&state.channels, &prev, session_id).await;
broadcast_leave(state, &prev, session_id).await;
}
let ch = match channels::get_channel(&state.channels, channel_id).await { let ch = match channels::get_channel(&state.channels, channel_id).await {
Some(c) => c, Some(c) => c,
@ -60,6 +52,40 @@ pub async fn join(
} }
}; };
// Validate the destination before changing membership or exposing its history.
// Role assignments alone are insufficient: a kicked user can retain stale roles.
if let Some(guild_id) = ch.guild_id.as_deref() {
let is_member = state
.storage
.list_user_guilds(&sess.user_id)
.await?
.iter()
.any(|guild| guild.id == guild_id);
if !is_member {
io::send_encrypted(
stream,
PacketId::Error,
seq,
&to_payload(&proto::ErrorPayload {
code: proto::ErrorCode::PermissionDenied as u32,
message: "guild membership required".into(),
}),
crypto,
)
.await?;
return Ok(());
}
}
if prev_channel.as_deref() == Some(channel_id) {
return Ok(());
}
if let Some(prev) = prev_channel {
channels::leave(&state.channels, &prev, session_id).await;
broadcast_leave(state, &prev, session_id).await;
}
channels::join(&state.channels, channel_id, session_id).await; channels::join(&state.channels, channel_id, session_id).await;
set_channel(state, session_id, Some(channel_id.into())).await; set_channel(state, session_id, Some(channel_id.into())).await;
@ -130,3 +156,6 @@ pub async fn join(
info!("session {} joined {channel_id}", &session_id[..8]); info!("session {} joined {channel_id}", &session_id[..8]);
Ok(()) Ok(())
} }
#[cfg(test)]
mod tests;

View file

@ -0,0 +1,145 @@
use super::*;
use std::sync::{Arc, atomic::AtomicUsize};
async fn fixture() -> (State, String) {
let storage = crate::domain::storage::Storage::connect_sqlite(":memory:")
.await
.unwrap();
let config = toml::from_str(include_str!("../../../../../dev/config.toml")).unwrap();
let identity_dir =
std::env::temp_dir().join(format!("vnox-join-test-{}", uuid::Uuid::new_v4()));
let identity =
crate::bootstrap::server_identity::ServerIdentity::load_or_generate(&identity_dir).unwrap();
std::fs::remove_file(identity_dir.join("server_identity.json")).unwrap();
std::fs::remove_dir(identity_dir).unwrap();
let (broadcast, _) = tokio::sync::broadcast::channel(16);
let state = State::new(
session::new_store(),
channels::new_store(),
Arc::new(storage),
Arc::new(config),
Arc::new(identity),
broadcast,
crate::admin::metrics::Metrics::new(),
Arc::new(AtomicUsize::new(0)),
Arc::new(AtomicUsize::new(0)),
None,
);
let sess = session::create(&state.sessions, "visitor".into(), "Visitor".into()).await;
channels::join(&state.channels, "general", &sess.session_id).await;
set_channel(&state, &sess.session_id, Some("general".into())).await;
(state, sess.session_id)
}
async fn attempt_join(state: &State, session_id: &str, channel_id: &str) {
let (mut stream, _peer) = tokio::io::duplex(65536);
join(
&mut stream,
&mut 0,
session_id,
channel_id,
&SessionCrypto::derive(&[7; 32], session_id),
state,
"127.0.0.1:12345".parse().unwrap(),
)
.await
.unwrap();
}
#[tokio::test]
async fn missing_channel_keeps_previous_membership() {
let (state, sid) = fixture().await;
attempt_join(&state, &sid, "missing").await;
assert!(
channels::members(&state.channels, "general")
.await
.contains(&sid)
);
assert_eq!(
session::get(&state.sessions, &sid)
.await
.unwrap()
.channel_id
.as_deref(),
Some("general")
);
}
#[tokio::test]
async fn outsider_cannot_join_guild_channel_or_lose_previous_membership() {
let (state, sid) = fixture().await;
let guild_id = state
.storage
.create_guild("owner", "Private guild")
.await
.unwrap();
channels::create(
&state.channels,
"private",
"Private",
channels::ChannelKind::Text,
Some(guild_id),
)
.await;
attempt_join(&state, &sid, "private").await;
assert!(
!channels::members(&state.channels, "private")
.await
.contains(&sid)
);
assert!(
channels::members(&state.channels, "general")
.await
.contains(&sid)
);
assert_eq!(
session::get(&state.sessions, &sid)
.await
.unwrap()
.channel_id
.as_deref(),
Some("general")
);
}
#[tokio::test]
async fn guild_member_can_switch_channels() {
let (state, sid) = fixture().await;
let guild_id = state
.storage
.create_guild("owner", "Private guild")
.await
.unwrap();
state
.storage
.add_guild_member(&guild_id, "visitor")
.await
.unwrap();
channels::create(
&state.channels,
"private",
"Private",
channels::ChannelKind::Text,
Some(guild_id),
)
.await;
attempt_join(&state, &sid, "private").await;
assert!(
channels::members(&state.channels, "private")
.await
.contains(&sid)
);
assert!(
!channels::members(&state.channels, "general")
.await
.contains(&sid)
);
assert_eq!(
session::get(&state.sessions, &sid)
.await
.unwrap()
.channel_id
.as_deref(),
Some("private")
);
}

View file

@ -79,12 +79,7 @@ pub async fn dispatch<S: AsyncRead + AsyncWrite + Unpin>(
} }
PacketId::ChannelList => { PacketId::ChannelList => {
channel::handle_channel_list( channel::handle_channel_list(
ctx.stream, ctx.stream, ctx.seq, session_id, payload, ctx.crypto, ctx.state,
ctx.seq,
session_id,
payload,
ctx.crypto,
ctx.state,
) )
.await?; .await?;
} }

View file

@ -150,7 +150,9 @@ async fn run_tls(
match listener.accept().await { match listener.accept().await {
Ok((stream, addr)) => { Ok((stream, addr)) => {
let current = conn_count.load(std::sync::atomic::Ordering::Relaxed); let current = conn_count.load(std::sync::atomic::Ordering::Relaxed);
if let Some(limit) = max_connections && current >= limit { if let Some(limit) = max_connections
&& current >= limit
{
warn!("connection rejected from {addr}: at max_connections ({limit})"); warn!("connection rejected from {addr}: at max_connections ({limit})");
drop(stream); drop(stream);
continue; continue;
@ -188,7 +190,9 @@ async fn run_plain(
match listener.accept().await { match listener.accept().await {
Ok((stream, addr)) => { Ok((stream, addr)) => {
let current = conn_count.load(std::sync::atomic::Ordering::Relaxed); let current = conn_count.load(std::sync::atomic::Ordering::Relaxed);
if let Some(limit) = max_connections && current >= limit { if let Some(limit) = max_connections
&& current >= limit
{
warn!("connection rejected from {addr}: at max_connections ({limit})"); warn!("connection rejected from {addr}: at max_connections ({limit})");
drop(stream); drop(stream);
continue; continue;
@ -335,7 +339,7 @@ fn load_or_generate_tls_certs(
let certified_key = rcgen::generate_simple_self_signed(vec!["VNOX Server".into()])?; let certified_key = rcgen::generate_simple_self_signed(vec!["VNOX Server".into()])?;
let cert_der = certified_key.cert.der().clone(); let cert_der = certified_key.cert.der().clone();
let key_der = PrivateKeyDer::from(PrivatePkcs8KeyDer::from( let key_der = PrivateKeyDer::from(PrivatePkcs8KeyDer::from(
certified_key.key_pair.serialize_der(), certified_key.signing_key.serialize_der(),
)); ));
Ok((vec![cert_der], key_der)) Ok((vec![cert_der], key_der))
} }

View file

@ -16,12 +16,12 @@ pub(super) fn encrypt_with_key(
seq: u64, seq: u64,
plaintext: &[u8], plaintext: &[u8],
) -> Vec<u8> { ) -> Vec<u8> {
let cipher = ChaCha20Poly1305::new(Key::from_slice(key)); let cipher = ChaCha20Poly1305::new(&Key::from(*key));
let nonce_bytes = make_nonce(cid, seq); let nonce_bytes = make_nonce(cid, seq);
let nonce = Nonce::from_slice(&nonce_bytes); let nonce = Nonce::from(nonce_bytes);
cipher cipher
.encrypt( .encrypt(
nonce, &nonce,
Payload { Payload {
msg: plaintext, msg: plaintext,
aad: &[], aad: &[],
@ -36,12 +36,12 @@ pub(super) fn decrypt_with_key(
seq: u64, seq: u64,
ciphertext: &[u8], ciphertext: &[u8],
) -> anyhow::Result<Vec<u8>> { ) -> anyhow::Result<Vec<u8>> {
let cipher = ChaCha20Poly1305::new(Key::from_slice(key)); let cipher = ChaCha20Poly1305::new(&Key::from(*key));
let nonce_bytes = make_nonce(cid, seq); let nonce_bytes = make_nonce(cid, seq);
let nonce = Nonce::from_slice(&nonce_bytes); let nonce = Nonce::from(nonce_bytes);
cipher cipher
.decrypt( .decrypt(
nonce, &nonce,
Payload { Payload {
msg: ciphertext, msg: ciphertext,
aad: &[], aad: &[],
@ -49,3 +49,36 @@ pub(super) fn decrypt_with_key(
) )
.map_err(|e| anyhow::anyhow!("decryption failed: {e:?}")) .map_err(|e| anyhow::anyhow!("decryption failed: {e:?}"))
} }
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn wire_ciphertext_matches_independent_chacha20_poly1305_vector() {
let key = std::array::from_fn(|index| index as u8);
let cid = [0x07, 0x00, 0x00, 0x00, 0x40, 0x41, 0x42, 0x43];
let seq = 0x4746_4544;
let plaintext = b"VNOX dependency migration";
// Cross-checked with Python cryptography's ChaCha20Poly1305 implementation,
// IETF nonce 070000004041424344454647, and empty associated data.
let expected = hex::decode(
"1fa23e7a312509b0fc8729521811348ff880daa5598c43a57635975f81278abdf4461b25af86aee1c3",
)
.unwrap();
assert_eq!(encrypt_with_key(&key, &cid, seq, plaintext), expected);
assert_eq!(
decrypt_with_key(&key, &cid, seq, &expected).unwrap(),
plaintext
);
}
#[test]
fn tampered_ciphertext_is_rejected() {
let key = [7; 32];
let cid = [9; 8];
let mut ciphertext = encrypt_with_key(&key, &cid, 42, b"authenticated");
ciphertext[0] ^= 1;
assert!(decrypt_with_key(&key, &cid, 42, &ciphertext).is_err());
}
}

View file

@ -43,7 +43,7 @@ impl SessionCrypto {
} }
pub fn new_ephemeral() -> (EphemeralSecret, PublicKey) { pub fn new_ephemeral() -> (EphemeralSecret, PublicKey) {
let mut rng = rand::thread_rng(); let mut rng = rand::rng();
let sk = EphemeralSecret::random_from_rng(&mut rng); let sk = EphemeralSecret::random_from_rng(&mut rng);
let pk = PublicKey::from(&sk); let pk = PublicKey::from(&sk);
(sk, pk) (sk, pk)
@ -96,7 +96,7 @@ mod tests {
#[test] #[test]
fn ecdh_derives_same_secret_on_both_sides() { fn ecdh_derives_same_secret_on_both_sides() {
let mut rng = rand::thread_rng(); let mut rng = rand::rng();
let alice_sk = EphemeralSecret::random_from_rng(&mut rng); let alice_sk = EphemeralSecret::random_from_rng(&mut rng);
let alice_pk = PublicKey::from(&alice_sk); let alice_pk = PublicKey::from(&alice_sk);

View file

@ -3,6 +3,7 @@ name = "vnox-serverd"
description = "VNOX unified server — gateway TCP + voice UDP in one binary" description = "VNOX unified server — gateway TCP + voice UDP in one binary"
version.workspace = true version.workspace = true
edition.workspace = true edition.workspace = true
rust-version.workspace = true
license.workspace = true license.workspace = true
authors.workspace = true authors.workspace = true
repository.workspace = true repository.workspace = true
@ -20,5 +21,3 @@ tracing.workspace = true
tracing-subscriber.workspace = true tracing-subscriber.workspace = true
anyhow.workspace = true anyhow.workspace = true
toml.workspace = true toml.workspace = true
serde.workspace = true
serde_json.workspace = true

View file

@ -3,6 +3,7 @@ name = "vnox-voice-node"
description = "VNOX voice node — UDP relay, Opus, jitter buffer" description = "VNOX voice node — UDP relay, Opus, jitter buffer"
version.workspace = true version.workspace = true
edition.workspace = true edition.workspace = true
rust-version.workspace = true
license.workspace = true license.workspace = true
authors.workspace = true authors.workspace = true
repository.workspace = true repository.workspace = true
@ -17,11 +18,9 @@ path = "src/main.rs"
[dependencies] [dependencies]
tokio.workspace = true tokio.workspace = true
opus.workspace = true
tracing.workspace = true tracing.workspace = true
tracing-subscriber.workspace = true tracing-subscriber.workspace = true
anyhow.workspace = true anyhow.workspace = true
thiserror.workspace = true
toml.workspace = true toml.workspace = true
serde.workspace = true serde.workspace = true
serde_json.workspace = true serde_json.workspace = true

View file

@ -7,14 +7,12 @@ use tokio::net::UdpSocket;
use tokio::sync::RwLock; use tokio::sync::RwLock;
use tracing::debug; use tracing::debug;
/// Per-channel state: members, jitter buffer, and sender tracking. /// Per-channel membership and independent jitter buffers for each sender.
pub struct ChannelState { pub struct ChannelState {
/// member address → last packet time /// member address → last packet time
pub members: HashMap<SocketAddr, Instant>, pub members: HashMap<SocketAddr, Instant>,
/// reorders and smooths voice packets /// Sender address → jitter buffer; sequence numbers are local to each sender.
pub jitter: JitterBuffer, pub streams: HashMap<SocketAddr, JitterBuffer>,
/// voice_seq → original sender address (for relay after pop)
pub senders: HashMap<u32, SocketAddr>,
} }
/// Maps channel_id → per-channel state. /// Maps channel_id → per-channel state.
@ -30,6 +28,9 @@ pub async fn cleanup_stale(channels: &ChannelMap, max_idle: Duration) {
let mut lock = channels.write().await; let mut lock = channels.write().await;
lock.retain(|_, state| { lock.retain(|_, state| {
state.members.retain(|_, last_seen| *last_seen >= cutoff); state.members.retain(|_, last_seen| *last_seen >= cutoff);
state
.streams
.retain(|sender, _| state.members.contains_key(sender));
!state.members.is_empty() !state.members.is_empty()
}); });
} }
@ -54,27 +55,27 @@ pub async fn push_packet(
let mut lock = channels.write().await; let mut lock = channels.write().await;
let state = lock.entry(channel_id).or_insert_with(|| ChannelState { let state = lock.entry(channel_id).or_insert_with(|| ChannelState {
members: HashMap::new(), members: HashMap::new(),
jitter: JitterBuffer::new(40, true), streams: HashMap::new(),
senders: HashMap::new(),
}); });
state.jitter.push(pkt); state
state.senders.insert(voice_seq, sender); .streams
.entry(sender)
.or_insert_with(|| JitterBuffer::new(40, true))
.push(pkt);
} }
/// Pop ready packets from every channel's jitter buffer and relay them. /// Pop ready packets from every channel's jitter buffer and relay them.
pub async fn pop_and_relay(socket: &UdpSocket, channels: &ChannelMap, now_ms: u64) { pub async fn pop_and_relay(socket: &UdpSocket, channels: &ChannelMap, now_ms: u64) {
let mut lock = channels.write().await; let mut lock = channels.write().await;
for (_channel_id, state) in lock.iter_mut() { for state in lock.values_mut() {
while let Some(pkt) = state.jitter.pop_ready(now_ms) { for (sender, jitter) in &mut state.streams {
let sender = state.senders.remove(&pkt.voice_seq).unwrap_or_else(|| { while let Some(pkt) = jitter.pop_ready(now_ms) {
tracing::warn!("sender not found for seq={}", pkt.voice_seq); for &addr in state.members.keys() {
SocketAddr::from(([0, 0, 0, 0], 0)) if addr != *sender
}); && let Err(e) = socket.send_to(&pkt.opus_data, addr).await
for &addr in state.members.keys() { {
if addr != sender debug!("relay send error to {addr}: {e}");
&& let Err(e) = socket.send_to(&pkt.opus_data, addr).await }
{
debug!("relay send error to {addr}: {e}");
} }
} }
} }
@ -89,8 +90,7 @@ pub async fn touch_member(channels: &ChannelMap, channel_id: u64, addr: SocketAd
.entry(channel_id) .entry(channel_id)
.or_insert_with(|| ChannelState { .or_insert_with(|| ChannelState {
members: HashMap::new(), members: HashMap::new(),
jitter: JitterBuffer::new(40, true), streams: HashMap::new(),
senders: HashMap::new(),
}) })
.members .members
.insert(addr, Instant::now()); .insert(addr, Instant::now());
@ -119,7 +119,7 @@ pub async fn remove_member_from_all(channels: &ChannelMap, addr: &SocketAddr) {
let mut lock = channels.write().await; let mut lock = channels.write().await;
lock.retain(|_, state| { lock.retain(|_, state| {
state.members.remove(addr); state.members.remove(addr);
state.senders.retain(|_, s| s != addr); state.streams.remove(addr);
!state.members.is_empty() !state.members.is_empty()
}); });
} }
@ -143,7 +143,7 @@ mod tests {
let lock = channels.read().await; let lock = channels.read().await;
let state = lock.get(&42).unwrap(); let state = lock.get(&42).unwrap();
assert!(state.members.contains_key(&addr)); assert!(state.members.contains_key(&addr));
assert!(state.jitter.is_empty()); assert!(state.streams.is_empty());
} }
} }
@ -156,7 +156,7 @@ mod tests {
{ {
let lock = channels.read().await; let lock = channels.read().await;
let state = lock.get(&7).unwrap(); let state = lock.get(&7).unwrap();
assert_eq!(state.jitter.len(), 1); assert_eq!(state.streams.get(&addr).unwrap().len(), 1);
} }
} }
@ -200,6 +200,69 @@ mod tests {
} }
} }
#[tokio::test]
async fn simultaneous_speakers_with_same_sequence_both_reach_listener() {
let channels = new_channel_map();
let relay = UdpSocket::bind("127.0.0.1:0").await.unwrap();
let listener = UdpSocket::bind("127.0.0.1:0").await.unwrap();
let first_socket = UdpSocket::bind("127.0.0.1:0").await.unwrap();
let second_socket = UdpSocket::bind("127.0.0.1:0").await.unwrap();
let first = first_socket.local_addr().unwrap();
let second = second_socket.local_addr().unwrap();
touch_member(&channels, 7, first).await;
touch_member(&channels, 7, second).await;
touch_member(&channels, 7, listener.local_addr().unwrap()).await;
push_packet(&channels, 7, first, 1, 1000, b"first", 0).await;
push_packet(&channels, 7, second, 1, 1000, b"second", 0).await;
pop_and_relay(&relay, &channels, 100).await;
let mut received = Vec::new();
for _ in 0..2 {
let mut buffer = [0; 32];
let (len, _) =
tokio::time::timeout(Duration::from_secs(1), listener.recv_from(&mut buffer))
.await
.expect("both speakers must be relayed")
.unwrap();
received.push(buffer[..len].to_vec());
}
received.sort();
assert_eq!(received, vec![b"first".to_vec(), b"second".to_vec()]);
for (speaker, expected) in [
(&first_socket, b"second".as_slice()),
(&second_socket, b"first".as_slice()),
] {
let mut buffer = [0; 32];
let (len, _) =
tokio::time::timeout(Duration::from_secs(1), speaker.recv_from(&mut buffer))
.await
.expect("speaker must receive the other participant")
.unwrap();
assert_eq!(&buffer[..len], expected);
}
}
#[tokio::test]
async fn departing_speaker_drops_buffered_audio() {
let channels = new_channel_map();
let relay = UdpSocket::bind("127.0.0.1:0").await.unwrap();
let listener = UdpSocket::bind("127.0.0.1:0").await.unwrap();
let speaker = test_addr(1);
touch_member(&channels, 7, speaker).await;
touch_member(&channels, 7, listener.local_addr().unwrap()).await;
push_packet(&channels, 7, speaker, 1, 1000, b"departed", 0).await;
remove_member_from_all(&channels, &speaker).await;
pop_and_relay(&relay, &channels, 100).await;
let mut buffer = [0; 32];
assert!(
tokio::time::timeout(Duration::from_millis(100), listener.recv_from(&mut buffer))
.await
.is_err(),
"departed speaker must not be relayed"
);
}
#[test] #[test]
fn voice_header_parse_valid() { fn voice_header_parse_valid() {
let mut buf = vec![0u8; crate::VOICE_HDR_SIZE]; let mut buf = vec![0u8; crate::VOICE_HDR_SIZE];