Ключи и разрешения

API-ключи принадлежат организации и имеют явные разрешения. Используйте отдельные ключи для приема событий агента, доставки политик, оценщиков, CI-автоматизации и административных скриптов.

Создание и ротация ключа

Dashboard
CLI

Перейдите в Administration → Keys, выберите new key и введите имя рабочей нагрузки.
Выберите набор разрешений и корректируйте отдельные разрешения только если предустановка недостаточна.
Создайте ключ и немедленно скопируйте его одноразовый секрет.
Откройте ключ позже, чтобы обновить разрешения, отключить его или переформировать секрет.

Окно создания — это место, где вы выбираете наиболее узкие разрешения, требуемые рабочей нагрузкой.

Ящик нового API-ключа с предустановками разрешений и отдельными разрешениями.

После создания страница Keys показывает постоянные метаданные и действия управления. Одноразовый секрет больше не отображается.

Страница API Keys, показывающая разрешения ключа, время создания и действия для переформирования и отключения.

Используйте этот список для регулярного проверки разрешений и отключения ключей, которые больше не соответствуют активной рабочей нагрузке.

fp keys create production-agents \
  --add events:add \
  --add policies:pull
fp keys show production-agents
fp keys update production-agents --add events:read
fp keys regenerate production-agents --yes
fp keys disable production-agents

Перенаправляйте или захватывайте вывод создания/переформирования безопасно; секрет возвращается один раз.

Два разрешения, требуемые подключенной машиной Failproof AI, независимы друг от друга:

events:add отправляет события и данные сеанса.
policies:pull извлекает назначенные развертывания политик.

Секреты ключей отображаются при создании или переформировании. Сохраняйте их в менеджере секретов и ротируйте без повторного использования интерактивных учетных данных оператора.

Каталог разрешений

Область	Разрешения
Events	`events:add`, `events:read`
Keys	`keys:create`, `keys:read`, `keys:disable`, `keys:regenerate`; `keys:update` только для интерактивных сеансов
Users	`users:create`, `users:read`, `users:update`, `users:delete`
Evaluations	`evaluations:read`, `evaluations:trigger`
Dashboards	`dashboards:read`, `dashboards:write`, `dashboards:delete`
Queries	`queries:read`, `queries:write`, `queries:delete`, `queries:run`
Assistant	`agent:use`
Settings	`settings:read`, `settings:write`
Alerts	`alerts:read`, `alerts:write`
Issues	`issues:read`, `issues:create`, `issues:close`
Audits	`audits:read`, `audits:write`
Policies	`policies:read`, `policies:write`, `policies:pull`
Usage	`usage:read`

orgs:admin зарезервирован для оператора экземпляра и не может быть предоставлен ключу организации или обычному члену. Устаревшие токены incidents:* и alerts:ack принимаются для совместимости и нормализуются к текущим разрешениям issues:*. Встроенные наборы разрешений — это read-only, standard и admin. standard добавляет триггерирование оценок, выполнение запросов, ответ на проблемы и использование ассистента к разрешениям для чтения. Создание ключа удаляет разрешения только для людей, даже если набор разрешений их содержит.

Ключи с областью действия экземпляра могут выбирать организацию с помощью заголовка X-AgentEye-Org. Устанавливайте его явно при развертывании нескольких организаций; его отсутствие может выбрать организацию по умолчанию.

​Создание и ротация ключа

​Каталог разрешений

Создание и ротация ключа

Каталог разрешений