JWS.Консоль ↗
Разделы документации

Secrets: ключи приложений

Кому доступен ключ

У каждого ключа есть имя и значение. Владелец аккаунта всегда имеет доступ. Доступ можно дать серверам из Servers и вашим компьютерам с установленным JWS Agent. Старые подписанные внешние клиенты Secrets также сохраняют свой доступ. Отдельного каталога машин нет.

Откройте ключ и настройте Key access. Права независимы:

ПравоРазрешает
ReadПолучить значение ключа явным чтением, например сохранить его в файл проекта.
WriteЗаменить значение, переименовать или удалить ключ. Не управляет разрешениями других серверов.

Сервер, создавший ключ, сразу получает оба права только на него. Само удостоверение VM не открывает остальные ключи. Привязка кодом не требуется: удостоверение устанавливается автоматически внутри управляемого сервера. Удаление VM блокирует это удостоверение и отменяет её незавершённые запросы.

JWS Agent на своём компьютере

  1. Откройте Secrets → Install и нажмите Get install command.
  2. Выберите Linux или Windows и скопируйте Copy install command.
  3. Выполните команду на нужном компьютере от обычного пользователя. 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
  1. Владелец открывает Secrets или приватную ссылку. Все ожидающие запросы появляются в обязательной модалке автоматически; отдельной кнопки Requests нет.
  2. Владелец вводит значение и сохраняет его либо отменяет запрос. Закрыть модалку вместо решения нельзя. Истечение срока также завершает запрос.
  3. При сохранении создаётся ключ и выдаются 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 и само не содержит значения всех ключей. Полностью скрыть секрет от программы, которая его использует, или администратора этой программы такой способ доставки не может.

Правила и примеры проверены 5 октября 2026. Актуальные цены и доступность приложений смотрите в консоли.