
Just-in-time API-ключи для ИИ-агентов — и любого другого процесса, который вы через него маршрутизируете: вызывающая сторона видит только плейсхолдер.
Ваш ИИ-агент никогда не хранит ваши API-ключи. Он отправляет заполнитель; настоящий секрет подставляется на лету.
Останавливает похитителей учётных данных (Shai-Hulud и подобные) и агентов с prompt-инъекциями от утечки ваших секретов. Скомпрометированному агенту нечего красть.
Под капотом это loopback HTTPS-прокси. Он извлекает каждое учётное данное из вашего хранилища точно в срок и внедряет его в исходящий запрос, поэтому вызывающий процесс (ваш агент или что угодно ещё, что вы маршрутизируете через него) никогда не держит реальные байты.
Бэкенды хранилищ: macOS Keychain, Bitwarden Secrets Manager, Google Secret Manager, AWS Secrets Manager, static (без хранилища, для ознакомления) и env. На Mac бэкенд Keychain не требует облачной учётной записи хранилища и дополнительных зависимостей: ваши секреты остаются там, где они уже есть. (kow setup по-прежнему по умолчанию использует Bitwarden; передайте нужный бэкенд.) См. Архитектура адаптеров.
1. Установка (Linux pipx, macOS brew):
pipx install 'keys-on-the-wire[bitwarden]'
# macOS: brew install inflightsec/keys-on-the-wire/keys-on-the-wire
sudo kow setup --bws
2. Установите навык, чтобы ваш агент сам писал привязку за вас:
/plugin marketplace add inflightsec/keys-on-the-wire
/plugin install kow@keys-on-the-wire
3. Оформите сервис через брокера. Скажите «маршрутизируй Stripe API через Keys on the Wire». Навык создаёт заполнитель и выводит точную заметку для вставки в ваше хранилище. Он никогда не видит ваш ключ.
4. Добавьте реальный ключ в ваше хранилище с этой заметкой, затем маршрутизируйте агента через прокси:
kow env && kow run claude
Готово. Агент всегда отправляет только заполнитель; Keys on the Wire подставляет реальный ключ на лету.
Новичок? Руководство по быстрому старту подробно описывает первый запуск, а Предварительные требования охватывает настройку хранилища. Предпочитаете переменные окружения shell вместо kow run? См. Использование.
kow run -- <command> задаёт переменные прокси и CA только в этом процессе; ваша оболочка входа никогда их не наследует. Ограничение одним процессом.methods: и paths: — это рычаг, и он применяется. Подходит ли вам? описывает полные границы.Каждый MCP-сервер хранит долгоживущий токен в открытом виде в конфигурации вашего клиента, доступный каждому другому серверу, который загружает клиент. kow mcp install заменяет этот постоянный секрет на заполнитель и маршрутизирует исходящий трафик сервера через прокси:
kow mcp install github --host api.github.com --env-var GITHUB_PERSONAL_ACCESS_TOKEN \
--server-cmd "npx -y @modelcontextprotocol/server-github"
Он выводит заметку для хранилища и точную команду claude mcp add --env. Дизайн и модель угроз: ADR-0040.
Подключение учётных данных — это не написанный вручную YAML. Встроенный навык kow спрашивает форму аутентификации и хост, затем сообщает вам точно, что вставить в поле Notes вашего секрета:
# kow-binding
api.acme.com
Эта строка-маркер и делает заметку привязкой; без неё заметка остаётся обычным человеческим описанием и никогда не парсится (ADR-0025). Ассистент предлагает, вы применяете. Он никогда не видит и не хранит секрет.
Начните здесь — Подходит ли вам?, если вы оцениваете · Предварительные требования для настройки хранилища · Быстрый старт для первого запуска за 10 минут.
Понять — Концепции о заполнителе, привязке, CA и fail-closed простыми словами · Архитектура о модели угроз, инвариантах G1–G9 и остаточных рисках.
Установка и эксплуатация — Linux · Docker · macOS · Использование · Один процесс · Изоляция Linux · Изоляция macOS · Google Secret Manager