Добавить лицензию CC0 1.0

This commit is contained in:
AidarKC
2026-11-16 23:50:28 +03:00
parent 548160f7f8
commit c477560632
39 changed files with 901 additions and 138 deletions
+12 -3
View File
@@ -26,8 +26,8 @@
Официальный UI v3 отправляет файл как зашифрованные объекты R2 (чтение старого v1/v2 поддерживается):
- файл шифруется в браузере `AES-256-GCM`;
- новый ciphertext хранится в корзине `shine-dm` по адресу `https://dm-files.shineup.me/<Base58(SHA-256(ciphertext))>`;
- AES-key, IV, исходное имя, MIME, размер и URL находятся в `<S:file...>` внутри plaintext DM, а значит сами защищены существующим E2EE DM;
- новый ciphertext хранится в корзине `shine-dm` по адресу `https://dm-files.<домен access-сервера отправителя>/<Base58(SHA-256(ciphertext))>`;
- AES-key, IV, ID ciphertext, исходное имя, MIME и размер находятся в `<S:file...>` (новые v3 без URL; старые URL читаются) внутри plaintext DM, а значит сами защищены существующим E2EE DM;
- получатель скачивает новый ciphertext напрямую из R2, проверяет SHA-256, расшифровывает локально и только затем отдаёт Blob браузеру для сохранения под исходным именем;
- сервер файлов ключ расшифрования не получает.
@@ -47,4 +47,13 @@
Сообщение создаётся локально при отрисовке диалога и повторно добавляется при обновлении истории. Это **не DM-сообщение**, оно не отправляется собеседнику, не попадает в `GetDirectMessages`, не подписывается и не записывается в Arweave или блокчейн. Кнопок, галочек и обязательного подтверждения нет. Изменения не затрагивают бинарный формат `SHiNE_DM`, серверный API и криптографический протокол.
Текст уведомления RU восстановлен по утверждённой пользователем редакции от 13.11.2026: «Ваша переписка защищена сквозным шифрованием»; остальной текст RU/EN находится только в `shine-UI/js/i18n/locales/{ru,en}.json`. Для предотвращения повторной подмены RU-редакция зафиксирована тестом `shine-UI/tests/dm-security-notice.test.mjs`. Текст о перешифровке в интерфейсе воспроизводит утверждённую пользователем формулировку. Техническое ограничение: текущий протокол при ротации client key перешифровывает локальные копии `type=1/2` на access-сервере владельца, а не гарантирует перешифровку всех когда-либо созданных копий сообщения (подробности — в `Протокол_DM_v1.md`). Перед публичным релизом желательно уточнить формулировку на уровне продукта.
Текст о перешифровке в интерфейсе воспроизводит утверждённую пользователем формулировку. Техническое ограничение: текущий протокол при ротации client key перешифровывает локальные копии `type=1/2` на access-сервере владельца, а не гарантирует перешифровку всех когда-либо созданных копий сообщения (подробности — в `Протокол_DM_v1.md`). Перед публичным релизом желательно уточнить формулировку на уровне продукта.
### Федеративный файловый resolver (16.11.2026)
Новые вложения DM v3 не сохраняют полный URL в E2EE-технической вставке; адрес
`dm-files.<access-домен>` восстанавливается по отправителю через общий HTTP API
и RAM-кэш. У каждого access-сервера своя корзина R2. Время загрузки `at` позволяет
показывать окончание 14-дневного срока без скачивания; старые v1/v2 сохраняют
прежний протокол и правила хранения. Подробнее в `Файлы_DM_v3_R2.md` и
`docs/API/18_DM_File_Storage_API.md`.
@@ -206,3 +206,12 @@ fromLogin|toLogin|timeMs|nonce
```
Здесь **нет** `th` или `pr`; `id` обозначает SHA-256 **зашифрованного корневого манифеста** в Base58. Все части и манифест шифруются AES-256-GCM, хранятся по `Base58(SHA-256(ciphertext))`. Встроенный MIME по-прежнему называется `mime` в DM-протоколе (сокращение `mm` касается публичного `S:att`). Бинарный E2EE-контейнер не меняется. Подробности: `Файлы_DM_v3_R2.md`.
## Дополнение: DM file v3 без URL (16.11.2026)
В новых отправлениях `<S:file;v=3>` отсутствует поле `url`, а присутствует `at`
(Unix milliseconds, время загрузки). Получатель определяет R2-домен по
**логину отправителя сообщения** через `/api/files/user-server?login=...`.
Поле `url` у исторических DM v3 допустимо и обрабатывается по прежней логике.
Для v1/v2 `url` по-прежнему обязателен; криптографические поля и бинарный
контейнер DM не изменяются.
+22 -3
View File
@@ -4,7 +4,7 @@
Все **новые** файлы и голосовые сообщения DM официального PWA загружаются непосредственно в R2 `shine-dm`.
Содержимое файлов Java-сервером не проксируется, а сервер выдаёт временные S3 PUT URL после проверки Ed25519-сессии.
Скачивание публичное по `https://dm-files.shineup.me/<id>`: там хранится **только ciphertext**.
Скачивание публичное по `https://dm-files.<домен access-сервера отправителя>/<id>`: там хранится **только ciphertext**.
Ключ AES, префикс IV, имя, MIME и размер помещаются внутрь уже E2EE-зашифрованного сообщения.
В v3 **нет BitTorrent, Merkle/`pieces root` и infohash**. Они сохранились только для чтения ранее отправленных DM v2.
@@ -67,13 +67,13 @@ DM_R2_PREPARE_V1:{sessionId}:{fileId}:{size}:{timeMs}
1. Скачать ciphertext root manifest по адресу, записанному в E2EE-сообщении.
2. Проверить `Base58(SHA-256(ciphertext)) == id`.
3. Расшифровать AES-GCM и проверить структуру манифеста.
4. Получить каждую зашифрованную часть напрямую с `dm-files.shineup.me/<id>`.
4. Получить каждую зашифрованную часть напрямую с `dm-files.<домен access-сервера отправителя>/<id>`.
5. Проверить SHA-256 каждой части, расшифровать AES-GCM, проверить порядок и длину.
6. Последовательно записать исходные данные в браузерный поток сохранения или Blob fallback.
## Настройка Cloudflare
- R2 Bucket: `shine-dm`, публичный custom domain `dm-files.shineup.me` (в R2 только шифротекст).
- R2 Bucket: `shine-dm`, публичный custom domain `dm-files.<домен access-сервера>` (в R2 только шифротекст).
- Object Lifecycle: удалить объекты через 14 дней (Cloudflare выполняет удаление асинхронно).
- CDN-кэширование разрешено: файлы могут оставаться доступными из кэша после удаления из R2, гарантий точного срока недоступности нет.
- CORS: с origin сайта SHiNE разрешить `GET`, `HEAD`, `PUT`; `AllowedHeaders: ["*"]`; `ExposeHeaders: ["Content-Length", "ETag"]`.
@@ -96,3 +96,22 @@ DM v1 и DM v2 читаются прежними обработчиками (с
## Журнал выдачи R2 разрешений (PostgreSQL v42)
Сервер записывает в `dm_file_uploads` одну строку **на каждый зашифрованный объект**, для которого был выдан URL, либо обнаружено существование объекта. Поля: `user_login`, `file_hash` (Base58 SHA-256 ciphertext), `file_size_bytes`, `requested_at`, `disposition`. Это *не* подтверждение успешной передачи в R2 и *не* одна строка на исходный файл: один DM может содержать много частей и манифест. Ни исходное имя, ни MIME, ни AES-ключ не попадают в журнал. Криптография и формат `S:file;v=3` не меняются.
## Обновление: отдельный R2 каждого access-сервера (16.11.2026)
- Новое `<S:file;v=3;id=...;key=...;ivp=...;...;at=...>` **не передаёт URL**:
клиент восстанавливает `https://dm-files.<access-server отправителя>/<id>` через
общий REST-resolver и RAM-кэш. Старая форма v3 с `url` принимается на чтение.
- `at` — время завершения загрузки манифеста (миллисекунды Unix); при его
отсутствии применяется timestamp сообщения. По истечении 14 дней UI
заменяет вложение пояснением, без обращения к R2 и resolver.
- По требованию пользователя нет клиентского сохранения сервера в IndexedDB,
повторных периодических проверок или миграции файлов. При загрузке ошибки
resolver обновляется не чаще одного раза в час на отправителя; в рамках
одновременных ошибок запросы объединяются.
- Старые DM v1/v2 не подпадают под новое правило 14 дней, т.к. их историческое
локальное хранение регулируется отдельным механизмом.
- Для каждого access-сервера оператор настраивает DNS/R2 CORS/lifecycle.
Java автоматически формирует URL по собственной server-PDA в PostgreSQL,
отдельное `r2.dmPublicBaseUrl` не требуется. Изменений
бинарного контейнера DM, AES-GCM и SHA-256 не происходит.