SHA256
Добавить лицензию CC0 1.0
This commit is contained in:
@@ -511,21 +511,19 @@
|
||||
"op": "ClientErrorLog",
|
||||
"requestId": "err-001",
|
||||
"payload": {
|
||||
"errorId": "ERR-A7F29C1201CD",
|
||||
"clientVersion": "20261116-client-error-reporting-v1",
|
||||
"kind": "global_error",
|
||||
"message": "TypeError: client exception",
|
||||
"message": "TypeError: failed",
|
||||
"stack": "...",
|
||||
"sourceUrl": "https://shineup.me/app.js",
|
||||
"lineNumber": 10,
|
||||
"columnNumber": 20,
|
||||
"route": "/channels",
|
||||
"href": "https://shineup.me",
|
||||
"route": "#/channel-view/own-0",
|
||||
"href": "https://shineup.me/#/channel-view/own-0",
|
||||
"userAgent": "...",
|
||||
"clientTs": 1774700000123,
|
||||
"requestOp": "GetChannelMessages",
|
||||
"requestIdRef": "GetChannelMessages-123",
|
||||
"contextJson": "{\"pageVisibility\":\"visible\",\"pageId\":\"channels\"}"
|
||||
"contextJson": "{\"screen\":\"channels\"}"
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -547,19 +545,7 @@
|
||||
|
||||
### Специфические коды ошибок `ClientErrorLog`
|
||||
|
||||
- `400 / BAD_FIELDS` — нет `message` или превышены ограничения размеров полей.
|
||||
- `200` + `payload.accepted=false` — отчёт **не записан** из-за ограничений частоты; повторов и очереди нет.
|
||||
|
||||
### Диагностика SHiNE UI v1 (16.11.2026)
|
||||
|
||||
- Критические JS-ошибки и неожиданные ответы WS API (статус `500–599`, кроме `507`) отправляются **автоматически**, без переключателя в инструментах разработчика; обычные `4xx` не считаются багом.
|
||||
- Транспорт: только текущий WebSocket `ClientErrorLog`, без отдельного HTTP и без локальной очереди. При отсутствии соединения отчёт не отправляется; клиент не утверждает обратное.
|
||||
- Серверный журнал: `logs/client-errors.log` (Logback `client.frontend`, без дублирования в `app.log`); ежедневная/размерная ротация, история 14 дней, до 150 MB суммарно. Диагностика звонков `CallDeliveryReport` остаётся в своём журнале.
|
||||
- Поля `errorId` и `clientVersion` необязательные для внешних клиентов; `errorId` связывает уведомление пользователя с записью в журнале.
|
||||
- Для необработанных ошибок/сбоев UI клиент передаёт тип исключения и кадры стека, но **не произвольный текст исключения**, который может содержать данные переписки. Клиент отбрасывает произвольный `context`, оставляя только технические поля: `pageId`, `reasonType`, `pageProtocol`, `timeoutMs`, `code`, `status`, `pendingOps`. URL передаются без query/hash, приватные ключи, содержимое сообщений, пароли и токены не должны включаться. Сервер дополнительно очищает и ограничивает строки; **не следует отправлять конфиденциальные данные даже при ручном вызове API**.
|
||||
- Сервер ограничивает частоту: до 60 отчётов с одного IP и 1200 всего за 60 секунд; длины полей ограничены, число источников ограничено. IP используется временно для ограничения частоты и не записывается в отдельный журнал.
|
||||
- Уведомление «отчёт принят» показывается только при `status=200` и `accepted=true`. Это означает, что сервер принял отчёт на обработку, но не является долговременной гарантией записи на диск.
|
||||
- Отправка диагностики не инициирует повтор исходной операции, в том числе блокчейн-платежа или доната.
|
||||
- `400 / BAD_FIELDS` — обязательные поля ошибки не заполнены.
|
||||
|
||||
---
|
||||
|
||||
@@ -644,3 +630,21 @@
|
||||
- `SendSignal` нужен для доверенных межсессионных сигналов одного пользователя, включая `remote AddBlock via homeserver session`.
|
||||
- `GetCallIceConfig` нужен для WebRTC-звонков и требует авторизации.
|
||||
- `ClientErrorLog`, `ClientDebugLog`, `CallDeliveryReport` используются для диагностики клиента и звонков.
|
||||
|
||||
## GET `/api/files/user-server?login=<user@namespace>` (16.11.2026)
|
||||
|
||||
Публичный, read-only resolver файлового сервера пользователя. Работает на
|
||||
access-сервере просмотрщика, без сессии; читает локальную синхронизированную
|
||||
PostgreSQL-проекцию Solana через `UserAccessServersCurrentDAO.findPrimaryByUserLogin()`.
|
||||
Отдельный Solana RPC на каждый просмотр вложения не выполняется.
|
||||
|
||||
Пример ответа 200:
|
||||
```json
|
||||
{"serverLogin":"node2@shine","serverUrl":"node2.example.net"}
|
||||
```
|
||||
404 — пользователь/маршрут не найдены; 400 — некорректный логин;
|
||||
503 — база/справочник недоступны. Все ответы `Cache-Control: no-store`,
|
||||
`Access-Control-Allow-Origin: *`; клиент хранит маршрут только в RAM.
|
||||
DNS-имя `serverUrl` используется для построения
|
||||
`https://files.<hostname>/<PR>` и `https://dm-files.<hostname>/<FileID>`.
|
||||
Для нового типа R2 нет дополнительных полей в блокчейне.
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
Новые публичные файлы и аватары используют **BitTorrent v2 Pieces Root**, закодированный **Base58** (32 байта; строка обычно 43–44 символа). Идентификатор не зависит от имени и MIME. Клиент вычисляет корень по подготовленным байтам. Содержимое файла **не проходит через Java**.
|
||||
|
||||
- R2 bucket: `shine-files`.
|
||||
- Публичный GET: `https://files.shineup.me/<PR>` (ключ объекта = `PR`, без расширения).
|
||||
- Публичный GET: `https://files.<домен access-сервера автора>/<PR>` (ключ объекта = `PR`, без расширения).
|
||||
- Предпросмотр публичных изображений и видео использует прямой URL. Картинки `loading="lazy"`; публичные видео получают `src` только у видимой области через `IntersectionObserver` и запрашивают метаданные после входа в область. В старом браузере используется обычная загрузка metadata.
|
||||
- Отдельных preview-файлов нет. Скачивание/просмотр медиаконтента выполняет сам браузер (в том числе HTTP Range, если доступен).
|
||||
- Тип определяется по `mm`, затем по расширению `nm`; HTTP `Content-Type` объекта задаётся при PUT. Неизвестные файлы — `application/octet-stream`.
|
||||
|
||||
@@ -35,3 +35,23 @@ flowchart LR
|
||||
## Ограничения этой карты
|
||||
|
||||
Схема показывает связи компонентов, но не обещает доступность каждой функции на каждом контуре. Документы с названиями `TODO`, `Черновик`, `PROPOSED` и исторические отчёты не описывают действующий контракт. Если карта расходится с профильной спецификацией или кодом, расхождение нужно проверить и исправить по [правилам сопровождения](CONTRIBUTING_DOCS.md).
|
||||
|
||||
## Федеративные публичные и DM-файлы (16.11.2026)
|
||||
|
||||
- Публичные PR/Base58-файлы и аватарки ищутся на
|
||||
`https://files.<access-домен автора>/<PiecesRoot>`; в публикации нет
|
||||
дополнительного поля домена. Arweave и legacy `/files/<sha256>` не меняются.
|
||||
- Новый DM v3 по отправителю определяется на `dm-files.<access-домен>`, а
|
||||
в технической вставке сохраняется идентификатор, но не URL. Исторические DM
|
||||
v3 с URL читаются. Про шифрование и срок хранения см.
|
||||
`docs/Personal_Messages/Файлы_DM_v3_R2.md`.
|
||||
- Access-домен клиента определяется через `GET /api/files/user-server?login=`.
|
||||
Java использует `UserAccessServersCurrentDAO.findPrimaryByUserLogin()`:
|
||||
синхронизированную PostgreSQL-проекцию Solana. Платный аккаунт — первый
|
||||
access server пользовательской PDA, FREE_CERT — namespace default server.
|
||||
Ответ `{serverLogin, serverUrl}`; клиент формирует домены сам.
|
||||
- Client-cache исключительно в RAM, без TTL/IndexedDB. Одновременные обращения
|
||||
объединяются; после ошибки файла повторный lookup не чаще раза в час на автора.
|
||||
Успешная загрузка не запускает periodic validation.
|
||||
- Смена access-сервера **не переносит** старые объекты R2: миграция файлов
|
||||
должна быть выполнена отдельно до обновления маршрута пользователя.
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# TECH блоки (`type=0`, `version=1`)
|
||||
# TECH блоки (`type=0`; версия 1, а для HEADER также 2)
|
||||
|
||||
TECH-тип покрывает системные записи пользовательской цепочки. Все TECH DataItem имеют подписанный индексный тег:
|
||||
|
||||
@@ -12,7 +12,30 @@ t=tech
|
||||
|
||||
### `subType=0` — `HEADER_COMPAT`
|
||||
|
||||
Стартовый блок цепочки (`block #0`). Payload содержит tag `SHiNE`, login владельца и `initialBlockchainKey32`.
|
||||
Стартовый блок цепочки (`block #0`). Новый клиент создаёт `HEADER v2`, а старые `HEADER v1` продолжают читаться.
|
||||
|
||||
Формат `HEADER v1`:
|
||||
|
||||
```text
|
||||
[5] ASCII "SHiNE"
|
||||
[1] loginLength (uint8)
|
||||
[N] login UTF-8
|
||||
[32] initialBlockchainKey32
|
||||
```
|
||||
|
||||
Формат `HEADER v2`, строго в указанном порядке:
|
||||
|
||||
```text
|
||||
[5] ASCII "SHiNE"
|
||||
[1] loginLength (uint8)
|
||||
[N] login UTF-8
|
||||
[15] ASCII "license:CC0-1.0"
|
||||
[32] initialBlockchainKey32
|
||||
```
|
||||
|
||||
В `v2` строка `license:CC0-1.0` записывается **буквально**, без отдельного поля длины, и должна полностью совпадать. Наличие префикса `license:` обязательно. Запись является частью подписанного блока. Любые другие строки лицензии и дополнительные байты запрещены.
|
||||
|
||||
`HEADER v1` остаётся исторически допустимым и не означает автоматически принятую CC0. Существующие блоки #0 не переписываются. Все новые цепочки создаются с `HEADER v2`.
|
||||
|
||||
Поле `login` хранит **точное неизменяемое написание идентичности при регистрации**: для новой регистрации `login@namespace` соответствует `[A-Za-z0-9_]+@[a-z0-9_]+`, длина не более 30 байт. Регистр локальной части сохраняется побайтно из Solana PDA или сертификата Arweave; `@namespace` остаётся строчным. `AlexSmith@shine` и `alexsmith@shine` идентифицируют одного человека (по lower-case), но только первый вариант допустим в его HEADER, если именно так он зарегистрирован. `@` не меняет бинарную структуру HEADER: `[loginLength:uint8][login UTF-8 bytes]`. При копировании префикса для следующих fork первый HEADER не меняется. Исторические legacy `[A-Za-z0-9_]+` по-прежнему декодируются, но в новую регистрацию не допускаются.
|
||||
|
||||
@@ -22,7 +45,7 @@ AddBlock сверяет HEADER #0 с точным именем в `user_identity
|
||||
|
||||
HEADER сам не хранит line-prefix, но является root TECH-линии.
|
||||
|
||||
После успешной регистрации и автоматического входа клиент вызывает `ensureBlockchainHeader(login, storagePwd)` один раз в общем завершении регистрации (как Solana, так и Arweave). При отсутствии блока №0 клиент создаёт и подписывает HEADER и отправляет его через обычный `AddBlock`. Неудачная отправка **не отменяет** уже подтверждённую регистрацию: существующая логика создания первого пользовательского блока проверит и при необходимости создаст HEADER перед ним. Дополнительной проверки при каждом входе нет. Формат блоков и серверный API не изменены.
|
||||
После успешной регистрации и автоматического входа клиент вызывает `ensureBlockchainHeader(login, storagePwd)` один раз в общем завершении регистрации (как Solana, так и Arweave). При отсутствии блока №0 клиент создаёт и подписывает HEADER и отправляет его через обычный `AddBlock`. Неудачная отправка **не отменяет** уже подтверждённую регистрацию: существующая логика создания первого пользовательского блока проверит и при необходимости создаст HEADER перед ним. Дополнительной проверки при каждом входе нет. Схема `HEADER v2` расширена константой лицензии; сетевой API AddBlock не меняется.
|
||||
|
||||
### `subType=1` — `TECH_CREATE_CHANNEL`
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@
|
||||
- `ar` — необязательный Arweave Transaction ID, нативный формат Arweave.
|
||||
- `sha256` — исторический lowercase hex SHA-256 для старых тегов/объектов; новые записи его не создают.
|
||||
|
||||
`ar` присутствует → получить файл через Arweave gateway. Нет `ar`, есть `pr` → `https://files.shineup.me/<pr>`. Исторический `sha256` без `pr`/`ar` → прежний `/files/<sha256>` access-сервера автора. `storage=r2` и абсолютные URL в тег не записываются.
|
||||
`ar` присутствует → получить файл через Arweave gateway. Нет `ar`, есть `pr` → `https://files.<домен access-сервера автора>/<pr>`. Исторический `sha256` без `pr`/`ar` → прежний `/files/<sha256>` access-сервера автора. `storage=r2` и абсолютные URL в тег не записываются.
|
||||
|
||||
Идентификаторы новых аватаров — тоже **Base58(PR)**, но формат аватара отдельный: `<S:ava;v=2;sz=N;pr=ROOT[;ar=TXID]>`. Формат v1/SHA-256 аватаров больше не создаётся; миграция v41 не конвертирует старые значения.
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Публичные идентификаторы содержимого SHiNE (15.11.2026)
|
||||
|
||||
- **Публичные вложения и новые аватарки:** 32-байтный BitTorrent v2 Pieces Root, текстовая форма — канонический Bitcoin Base58. Это не обычный SHA-256 файла для файлов больше 16 КиБ. Блоки/корень считаются по правилам BitTorrent v2. Base58 чувствителен к регистру: запрещено `.toLowerCase()`.
|
||||
- **Хранилище:** все публичные объекты, включая аватарки, в корне одной R2 корзины `shine-files`: ключ `<PR>`, URL `https://files.shineup.me/<PR>`. Папок `avatars/` нет. Прямая загрузка браузером через `POST /api/files/prepare` + presigned PUT. Подготовка аватара: WebP/JPEG, максимум 768 px, затем вычисление PR от фактически загружаемых байтов.
|
||||
- **Хранилище:** все публичные объекты, включая аватарки, в корне R2 корзины `shine-files` на access-сервере автора: ключ `<PR>`, URL `https://files.<домен access-сервера автора>/<PR>`. Папок `avatars/` нет. Прямая загрузка браузером через `POST /api/files/prepare` + presigned PUT. Подготовка аватара: WebP/JPEG, максимум 768 px, затем вычисление PR от фактически загружаемых байтов.
|
||||
- **User profile avatar:** `<S:ava;v=2;sz=12345;pr=<Base58>>`; **channel avatar:** тот же тег в метаданных. В случае Arweave добавляется `;ar=<original Arweave TX ID>`. Arweave TX ID не перекодируется (остается Base64URL).
|
||||
- **Старый аватар SHA-256/hex (`v=1`) не поддерживается** и не переносится. Старые аватары перестанут отображаться без повторной загрузки/перепубликации профиля. Старые каналы не удаляются: старый тег аватара при перестроении индекса пропускается.
|
||||
- **DM:** зашифрованные объекты — SHA-256/Base58 в своей корзине. Никаких изменений в этом патче.
|
||||
|
||||
@@ -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