Гайды · документация

Пакет и доступ

открывает подробности ведёт к полному разбору

Приватный пакет — это все ваши документы в одной запертой папке на вашем устройстве. В общую сеть уходит только оглавление: что внутри и сколько весит. Доступ к содержимому выдаётся пропуском — по разделам, по отдельным файлам и на срок.

Что внутри пакета

РазделЧто туда кладутЧто видно без пропуска
О себе и контактыКороткое описание, телефон, почта, мессенджерытолько название раздела и размер
Опыт работыМеста работы, обязанности, достижениятолько название и размер
ОбразованиеУчебные заведения, курсы, дипломытолько название и размер
Проекты и портфолиоПроекты, ссылки, результатытолько название и размер
ФайлыРезюме, дипломы, сканы, фото, портфолиоимя, размер, отпечаток, число частей

Каждый раздел заперт своим ключом. В публичную карточку уходит только оглавление пакета: состав, размеры и отпечатки — без содержимого.

технически как устроен пакет на диске
  • Разделы: cv.summary, cv.experience, cv.education, cv.projects, files.
  • Каждый раздел шифруется своим ключом: XChaCha20-Poly1305, дополнищая привязка (AAD) — по контексту раздела.
  • Ключи разделов — pack.keys.json, сам пакет — pack.enc.json.
  • Публичный манифест — идентификатор, состав, размеры и хеши.
Экран приватного пакета: состав секций, манифест, кнопка ротации ключей
Пакет. Слева — состояние разделов и оглавление, справа — ключи и кнопка замены ключей. Публично видно только оглавление.

Файлы и фото

Файлы режутся на части и шифруются по отдельности. Поэтому можно открыть только первые страницы документа, а не весь скан. Хранилище выбирается приложением: на устройстве, на своём сервере или в открытой сети — сам файл и ключ к нему идут получателю пропуском.

технически части, адреса и хранилища
  • Адрес части — sha256 шифротекста, поэтому одинаковые файлы не склеиваются в один.
  • Хранилище — адаптер: локально, HTTP, S3 или IPFS.
  • Пропуск может открывать часть файла: диапазоны частей задаются как ID:0-2.
Файлы приватного пакета: список, размеры, чанки, миниатюры
Файлы. У каждого файла видны размер, число частей и место хранения. Миниатюры кэшируются локально.

Заявка работодателя

Заявка приходит в приложение как обычное сообщение: кто просит доступ, зачем, какие разделы нужны и до какого числа ждёт ответа. Метка «истекает скоро» появляется, если до срока меньше трёх дней. Отклонение локальное: работодатель не узнает причину.

технически чем является заявка в сети

Заявка — событие kind 30079, доставленное по NIP-59 gift wrap: релей видит конверт и адресата, содержимое зашифровано на ключе получателя.

Заявка работодателя: кто просит, цель, секции, срок ответа
Заявка. Видно, кто просит, зачем и что именно. Отклонение локальное: работодатель не узнает причину.

Одобрение и пропуск

  1. Выберите разделы. Вручную или быстрым набором: «Минимум», «Стандарт», «Без файлов», «Всё».
  2. Отметьте файлы. Можно открыть отдельные файлы и даже их части.
  3. Задайте срок. 14, 30, 60 или 90 дней — после него доступ закрывается сам.
  4. Подтвердите. Получателю уходят ключи только разрешённых разделов, и он открывает данные на своём устройстве.
технически как передаются ключи и как отозвать доступ
  • Ключи разрешённых разделов заворачиваются на ключ получателя (M1 key wrap, ECDH); событие пропуска — kind 30080.
  • Срок указан в самом пропуске: по его истечении доступ закрывается без действий с чьей-либо стороны.
  • Отзыв — pack-rotate: замена ключей разделов. Старые пропуска перестают открывать текущий пакет.
Экран выдачи гранта: выбор секций, файлов и срока доступа
Пропуск. Открывается только выбранное и только на срок. Получатель расшифровывает данные на своём устройстве.
Отзыв не отменяет копию. Замена ключей закрывает текущий пакет, но то, что получатель уже успел прочитать и сохранить, вернуть нельзя. Поэтому выдавайте минимум и на короткий срок.

Квалификации и подтверждённые документы

Квалификацию выпускает тот, кто вправе её подтвердить: вуз, учебный центр, сертификационная организация или работодатель. Документ ваш, и предъявлять его можно частями — например, только название специальности, без остальных полей. Работодатель проверяет подпись издателя и то, что документ не отозван.

технически формат квалификаций и проверка

Издатель выпускает публичную квалификацию kind 30081 на ключ кандидата: тип, название, значок. Полный документ — SD-JWT VC — лежит в пакете; предъявляются только выбранные поля. Проверка: подпись издателя (did:key или did:web), KB-JWT, аудитория и отзыв через битстринг-статус-лист.

pvctl quals-issue --subject npub1... --type education \ --title "Инженер АСУ ТП" --publish pvctl vc-present --claims title,issuerName # показать только нужные поля pvctl vc-verify --require-fact --require-status # проверить подпись, аудиторию и отзыв pvctl quals-status-set --revoke # статус отзыва

Команды терминала

Всё то же доступно из терминала — тем же ядром, что и в интерфейсе.

технически команды пакета и доступов
pvctl pack-status # состояние пакета и манифест pvctl requests-fetch --password PW # забрать заявки с релеев pvctl grants-fetch --password PW # забрать выданные доступы pvctl pack-rotate --password PW # отозвать доступ: замена ключей разделов pvctl pack-export --out ./pack.enc.json # резервная копия шифротекста