Коротко
- Криптоядро на Rust и протокольный слой на Kotlin открыты под лицензией Apache-2.0. Ядро на Rust в репозитории — тот самый код, из которого собираются приложения.
- Одна команда собирает ядро и запускает 114 тестов. Эталонные векторы закрепляют результат каждой формулы байт в байт.
- Каждое утверждение ниже ведёт к файлу, тесту или тому, что видно в вашем собственном трафике.
- Что мы пока не можем доказать и что пока не публикуем — в конце страницы.
Другие страницы рассказывают о том же с разной глубиной: «Доказательство» разбирает главные утверждения, «Защита» простыми словами описывает слои, а «Спецификация» даёт формулы. Эта страница показывает, где смотреть и что запускать.
Что открыто
Всё, что ниже, лежит в открытом репозитории UmberaAPP/UMBERA на GitHub, в ветке main.
На crates.io пакет umbera-core 1.1.0 (16 ноября 2026) совпадает с ядром на GitHub: группы X-Wing, ключи кадров звонка и привязка компьютера по QR-коду. API версии 1.0.0 не изменился.
Тот ли это код, что работает в приложениях? Мы сверили репозиторий со своим деревом сборки пофайлово: файлы ядра на Rust совпадают строка в строку, кроме переведённых комментариев и сообщений тестов. Совпадают и файлы механизмов 2.1 на Kotlin (SealV3, GroupPqSig, RendezvousV2, CallFrameE2ee, DoubleRatchet и другие). Проверить это на установленном приложении самостоятельно пока нельзя — см. «Чего мы не утверждаем».
Сборка и тесты
Нужен Rust 1.91 или новее (rustup.rs). Собирается и работает на Linux, macOS и Windows. На чистом клоне у нас получается результат ниже — у вас должен быть такой же.
У форматов Сообществ есть независимая эталонная реализация на Go (Go 1.27): она проверяет те же векторы, что и клиент на Kotlin.
У разборщиков, которые читают чужие данные, — Welcome и входящие сообщения MLS, привязка устройства, ключи звонка, жалобы, удаление метаданных из PDF — есть цели фаззинга:
Тесты на Kotlin (SealV3Test, PqRatchetTest, GroupPqSigTest, SafetyNumberV2Test, DesktopCallPqLoopbackTest и другие) опубликованы для чтения. Им нужны платформенные привязки нашей сборки приложения, поэтому из репозитория их можно читать, но не запускать.
Эталонные векторы
Эталонный вектор фиксирует точный результат формулы на заданных входных данных. Если реализация — наша или ваша — отличается хотя бы на один бит, тест падает. Самая сильная проверка — реализовать формулу по docs/PROTOCOL.md самому и сравнить с этими файлами.
Сообщения: конверт
Сообщение 1:1 сначала шифруется сессией Double Ratchet этой переписки, затем упаковывается вместе с данными отправителя и запечатывается получателю: новый одноразовый ключ X25519 и инкапсуляция ML-KEM-1024. Оба секрета идут в одну HKDF-SHA256, результат закрывается AES-256-GCM и дополняется до класса размера.
В 2.1 выработка ключа к тому же солится хешем транскрипта — одноразового ключа, шифртекста ML-KEM и обоих открытых ключей получателя, — поэтому ключ нельзя переиспользовать в другом контексте. Каждая часть хеша идёт со своей длиной, так что конец одной части не выдать за начало следующей:
Полный конверт несёт свежую капсулу ML-KEM. Между полными до 49 коротких берут ключи из секрета пары последнего подтверждённого полного конверта, сдвинутого по односторонней цепочке, поэтому капсула в 1,5 КБ не едет в каждом сообщении. В наших тестах полный конверт — 5038 байт, короткий — 3078, прежний формат — 21 682.
tests/proof.rs воспроизводит печать и проверяет каждое свойство напрямую. Главный тест — постквантовый: у атакующего есть ключ X25519 получателя, но нет ключа ML-KEM, и сообщение не открывается.
Код: kotlin/…/crypto/SealV3.kt и HybridKeyExchange.kt. Тесты: Rust sealv3::kat_matches_kotlin (Rust и Kotlin дают одни и те же байты), Kotlin SealV3Test. Старые приложения (2.0.x) остаются на прежнем конверте, который тоже сводит X25519 и ML-KEM-1024 в каждом сообщении.
Ящики: куда идёт конверт
У сервера нет полей «от кого» и «кому». Конверт уходит на адрес ящика, который могут вычислить только двое участников переписки, и этот адрес не связан ни с одним из аккаунтов.
Когда у вас обоих 2.1, адрес собирается из двух частей: секрета X25519 пары и секрета направления из гибридного конверта v3 — то есть из X25519 и ML-KEM-1024 вместе. Тот, кто потом взломает X25519, ваших адресов всё равно не вычислит.
К тому же адрес меняется каждую неделю. Граница — одна и та же секунда для всех, поэтому смена не выделяет отдельную переписку, а адреса разных недель нельзя связать друг с другом без секрета направления. Приложение слушает и соседние недели, так что на границе и пока устройство было не в сети ничего не теряется.
Честно о том, что по-прежнему видно:
- С собеседником на 2.0.x у пары остаётся прежний адрес, и он не меняется, пока вы оба не обновитесь.
- Сервер видит, в какие адреса пишут и из каких читают, когда, и класс размера каждого конверта.
- Без Tor приложение проверяет все свои ящики по одному соединению, поэтому сервер может понять, что несколько адресов принадлежат одному устройству, — но не чьё оно. С включённым Tor приложение разносит ящики по разным цепочкам Tor.
Код: kotlin/…/crypto/RendezvousV2.kt, devices/DeviceRidEpochs.kt (то же недельное расписание для адресов между вашими связанными устройствами). Тесты: Rust sealv3:: (векторы адресов), Kotlin SealV3Test.rendezvousV2Handshake, DeviceRidEpochTest.
Как меняются ключи
В переписке 1:1
Double Ratchet: у каждого сообщения свой ключ, использованный ключ удаляется. Свежий секрет ML-KEM-1024 подмешивается в корневой ключ в начале сессии и затем каждые 20 новых цепочек или каждые 24 часа, поэтому сессия восстанавливается после кражи ключей и против квантового противника. Код: DoubleRatchet.kt. Тест: PqRatchetTest, в том числе x25519_secrets_alone_do_not_open_a_pq_session.
В группах
Каждое изменение состава переводит группу MLS в новую эпоху с новыми ключами. Кроме того, каждое устройство само обновляет свой лист раз в 7 дней (±12 часов), после 100 своих пакетов или после долгого простоя — так группа восстанавливается, даже если никто не входит и не выходит. Код: GroupRekeyPolicy.kt. Тесты: pcs_rekey (9), MlsRekeyTest.
В звонках
Каждый звонок, каждый перевод на другое устройство и каждая пара в конференции получают новый обмен X25519 + ML-KEM-1024. От звонка к звонку ничего не переиспользуется.
Без незаметного отката
Новый формат уходит собеседнику только после того, как он объявил поддержку внутри сообщения со сквозным шифрованием. Объявленная возможность закрепляется: если она потом пропадёт, приложение покажет «ключ изменился», а не откатится молча. Тест: PeerCryptoCapsPinTest (15).
Код безопасности и смена ключа собеседника
Приложение запоминает ключи собеседника, когда видит их впервые. Если потом сервер отдаст другие ключи, приложение не примет их молча: в чате появится предупреждение безопасности, и вы сможете сверить личность собеседника, а затем принять новый ключ. Пока предупреждение на экране, сообщения и звонки продолжают работать — решение за вами.
Чтобы убедиться, что посередине никого нет, сверьте код безопасности с собеседником — лично или отсканировав QR-коды друг друга. Код одинаков у обоих. Версия 2 покрывает все четыре ключа личности — secp256k1, X25519, ML-DSA-65 и ML-KEM-1024, — и каждый ключ идёт со своей длиной, поэтому ключи нельзя сдвинуть друг относительно друга:
Версия 2 используется, когда вы оба объявили её внутри своих зашифрованных сообщений, — тогда на экране сверки написано «Версия 2». Если у собеседника старое приложение, это версия 1: она покрывает ключи secp256k1 и X25519.
Кроме того, открытые ключи записываются в журнал прозрачности, куда можно только дописывать. Приложение сверяет с ним ключи собеседника и показывает результат в карточке контакта и в «Журнале проверок». Каждая вершина журнала подписана двумя ключами — Ed25519 и ML-DSA-65. Отсутствие записи в журнале пока не вызывает предупреждения — решающая проверка здесь код безопасности.
Код: kotlin/…/crypto/SafetyNumber.kt, KeyTransparencyVerifier.kt. Тесты: SafetyNumberV2Test (6), SafetyNumberNegotiationTest (10).
Группы: доказательства для MLS
Группы работают на MLS (RFC 9420) через OpenMLS 0.9.2. Новые группы создаются на наборе X-Wing (X25519 + ML-KEM-768). Существующая группа сама переходит на X-Wing, как только его поддерживают все участники, — с тем же составом и историей. Группа, где ещё есть участник на 2.0.x, остаётся на прежнем наборе, и каждый групповой пакет к нему по-прежнему идёт внутри его гибридного конверта.
tests/proof_groups.rs проверяет утверждения о группах по одному: каждый участник читает сообщение, сервер видит только шифротекст, посторонний не читает — даже со своей группой под тем же идентификатором, — удалённый участник не читает новые сообщения, новый не читает старые, а обновление ключа переводит группу в новую эпоху.
Кто изменил группу: подписи участников MLS — Ed25519, как сегодня определяет стандарт. Поверх них каждый Commit, Proposal и Welcome несёт подпись ML-DSA-65, а обычные сообщения каждого отправителя складываются в хеш-цепочку, которую закрывает контрольная подпись ML-DSA-65 каждые 20 сообщений или после 30 секунд тишины. Если участник объявил такие подписи, неподписанное изменение от его имени отвергается.
Код: core/src/lib.rs, provider.rs; kotlin/…/crypto/GroupPqSig.kt. Тесты: Rust xwing_*, suites_do_not_mix, compat_v06, xwing_short_key; Kotlin GroupPqSigTest (29), MlsXwingRegroupTest. Цена: +4429 байт на подписанный Commit, в среднем около +275 байт на сообщение.
Звонки 1:1
У звонка два слоя шифрования. Первый — DTLS-SRTP из WebRTC: рукопожатие идёт прямо между двумя устройствами, а сервер-ретранслятор, если он нужен, пересылает пакеты, которые не может открыть. Ключ в DTLS согласуется классически, поэтому записанный сегодня разговор квантовый компьютер мог бы открыть потом.
Поэтому каждый кадр звука, видео и показа экрана шифруется второй раз. На каждый звонок устройства выполняют свежий обмен X25519 + ML-KEM-1024; он едет в настройке звонка, а она сама — внутри конверта 1:1 со сквозным шифрованием. Ключи привязаны к хешу всего обмена, у каждого направления свой ключ:
Настройка звонка — вместе с отпечатками DTLS — зашифрована и подписана звонящим, поэтому сервер не может ни прочитать, ни подменить их. Если подпись не совпадает с ключом звонящего, звонок не устанавливается.
Код: core/src/callkey.rs, kotlin/…/webrtc/CallFrameE2ee.kt, desktopMain/…/PcFrameCryptor.kt. Тесты: Rust callkey:: (обе стороны получают одинаковые ключи; любая подмена меняет ключи или даёт ошибку), Kotlin DesktopCallPqLoopbackTest на настоящем соединении WebRTC: с чужим ключом отбрасывается каждый кадр. С собеседником на 2.0.x звонок идёт только на DTLS-SRTP.
Конференции и встречи по ссылке
Сервера, который смешивает или декодирует медиа, нет. В конференции участники соединяются друг с другом попарно — напрямую или через сервер-ретранслятор, — и каждая пара выполняет свой обмен X25519 + ML-KEM-1024 со своими ключами кадров. Пара, где один из участников на 2.0.x, идёт только на DTLS-SRTP.
У встречи по ссылке есть 256-битный ключ комнаты, который живёт только в ссылке, после «#». Эта часть ссылки никогда не уходит в веб-запросе, поэтому сервер получает лишь случайный номер комнаты. Из ключа приложение выводит один ключ для описания комнаты и другой — для сигналов внутри неё; сервер хранит и то и другое только шифротекстом. Медиа между каждой парой защищено так же, как в конференции.
Код: kotlin/…/meet/MeetCrypto.kt, MeetLink.kt, webrtc/CallFrameE2ee.kt. Тесты: MeetLinkCryptoTest (7), DesktopCallPqLoopbackTest.conferenceLegUsesItsOwnExchange.
Что видит сервер
Не только чего он не видит, но и что видит. Код сервера закрыт, поэтому таблица описывает, что доходит до сервера по открытому коду клиента:
Проверьте трафик сами
Для этого не нужен наш код — нужна только сеть, которую вы контролируете. Раздайте интернет с ноутбука на телефон или запустите Umbera для компьютера на своей машине и запишите трафик Wireshark.
- Выпишите все адреса, к которым подключается приложение, и сравните с этой страницей.
- Отправьте сообщение из одной буквы, потом длинный абзац. Размер отправки не следует за длиной текста: он попадает в несколько фиксированных размеров.
- Включите Tor в настройках и повторите: сообщения больше не идут на сервер напрямую — только в сеть Tor.
- Позвоните и поставьте фильтр, указанный ниже. Вы увидите рукопожатие DTLS и дальше только пакеты SRTP — ни открытого RTP, ни того, что Wireshark смог бы превратить в звук или картинку.
Чего запись трафика не покажет: второй слой звонка и содержимое конвертов находятся внутри шифра и выглядят как шум. Так и должно быть — это проверяют тесты и векторы выше.
Чего мы не утверждаем
Независимого аудита пока нет
Код открыт и покрыт тестами, но внешняя фирма его ещё не проверяла.
Сборки пока не воспроизводимы
Ядро можно собрать из исходников, но пересобрать приложение из магазина бит в бит и сравнить пока нельзя. До тех пор «приложение работает на этом коде» держится на нашем слове и на том, что вы можете наблюдать сами.
Сервер и приложения закрыты
В репозитории лежит код, который решает, что может узнать сервер. Сервер, интерфейс приложения и сетевой слой не опубликованы.
Без Tor сервер видит ваш IP-адрес
Tor выключен, пока вы его не включите. В самом Tor постквантового рукопожатия пока нет; то, что Umbera отправляет внутри него, зашифровано постквантово.
Со старыми приложениями — прежние схемы
С собеседником на 2.0.x звонки идут без второго слоя, группы остаются на прежнем наборе, код безопасности — версии 1, а адрес ящика не меняется. Сквозное шифрование при этом сохраняется.
Смена ключа предупреждает, но не блокирует
После смены ключа собеседника сообщения и звонки продолжаются; доверять ли новому ключу, решаете вы. Отсутствие записи в журнале прозрачности пока не вызывает предупреждения.
Подпись ML-DSA вершины журнала — на сервере
С 16 ноября сервер подписывает каждую вершину журнала ключами Ed25519 и ML-DSA-65, приложение закрепляет оба ключа при первом получении. Код подписи — на сервере, а он закрыт.
Взломанное устройство — вне модели
Шифрование защищает данные в пути и на сервере, но не на устройстве, которым управляет кто-то другой.
Что пока не публикуется
Часть деталей реализации — например, код сервера, механизмы доставки и защиты от злоупотреблений, сетевой слой и хранилища приложения — пока не публикуется. Полный код и документация будут переданы доверенным независимым аудиторам при проведении аудита проекта; после аудита мы опубликуем его отчёт.
Нашли проблему?
Если код делает меньше, чем написано на этой странице, мы хотим узнать об этом первыми. Об уязвимостях сообщайте закрыто, как описано в SECURITY.md; вопросы и идеи — в Discussions на GitHub. Мы отвечаем на каждое сообщение, исправляем ошибку и рассказываем, в чём она была.