SHA256
Добавить лицензию CC0 1.0
This commit is contained in:
@@ -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 не изменяются.
|
||||
|
||||
@@ -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 не происходит.
|
||||
|
||||
Reference in New Issue
Block a user