Обмен записями
Пассворк предоставляет три способа обмена записями: доступ к сейфу, прямая передача записи и внешние ссылки.
Обзор способов обмена
| Способ | Получатель | Требуется аккаунт | Ключ защиты |
|---|---|---|---|
| Доступ к сейфу | Пользователь Пассворка | ✓ | RSA-ключ получателя |
| Прямая передача записи | Пользователь Пассворка | ✓ | RSA-ключ получателя |
| Внешняя ссылка | Любой человек | — | Ключ ссылки в URL |
Внутренний шэринг (между пользователями)
Предоставление доступа к сейфу
При добавлении пользователя в сейф происходит криптографический обмен ключами.
Процесс предоставления доступа:
- Владелец сейфа инициирует добавление пользователя B
- Сервер возвращает публичный RSA-ключ пользователя B
- Владелец расшифровывает ключ сейфа своим приватным RSA-ключом (WebCrypto)
- Владелец шифрует ключ сейфа публичным RSA-ключом пользователя B (WebCrypto)
- Зашифрованная копия ключа отправляется на сервер
- Сервер сохраняет копию, связанную с пользователем B
- Пользователь B при следующем входе получает доступ к сейфу
Важно: Сервер видит только зашифрованные ключи. Расшифровать их может только владелец соответствующего приватного RSA-ключа.
Процесс для владельца
- Выбор пользователя для предоставления доступа
- Получение публичного RSA-ключа этого пользователя
- Шифрование ключа сейфа публичным ключом получателя (RSA-OAEP)
- Отправка зашифрованной копии на сервер
Процесс для получателя
- При входе в систему получатель видит новый сейф в списке
- Загружает зашифрованную копию ключа сейфа
- Расшифровывает её своим приватным RSA-ключом (WebCrypto)
- Получает доступ ко всем записям в сейфе
Уровни доступа
При предоставлении доступа можно указать уровень прав:
- Просмотр — только чтение записей
- Редактирование — изменение существующих записей
- Полный доступ — создание, редактирование, удаление записей
- Администратор — управление правами других пользователей
Уровень доступа контролируется на уровне приложения. Криптографически все пользователи с доступом к сейфу имеют одинаковый ключ. Разграничение прав обеспечивается серверной логикой.
Прямая передача записи (раздел «Входящие»)
Запись можно передать конкретному пользователю без добавления его в сейф.
Процесс прямой передачи:
- Отправитель расшифровывает ключ записи (через ключ сейфа, AES-256-CBC)
- Отправитель запрашивает публичный RSA-ключ получателя
- Отправитель шифрует ключ записи публичным RSA-ключом получателя (WebCrypto)
- Зашифрованная копия ключа отправляется на сервер
- Запись появляется в разделе «Входящие» у получателя
- Получатель расшифровывает ключ записи своим приватным RSA-ключом
Отличие от доступа к сейфу: Передаётся ключ конкретной записи, а не ключ сейфа. Получатель не видит другие записи в сейфе.
Отзыв доступа
При отзыве доступа к сейфу или записи:
- Сервер удаляет зашифрованную копию ключа для пользователя
- Пользователь больше не может получить ключ с сервера
- Данные становятся недоступными через интерфейс
Важно понимать: если пользователь ранее получил ключ сейфа/записи и сохранил его локально, он теоретически может расшифровать данные при наличии зашифрованного содержимого (например, из резервной копии базы данных).
Это фундаментальное ограничение криптографии с общими ключами. Для полной защиты после отзыва доступа рекомендуется:
- Сменить пароли в критичных записях
- При необходимости — пересоздать сейф с новым ключом.
Внешние ссылки
Внешние ссылки позволяют поделиться записью с человеком, не имеющим учётной записи в Пассворке.
Принцип работы
Создание ссылки (владелец):
- Владелец выбирает запись для шэринга
- Генерируется случайный ключ ссылки (256 бит, на клиенте)
- Создаётся копия выбранных полей записи
- Копия шифруется ключом ссылки (AES-256-CBC)
- На сервер отправляется: зашифрованная копия + хеш ключа + настройки
- Сервер генерирует токен ссылки (43 символа)
- Владелец получает URL вида
https://passwork.example/g/p/{token}
Открытие ссылки (получатель):
- Владелец передаёт URL получателю (email, мессенджер)
- Получатель открывает URL
- Браузе р отправляет запрос на сервер (только токен, без ключа)
- Сервер проверяет токен (существует, не истёк, не одноразовый)
- Сервер возвращает зашифрованные данные
- JavaScript извлекает ключ из hash-части URL (
#code=...) - Данные расшифровываются ключом ссылки в браузере (AES-256-CBC)
- Получатель видит запись
Токен и ключ ссылки
Внешняя ссылка содержит два компонента:
| Параметр | Токен ссылки | Ключ ссылки |
|---|---|---|
| Назначение | Идентификатор ссылки | Шифрование данных |
| Расположение | Path URL (/g/p/{token}) | Hash URL (#code={key}) |
| Генерация | На сервере | На клиенте |
| Длина | 43 символа | 100 символов → 256 бит |
| Алфавит | A-Z, a-z, 0-9 (62) | A-Z, a-z, 0-9, @, ! (64) |
| Входная энтропия | ~256 бит | ~596 бит |
| Видит сервер | ✓ | — (только хеш) |
П реобразование ключа: 100-символьная строка преобразуется в 256-битный ключ AES через функцию вывода ключа (KDF) — аналогично ключам сейфа, записи и вложения.
Клиентский ключ ссылки генерируется только при включённом клиентском шифровании (CSE). Если CSE отключён, данные ссылки не шифруются на клиенте — применяется только серверное шифрование.
Формат URL:
https://passwork.example.com/g/p/{token}#code={ключ_ссылки}
Ключ ссылки передаётся в hash-части URL (после символа #). По стандарту HTTP, fragment (часть URL после #) никогда не отправляется на сервер — он обрабатывается только браузером на стороне клиента.
Это означает:
- При переходе по ссылке сервер видит только
{token}, но не видит ключ. - Ключ доступен только JavaScript-коду в браузере получателя
- Даже при перехвате запроса на стороне сервера ключ остаётся защищённым
- Принцип Zero Knowledge соблюдается на уровне протокола HTTP
Хранение ключа на сервере
Ключ ссылки не хранится на сервере в открытом виде:
- Сервер сохраняет только SHA-256 хеш ключа для проверки корректности при открытии
- При открытии ссылки клиент вычисляет хеш введённого ключа и от правляет его на сервер
- Сервер сравнивает хеши и возвращает зашифрованные данные
Структура данных ссылки
На сервере хранится:
| Данные | Шифрование |
|---|---|
| Идентификатор ссылки (токен) | — |
| Копия данных записи | Ключом ссылки + серверным ключом |
| SHA-256 хеш ключа ссылки | Серверным ключом |
| Настройки (TTL, одноразовость) | Серверным ключом |
Копируемые поля записи
При создании ссылки копируются:
| Поле | Включается |
|---|---|
| Название | ✓ |
| Логин | Да (опционально) |
| Пароль (зашифрованный) | ✓ |
| URL | Да (опционально) |
| Описание | Да (опционально) |
| Дополнительные поля | Да (опционально) |
| Вложения | Да (опционально, метаданные + ключи) |
Настройки ссылки
| Настройка | Описание |
|---|---|
| Время жизни (TTL) | Ссылка автоматически удаляется после указанного времени |
| Одноразовость | Ссылка становится недействительной после первого просмотра |
| Защита паролем | Дополнительный пароль для доступа |
| Выбор полей | Какие поля записи включить в ссылку |
Безопасность внешних ссылок
Принцип Zero Knowledge
- Ключ ссылки передаётся в hash-части URL (
#code=...) — браузер не отправляет её на сервер - При переходе по ссылке сервер видит только токен, ключ остаётся только в браузере
- Сервер хранит только хеш ключа для проверки корректности ввода
- Данные на сервере зашифрованы и не могут быть прочитаны без ключа
Модель угроз
| Угроза | Защита |
|---|---|
| Перехват запроса на сервере | Ключ в hash-части не отправляется на сервер |
| Перехват полного URL | Требуется перехват на стороне клиента |
| Компрометация сервера | Данные зашифрованы, ключа нет на сервере |
| Перебор токенов | 256 бит энтропии делают перебор невозможным |
| Повторное использование | Одноразовые ссылки |
| Логирование URL на сервере | В логах только токен, без ключа |
Рекомендации
- Для критичных данных — используйте одноразовые ссылки
- Для временного доступа — устанавливайте короткий TTL
- Для дополнительной защиты — передавайте ключ отдельным каналом
- Для аудита — отслеживайте использование ссылок в журнале
Включение вложений в ссылки
При создании ссылки с вложениями:
Структура оригинальной записи: ключ записи, файл (зашифрован ключом вложения), ключ вложения (зашифрован ключом записи).
При создании ссылки: генерируется ключ ссылки, ключ вложения перешифровывается ключом ссылки, данные файла остаются на сервере без изменений, в ссылку включается: ID файла + имя + перешифрованный ключ.
При открытии ссылки: получатель расшифровывает ключ вложения ключом ссылки, запрашивает файл с сервера по ID, расшифровывает файл ключом вложения.
Сравнение способов обмена
| Критерий | Доступ к сейфу | Прямая передача | Внешняя ссылка |
|---|---|---|---|
| Требуется аккаунт | ✓ | ✓ | — |
| Доступ ко всем записям | ✓ | — (только к одной) | — (только к одной) |
| Аудит доступа | ✓ | ✓ | ⚠️ Ограниченный |
| Можно отозвать | ✓ | ✓ | ✓ |
| Zero Knowledge | ✓ | ✓ | ✓ |
| Синхронизация изменений | ✓ | ⚠️ | — (копия данных) |