Гайды · документация
Пакет и доступ
открывает подробности ведёт к полному разбору
Приватный пакет — это все ваши документы в одной запертой папке на вашем устройстве. В общую сеть уходит только оглавление: что внутри и сколько весит. Доступ к содержимому выдаётся пропуском — по разделам, по отдельным файлам и на срок.
Что внутри пакета
| Раздел | Что туда кладут | Что видно без пропуска |
|---|---|---|
| О себе и контакты | Короткое описание, телефон, почта, мессенджеры | только название раздела и размер |
| Опыт работы | Места работы, обязанности, достижения | только название и размер |
| Образование | Учебные заведения, курсы, дипломы | только название и размер |
| Проекты и портфолио | Проекты, ссылки, результаты | только название и размер |
| Файлы | Резюме, дипломы, сканы, фото, портфолио | имя, размер, отпечаток, число частей |
Каждый раздел заперт своим ключом. В публичную карточку уходит только оглавление пакета: состав, размеры и отпечатки — без содержимого.
технически как устроен пакет на диске
- Разделы:
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: релей видит конверт и
адресата, содержимое зашифровано на ключе получателя.
Одобрение и пропуск
- Выберите разделы. Вручную или быстрым набором: «Минимум», «Стандарт», «Без файлов», «Всё».
- Отметьте файлы. Можно открыть отдельные файлы и даже их части.
- Задайте срок. 14, 30, 60 или 90 дней — после него доступ закрывается сам.
- Подтвердите. Получателю уходят ключи только разрешённых разделов, и он открывает данные на своём устройстве.
технически как передаются ключи и как отозвать доступ
- Ключи разрешённых разделов заворачиваются на ключ получателя (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 # резервная копия шифротекста