Secrets: ключи приложений
На этой странице
Кому доступен ключ
У каждого ключа есть имя и значение. Владелец аккаунта всегда имеет доступ. Доступ можно дать серверам из Servers и вашим компьютерам с установленным JWS Agent. Старые подписанные внешние клиенты Secrets также сохраняют свой доступ. Отдельного каталога машин нет.
Откройте ключ и настройте Key access. Права независимы:
| Право | Разрешает |
|---|---|
| Read | Получить значение ключа явным чтением, например сохранить его в файл проекта. |
| Write | Заменить значение, переименовать или удалить ключ. Не управляет разрешениями других серверов. |
Сервер, создавший ключ, сразу получает оба права только на него. Само удостоверение VM не открывает остальные ключи. Привязка кодом не требуется: удостоверение устанавливается автоматически внутри управляемого сервера. Удаление VM блокирует это удостоверение и отменяет её незавершённые запросы.
JWS Agent на своём компьютере
- Откройте Secrets → Install и нажмите Get install command.
- Выберите Linux или Windows и скопируйте Copy install command.
- Выполните команду на нужном компьютере от обычного пользователя. CLI установится, сохранит защищённую идентичность и запустит фоновый агент.
Хост автоматически появится на странице Secrets → Install рядом с управляемыми серверами. Главная страница Secrets содержит только ключи. Для этого не нужно придумывать запрос ключа, добавлять VM или подтверждать код. Установочная ссылка действует 30 минут и привязывает хост к вашему аккаунту; передайте её своему агенту приватно, не публикуйте.
После установки доступны команды Secrets, AI Bridge и Mail. Доступ к существующим ключам по-прежнему выдаётся через Key access, а ящик и право ответа выбираются в Mail. Create new keys выключено по умолчанию. Revoke host прекращает будущий доступ хоста к JWS; уже сохранённые локальные значения не удаляются.
Ранее подключённые внешние клиенты Secrets
Владелец открывает Secrets → Install → Previous CLI connections и создаёт приватную контактную ссылку. Она показывается один раз и только направляет первый запрос в ваш аккаунт: доступа к ключам не даёт. Передайте её своему агенту или компьютеру приватно.
jws secrets request API_KEY --contact OWNER_CONTACT_LINK --name Jooja --purpose "Настройка приложения"
Клиент сохраняет собственную Ed25519-идентичность в защищённом ~/.config/jws/external.json. В запросе владелец видит имя, отметку External и отпечаток. Имя не является удостоверением. После сохранения запрошенного ключа клиент получает Read и Write только на него; доступ к существующим ключам выдаётся отдельно.
Create new keys — отдельное разрешение владельца для внешнего клиента, выключенное по умолчанию. Оно не следует из Read или Write. Контактную ссылку можно заменить или отключить; уже известные клиенты сохраняют свою идентичность. Revoke у клиента блокирует будущие запросы, снимает доступы и отменяет ожидающие запросы. Тот же ключ идентичности не может обойти отзыв повторной регистрацией.
CLI работает на Ubuntu и Windows без Node.js. Для Windows замените jws на .\jws.exe. Управляемое удостоверение JWS не заменяется внешним: эти способы не смешиваются. Ранее подключённый внешний клиент Secrets не получает доступ к Mail или платному AI API автоматически; для новой установки используйте JWS Agent.
Запросить недостающий ключ
Агент сначала проверяет доступные ключи через jws secrets list. Если нужного нет, он создаёт один временный запрос с назначением и даёт владельцу приватную ссылку ввода.
jws secrets request OPENAI_API_KEY --purpose "Настройка my-app" --request-id my-app-openai
- Владелец открывает Secrets или приватную ссылку. Все ожидающие запросы появляются в обязательной модалке автоматически; отдельной кнопки Requests нет.
- Владелец вводит значение и сохраняет его либо отменяет запрос. Закрыть модалку вместо решения нельзя. Истечение срока также завершает запрос.
- При сохранении создаётся ключ и выдаются Read и Write запросившему серверу. Дополнительная выдача разрешения не нужна.
Запрос по умолчанию действует час. --expires-in задаёт срок в секундах от 60 до 86400. Повтор одной задачи использует тот же --request-id, чтобы не создавать дубликаты. Приватную ссылку не публикуйте; ключ вводите в Secrets, не в переписку.
Для продолжения после перезапуска агент сохраняет ID записи запроса из ответа и проверяет его через jws secrets status REQUEST_ID. После выполнения статус содержит ID ключа. Само выполнение запроса не запускает приложение: агент продолжает свою задачу и использует сохранённый ключ.
Получить ключ в проект
На управляемой Ubuntu VM выполняйте jws как пользователь ubuntu. В каталоге проекта добавьте .env в .gitignore, если проект хранится в Git. Затем запрос с ожиданием сразу доставит значение в файл:
jws secrets request OPENAI_API_KEY --purpose "Настройка my-app" --request-id my-app-openai --wait --env .env --var OPENAI_API_KEY
Для уже существующего доступного ключа возьмите его ID из списка и выполните:
jws secrets list
jws secrets save KEY_ID --env .env --var OPENAI_API_KEY
KEY_ID замените реальным ID. CLI сохраняет другие переменные, не печатает значение и защищает файл правами доступа. Он не запишет ключ в отслеживаемый или неигнорируемый Git-файл, .env.example или небезопасную ссылку. Для проверки Git нужен установленный Git.
После сохранения запускайте приложение обычным способом, с его штатным чтением .env. jws run, отдельный демон и новый запрос ключа при каждом запуске не нужны.
История чтений
История находится у конкретного ключа. Кнопка Copy копирует ключ без показа значения на странице. Это явное чтение с теми же проверками доступа. Получение значения, включая Copy, Reveal value и сохранение через CLI, фиксирует ключ, сервер или владельца и время. Список показывает только метаданные. История не исчезает при удалении ключа.
История учитывает обращения к JWS, а не последующее чтение локального .env. Отзыв разрешений запрещает будущие обращения, но не удаляет копию, уже сохранённую на сервере. Чтобы сделать прежнюю копию бесполезной, замените сам ключ у выдавшего его сервиса.
Можно ли увидеть ключ на сервере
В хранилище JWS значения зашифрованы AES-256-GCM; ключ шифрования хранится отдельно от базы. Передача идёт по HTTPS, выдача ограничена правами сервера и владельца. Это серверное шифрование, не zero-knowledge: привилегированный оператор JWS может расшифровать значение.
В проектном .env значение хранится открытым текстом. Это нужно приложению для обычного запуска. Его может прочитать владелец файла и root/администратор сервера. Защищённые права ограничивают других пользователей ОС, но не скрывают ключ от администратора.
Удостоверение CLI подтверждает конкретную VM и само не содержит значения всех ключей. Полностью скрыть секрет от программы, которая его использует, или администратора этой программы такой способ доставки не может.