fix: harden channel access and refresh server dependencies
This commit is contained in:
parent
84df32a9de
commit
b14f036bdb
23 changed files with 1242 additions and 720 deletions
1109
Cargo.lock
generated
1109
Cargo.lock
generated
File diff suppressed because it is too large
Load diff
15
Cargo.toml
15
Cargo.toml
|
|
@ -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"
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@
|
||||||
**Not Discord. Not TeamSpeak. Not someone else's cloud.**
|
**Not Discord. Not TeamSpeak. Not someone else's cloud.**
|
||||||
|
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](https://www.rust-lang.org/)
|
[](https://www.rust-lang.org/)
|
||||||
[](docs/00-status.md)
|
[](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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
56
docs/design/accounts-and-avatars.md
Normal file
56
docs/design/accounts-and-avatars.md
Normal 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; центр не обещает автоматически проксировать голос.
|
||||||
99
docs/design/plugins-and-marketplace.md
Normal file
99
docs/design/plugins-and-marketplace.md
Normal 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
|
||||||
179
docs/design/server-architecture.md
Normal file
179
docs/design/server-architecture.md
Normal 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).
|
||||||
50
docs/design/server-dependency-audit.md
Normal file
50
docs/design/server-dependency-audit.md
Normal 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.
|
||||||
|
|
@ -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"
|
||||||
|
|
|
||||||
|
|
@ -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());
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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);
|
||||||
|
|
|
||||||
|
|
@ -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(())
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -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}");
|
||||||
|
|
|
||||||
|
|
@ -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;
|
||||||
|
|
|
||||||
145
gateway/src/handler/channel/join/tests.rs
Normal file
145
gateway/src/handler/channel/join/tests.rs
Normal 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")
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
@ -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?;
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -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))
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -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());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
|
||||||
|
|
@ -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);
|
||||||
|
|
|
||||||
|
|
@ -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
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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];
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue