Entrixy — сквозное шифрование

• Конфиденциальность содержимого. Сервер не знает ни адреса шлагбаума, ни номера телефона, ни адреса webhook, ни координат, ни BSSID сети Wi-Fi, ни текста приветствия.
• Проверяемая целостность. Любая правка блоба на сервере ломает расшифровку (AES-GCM), и клиент сообщает о повреждённых данных.
• Совместимость ключей на будущее. Гость получает доступ только к тем объектам, которые ему выданы. Компрометация одного гостевого ключа ничего не говорит об остальных.
• Предел нулевого знания. Сервер всё же видит сам факт ключа, отметки времени активности и идентификаторы объектов — они нужны ему для маршрутизации. Сокрытие метаданных (луковые схемы) в задачу не входит.

Algorithm: AES-256-GCM. Доступен в JVM из коробки (через javax.crypto), и поддержан Android Keystore. Даёт сразу и конфиденциальность, и аутентификацию.

Формат шифротекста

v1:<base64url(nonce || ciphertext || tag)>

• v1: — префикс версии, чтобы потом менять формат.
• nonce — 12 случайных байтов, новые на каждое шифрование.
• ciphertext+tag — всё, что вернул Cipher.doFinal; 128-битный тег включён.
• base64url без дополнения — безопасен и в адресе, и в JSON.

Источник энтропии

K_master — мастер-ключ владельца

• 32 случайных байта, создаются при первом запуске.
• Хранится в EncryptedSharedPreferences под именем master_key и никогда не покидает устройство в открытом виде.
• Используется только для обёртывания K_obj для локального хранения.

K_obj — ключ объекта

• 32 случайных байта, создаются при создании каждого объекта.
• Хранится локально как encrypt_k_master(K_obj) под ключом obj_key_{id}.
• Шифрует JSON со всеми чувствительными полями объекта (data_cipher на сервере).
• Ротация — это новый K_obj_new → перешифровать data_cipher и все бандлы, где он был.

K_guest — ключ гостевого бандла

• 32 случайных байта, создаются при выдаче гостевого ключа.
• Шифрует bundle — небольшой JSON {obj_id: K_obj} по объектам, разрешённым гостю.
• На сервер попадает only bundle_cipher. Чип K_guest сервер не видит никогда.
• K_guest приходит гостю во фрагменте адреса: entrixy.com/key#<user_key><base64url(K_guest)> — единый блок из 75 символов. Фрагмент не уходит на сервер вместе с HTTP-запросом — это базовая гарантия браузера.

На устройстве владельца (EncryptedSharedPreferences)

На сервере

https://entrixy.com/key#<user_key(32)><K_guest_base64url(43)>

• Фрагмент — один блок из 75 символов: 32 символа user_key и 43 символа гостевого ключа.
• user_key — идентификатор на стороне сервера. Без него сервер бандл не отдаст.
• Фрагмент (#...) никогда не попадает в лог сервера — это гарантия браузера.
• Страница /key — обычный JS: читает location.hash, разбирает блок и передаёт ключ либо приложению, либо веб-версии /app/. Сервер ключа не видит никогда.
• Если приложение не установлено, страница копирует ссылку в буфер обмена и отправляет на /download/android, откуда приложение подхватывает ключ само.

Создание объекта

1. Владелец нажимает Добавить — создаётся K_obj.
2. Поля упаковываются в JSON и шифруются K_obj → data_cipher.
3. POST /api/number_add с data_cipher плюс тип. Сервер возвращает id.
4. Локально сохраняется: obj_key_{id} = encrypt_k_master(K_obj).

Обновление объекта

Собрать новый JSON локально, зашифровать существующим K_obj → POST /api/number_update. K_obj не меняется.

Создание гостевого ключа

1. Владелец выбрал [obj1, obj2, obj3]. Создаётся K_guest.
2. Собирается JSON бандла: {obj_ids: [...], obj_keys: {1: K_obj1, ...}, welcome_cipher: ...}.
3. Шифруется K_guest → bundle_cipher.
4. POST /api/key_create с bundle_cipher, obj_ids (в открытом виде — для матрицы доступа).
5. Сервер возвращает user_key.
6. Владельцу показывается QR-код со ссылкой entrixy.com/key#{user_key}{base64url(K_guest)}.

Приём ключа гостем

1. Гость открывает QR-код или ссылку. Страница /key reads location.hash и передаёт ключ приложению или веб-версии.
2. Клиент запрашивает POST /api/key_bundle.php с user_key → получает bundle_cipher и список obj_ids.
3. Расшифровывает бандл ключом K_guest→ получая {obj_keys, welcome}.
4. K_guest и расшифрованные obj_keys складываются в EncryptedSharedPreferences гостевого клиента.
5. Дальше при каждом обращении: GET зашифрованного data_cipher объекта → расшифровка локальным obj_key_{id}.

Отзыв гостевого ключа

Владелец нажимает Удалить → POST /api/key_revoke.php → сервер удаляет запись ключа. При следующем запросе бандла гость получает отказ и теряет доступ.

Ротация ключа объекта

Владелец нажимает Перевыпустить ключ в настройках объекта. Создаётся K_obj_new, и перешифровываются все bundle_cipher, где есть этот объект. Клиент их наизусть не знает, поэтому клиент владельца пересобирает бандлы: забирает bundle_cipher каждого своего ключа, расшифровывает, подставляет K_obj_newи шифрует заново. Новые блобы уходят на сервер одной пачкой.

Losing K_master означает потерю доступа ко всем объектам и ключам — потому экспорт и необходим.

• Владелец задаёт passphrase (не короче 8 символов).
• KDF: Argon2id (64 МБ памяти, 3 итерации, 1 поток) → выведенный ключ на 32 байта.
• Выведенный ключ шифрует K_master → получается master_backup_blob.
• Блоб показывается как QR-код и сохраняется в Загрузки. Его можно распечатать и запереть в сейф.
• Восстановление на новом устройстве: отсканировать QR-код, ввести парольную фразу, K_master восстанавливается, и клиент заранее скачивает все obj_keys с сервера — они лежат в бандле собственных ключей владельца — и перешифровывает их локально.