Каталог встроенных политик - Failproof AI

Установленный пакет является источником истины для доступности политик. Запустите failproofai policies после каждого обновления, так как записи каталога и поведение могут меняться в зависимости от версии пакета.

Рекомендуемая базовая конфигурация

Рекомендуемый выбор в интерактивной установке в настоящее время включает санитайзеры секретов, защиту окружения, самозащиту, защиту от опасных команд и безопасность защищённых веток:

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-failproofai-commands   block-sudo
block-curl-pipe-sh           block-rm-rf
block-push-master            block-force-push

block-failproofai-commands всегда включена. Она указана выше для полноты, но регистрируется при каждой проверке независимо от того, включена ли она в вашем наборе активных политик, и не может быть отключена или приостановлена — защита, которую агент может отключить, не является защитой. Рекомендуемый набор намеренно ограничен в сравнении с Всеми. Политики инфраструктуры и рабочего процесса могут прерывать допустимые операции и должны быть включены только для репозиториев и машин, которым они необходимы.

Секреты и окружение

Политика	Триггер	Результат
`sanitize-jwt`	`PostToolUse`	Удаляет JWT из вывода инструмента перед тем, как его увидит модель.
`sanitize-api-keys`	`PostToolUse`	Удаляет распространённые ключи OpenAI, Anthropic, GitHub, AWS, Stripe и Google.
`sanitize-connection-strings`	`PostToolUse`	Удаляет строки подключения к базам данных, содержащие учётные данные.
`sanitize-private-key-content`	`PostToolUse`	Удаляет содержимое PEM приватных ключей.
`sanitize-bearer-tokens`	`PostToolUse`	Удаляет токены авторизации в заголовке Authorization.
`protect-env-vars`	`PreToolUse` на shell-инструментах	Блокирует команды, которые выводят переменные окружения.
`block-env-files`	`PreToolUse`	Блокирует чтение и запись файлов `.env`.
`block-read-outside-cwd`	`PreToolUse` на инструментах чтения, glob, grep или shell	Ограничивает чтение директорией работы сеанса.
`block-secrets-write`	`PreToolUse` на инструментах записи	Блокирует запись в распространённые файлы с ключами секретов и учётными данными.

Опасные команды и инфраструктура

Политика	Триггер	Результат
`block-sudo`	`PreToolUse`, `PermissionRequest`	Блокирует `sudo`, если не совпадает разрешающий шаблон.
`block-curl-pipe-sh`	`PreToolUse`	Блокирует загруженные скрипты, передаваемые напрямую в shell.
`block-rm-rf`	`PreToolUse`	Блокирует опасные шаблоны рекурсивного удаления.
`block-failproofai-commands`	`PreToolUse`, `PermissionRequest`	Всегда включена, не может быть отключена. Блокирует каждый вызов CLI Failproof AI, самопауз и удаление пакета.
`block-kubectl`	`PreToolUse`	Ограничивает команды Kubernetes.
`block-terraform`	`PreToolUse`	Ограничивает команды Terraform и OpenTofu.
`block-aws-cli`	`PreToolUse`	Ограничивает команды AWS CLI.
`block-gcloud`	`PreToolUse`	Ограничивает команды Google Cloud CLI.
`block-az-cli`	`PreToolUse`	Ограничивает команды Azure CLI.
`block-helm`	`PreToolUse`	Ограничивает команды Helm.
`block-gh-pipeline`	`PreToolUse`	Ограничивает операции GitHub CLI, изменяющие workflow, run, merge, release, cache и secrets.

Безопасность Git и базы данных

Политика	Триггер	Результат
`block-push-master`	`PreToolUse`	Блокирует прямые push в настроенные защищённые ветки.
`block-force-push`	`PreToolUse`	Блокирует force-push; `--force-with-lease` остаётся разрешённым в текущей реализации.
`block-work-on-main`	`PreToolUse`	Блокирует коммиты и merge на защищённых ветках.
`warn-git-amend`	`PreToolUse`	Предупреждает перед переписыванием коммита с `--amend`.
`warn-git-stash-drop`	`PreToolUse`	Предупреждает перед необратимым удалением или очисткой stash.
`warn-all-files-staged`	`PreToolUse`	Предупреждает при широком `git add -A`, `git add .` или `git add --all`.
`warn-destructive-sql`	`PreToolUse`	Предупреждает о `DROP`, `TRUNCATE` и `DELETE` без `WHERE` через известные клиенты БД.
`warn-schema-alteration`	`PreToolUse`	Предупреждает о известных операциях `ALTER TABLE` с колонками и переименованием.

Пакеты, поведение системы и циклы агента

Политика	Триггер	Результат
`warn-package-publish`	`PreToolUse`	Предупреждает перед публикацией в реестры пакетов.
`warn-global-package-install`	`PreToolUse`	Предупреждает перед глобальной установкой пакетов.
`prefer-package-manager`	`PreToolUse`	Указывает агенту использовать разрешённый менеджер пакетов.
`warn-large-file-write`	`PreToolUse` на инструментах записи	Предупреждает при превышении настроенного порога размера файла.
`warn-background-process`	`PreToolUse`	Предупреждает о фоновых процессах в отдельном сеансе или долгоживущих шаблонах.
`warn-repeated-tool-calls`	`PreToolUse`	Предупреждает после трёх или более идентичных вызовов инструмента.

Рабочий процесс завершения задачи

Эти политики требуют обработчика, который генерирует совместимое событие Stop.

Политика	Результат
`require-commit-before-stop`	Отказывает завершение, пока остаётся отслеживаемая работа без коммита.
`require-push-before-stop`	Отказывает завершение, пока коммиты остаются только локальными.
`require-pr-before-stop`	Требует pull request для текущей ветки.
`require-no-conflicts-before-stop`	Требует чистый merge с настроенной базовой веткой.
`require-ci-green-before-stop`	Требует успешного завершения проверок CI для текущего HEAD.

Справочник параметров

Настраивайте параметры в объекте policyParams выбранной области. Типы проверяются каждой политикой.

Политика	Параметр	Тип и значение по умолчанию
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; записи содержат `regex` и `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Ограничители инфраструктуры	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

Разрешающий шаблон расширяет допустимые действия агента. Протестируйте точную токенизацию и варианты команд на целевом обработчике перед развёртыванием на множестве машин.