SHA256
Добавить лицензию CC0 1.0
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# HTTP API зашифрованных файлов личных сообщений
|
||||
|
||||
> **Текущий протокол DM v3 (2026-11):** новые вложения отправляются напрямую в R2 `shine-dm` после `POST /api/dm-files/prepare`; скачиваются по `https://dm-files.shineup.me/<Base58(SHA-256(ciphertext))>`. Большие файлы шифруются по 8 МиБ AES-256-GCM, список объектов находится в зашифрованном манифесте; BitTorrent v2 используется только в старых DM v2. Ниже разделы `PUT /dm-files/{fileId}` и `GET /dm-files/{fileId}` описывают **legacy** локальный сервер для v1/v2, а не новый R2. Полный текущий контракт см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
|
||||
> **Текущий протокол DM v3 (2026-11):** новые вложения отправляются напрямую в R2 `shine-dm` после `POST /api/dm-files/prepare`; скачиваются по `https://dm-files.<домен access-сервера отправителя>/<Base58(SHA-256(ciphertext))>`. Большие файлы шифруются по 8 МиБ AES-256-GCM, список объектов находится в зашифрованном манифесте; BitTorrent v2 используется только в старых DM v2. Ниже разделы `PUT /dm-files/{fileId}` и `GET /dm-files/{fileId}` описывают **legacy** локальный сервер для v1/v2, а не новый R2. Полный текущий контракт см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
|
||||
|
||||
> **Статистика v42:** сервер при успешной выдаче presigned URL или обнаружении уже существующего шифротекста добавляет запись в `dm_file_uploads` (`user_login`, `file_hash`, `file_size_bytes`, `requested_at`, `disposition`). Каждая зашифрованная часть/манифест — отдельный объект, имена и MIME исходного файла не сохраняются. **Запись не доказывает успешный PUT.** Шифрование, DM-протокол и клиент не изменяются.
|
||||
|
||||
@@ -16,7 +16,7 @@ HTTP API не получает исходное имя файла, MIME-тип
|
||||
3. считает `SHA-256(ciphertext)`;
|
||||
4. переводит 32-byte hash в Base58 — это `fileId` и имя файла на диске сервера;
|
||||
5. для нового v3 загружает ciphertext напрямую в R2 (ниже описан legacy v1/v2);
|
||||
6. помещает URL, key, IV, исходное имя/MIME/размер в `<S:file...>` внутри plaintext DM;
|
||||
6. помещает ID ciphertext, key, IV, исходное имя/MIME/размер в `<S:file...>` (новый v3 без URL) внутри plaintext DM;
|
||||
7. обычный механизм E2EE DM шифрует эту техническую вставку отдельно для отправителя и получателя.
|
||||
|
||||
Следствие: сервер файлов не знает AES-key и не может расшифровать вложение.
|
||||
@@ -121,6 +121,31 @@ Caddy/Nginx должен проксировать `/dm-files/*` в тот же J
|
||||
|
||||
Новые зашифрованные вложения загружаются браузером прямо в R2. Клиент посылает JSON `{ "fileId": "Base58_SHA256(ciphertext)", "size": 12345 }` и подписанные заголовки `X-Shine-Session-Id`, `X-Shine-Time-Ms`, `X-Shine-Signature`. Строка Ed25519-подписи: `DM_R2_PREPARE_V1:{sessionId}:{fileId}:{size}:{timeMs}`. Сервер подтверждает существование объекта или выдаёт `uploadUrl` и `requiredHeaders` с условием `If-None-Match: *`.
|
||||
|
||||
Максимальный размер одного ciphertext-объекта — 8 МиБ + 16 байт. Подписанный PUT действителен 30 минут. Загрузка не идёт через Java. Новый URL скачивания: `https://dm-files.shineup.me/<fileId>`; GET публичный, но объект содержит только AES-GCM ciphertext. R2 объект содержит `Content-Type: application/octet-stream`; исходный MIME хранится внутри зашифрованного `<S:file;v=3...>`.
|
||||
Максимальный размер одного ciphertext-объекта — 8 МиБ + 16 байт. Подписанный PUT действителен 30 минут. Загрузка не идёт через Java. Новый URL скачивания: `https://dm-files.<домен access-сервера отправителя>/<fileId>`; GET публичный, но объект содержит только AES-GCM ciphertext. R2 объект содержит `Content-Type: application/octet-stream`; исходный MIME хранится внутри зашифрованного `<S:file;v=3...>`.
|
||||
|
||||
Доступ к R2 требует настроек `r2.dmBucket=shine-dm` и серверных `R2_ENDPOINT`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`. Рекомендуется lifecycle rule **14 дней**. Кэш CDN допускается и может продлить доступность ciphertext после удаления из R2. Сервер не гарантирует соответствие загруженных байтов hash: читающий клиент проверяет `Base58(SHA-256(ciphertext))`. Полный формат DM v3 описан в `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
|
||||
|
||||
## 10. Федеративное R2-хранилище (16.11.2026)
|
||||
|
||||
У каждого access-сервера свои две корзины R2. Новый DM v3 не сохраняет полный URL в
|
||||
технической вставке `<S:file>`: передаются `id` (Base58 SHA-256 ciphertext),
|
||||
ключи/IV и необходимые метаданные, а также новое поле `at` — время завершения
|
||||
загрузки в миллисекундах Unix. Имя файлового домена вычисляется по отправителю:
|
||||
`dm-files.<DNS-имя access-сервера>`. Клиент узнаёт адрес через общий `GET
|
||||
/api/files/user-server?login=<senderLogin>` на своём access-сервере (из
|
||||
синхронизированной PostgreSQL-проекции Solana). В RAM кэшируется соответствие
|
||||
логин → сервер; при ошибке файла допускается один повторный поиск в час на
|
||||
пользователя. Для DM v3 с ранее сохранённым `url` этот URL по-прежнему читается.
|
||||
Формат бинарного E2EE-контейнера не меняется.
|
||||
|
||||
Сервер-владелец R2 получает DNS-адрес из собственной server-PDA в синхронизированной
|
||||
PostgreSQL по `server.SHiNE.login`. `POST /api/dm-files/prepare` автоматически возвращает
|
||||
`fileUrl` в формате `https://dm-files.<домен>/<id>` для проверки конфликтов при PUT.
|
||||
Отдельный R2 public URL в конфигурации не нужен. Публичный адрес файла
|
||||
должен поддерживать CORS GET/HEAD, а корзина R2 — прямой браузерный доступ.
|
||||
|
||||
Для **новых R2 DM v3** после 14 дней от `at` клиент не делает скачивание и
|
||||
показывает сообщение об истечении срока. Для ранних v3 без `at` используется
|
||||
время сообщения. Это UX-гарантия клиента, а не физическое удаление: Cloudflare
|
||||
R2 lifecycle необходимо настроить отдельно. Старые локальные DM v1/v2 не
|
||||
помечаются истёкшими, поскольку для них не настроен R2 lifecycle.
|
||||
|
||||
Reference in New Issue
Block a user