aigis-sast 0.2.0

ИИ пишет код быстро. AigisSAST проверяет, что он не оставил дыр.

Security scanner for AI-generated code: finds what vibe coding leaves behind and explains how to fix it.

Зачем

Cursor, Copilot и ChatGPT собирают рабочий бэкенд за вечер. Но по пути они почти всегда оставляют одно и то же: токен бота прямо в коде, f"SELECT ... {user}", allow_origins=["*"], debug=True, открытый наружу Postgres. Код работает, тесты зелёные, а сервис уже можно взломать.

AigisSAST ловит именно эти ошибки и объясняет каждую простым языком: чем она опасна и как исправить, с готовым кодом. Без регистрации и облака, ничего не отправляет наружу (если сам не включишь --ai).

• Ноль зависимостей. Только стандартная библиотека Python, ставится за секунду.
• AST, а не grep. Python-код разбирается синтаксическим деревом, поэтому меньше ложных срабатываний.
• Секреты маскируются в отчёте: sk-p************, сам ключ в логах CI не светится.
• Не только ругается, но и чинит. aigis fix сам выносит ключи в .env и правит безопасные случаи.
• Видит прошлое. aigis history находит ключи, которые «удалили», но они остались в истории git.
• CI-ready. Exit-коды, SARIF для GitHub Code Scanning, JSON, Markdown, GitHub Action и pre-commit hook.

Быстрый старт

pip install git+https://github.com/jasperBLCK/AigisSAST
aigis scan .            # найти проблемы
aigis fix --dry-run     # посмотреть, что исправится автоматически
aigis fix               # исправить
aigis history           # проверить всю историю git на утёкшие ключи

Попробуй на заведомо дырявом примере:

git clone https://github.com/jasperBLCK/AigisSAST && cd AigisSAST
pip install . && aigis scan examples

Что ловит

Подробно про любое правило: aigis explain AIG010, полный список: aigis rules.

Использование

aigis scan .                              # текстовый отчёт с объяснениями
aigis scan src api --quiet                # несколько путей, без блоков «чем опасно / как исправить»
aigis scan . --min-severity medium        # скрыть LOW
aigis scan . --fail-on critical           # падать только на критичных
aigis scan . -f sarif -o aigis.sarif      # для GitHub Code Scanning
aigis scan . -f json | jq '.findings[]'   # для своих скриптов
aigis scan . -f markdown > SECURITY.md    # отчёт для PR / заказчика

В конце отчёта выводится security score (0–100) и оценка от A до F.

Исключения

eval(trusted_expr)  # aigis: ignore
DEBUG = True  # aigis: ignore[AIG014]

Файлы и папки исключаются через .aigisignore (glob-шаблоны) или флаг --exclude. node_modules, .venv, dist и lock-файлы пропускаются автоматически, а в git-репозитории ещё и всё из .gitignore.

Автоисправление: aigis fix

aigis fix --dry-run   # только показать diff
aigis fix             # применить

Исправляет только то, что можно поменять без риска сломать логику:

Нужные import os / import secrets добавляются сами. SQL-инъекции, eval, pickle, JWT и CORS автоматически не трогаются: там нужно понимать логику приложения, поэтому они остаются в списке «вручную».

Утёкшие ключи в истории: aigis history

$ aigis history
aigis history: секретов в истории git: 1

  [CRITICAL] AIG001  7312************  (Telegram bot token)
      bot.py  ·  коммит 402c92b от 2026-09-14  ·  удалён, но остался в истории

Удалить ключ новым коммитом мало: старая версия файла остаётся в истории, и её видит любой, кто склонировал репо. aigis history проходит по всем коммитам и веткам, показывает, где и когда ключ появился и есть ли он в коде сейчас. Ключи в отчёте замаскированы. Для CI: aigis history -f json, exit code 1, если что-то найдено.

Бейдж для README

aigis badge                # пишет aigis-badge.svg с оценкой, например «aigis | A 100/100»
aigis badge --url          # ссылка shields.io, без файла

AI-режим

export AIGIS_API_KEY=...                         # любой OpenAI-совместимый API
export AIGIS_BASE_URL=https://api.openai.com/v1  # или свой прокси / локальная LLM
export AIGIS_MODEL=gpt-4o-mini
aigis scan . --ai

Для каждой находки модель получает фрагмент кода вокруг неё и возвращает исправление именно под твой код. Находки с секретами (AIG001–AIG005) в модель никогда не отправляются. Если ключа нет или API недоступен, сканер предупредит об этом и покажет стандартные советы.

GitHub Actions

name: security
on: [push, pull_request]

jobs:
  aigis:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      security-events: write
    steps:
      - uses: actions/checkout@v4
      - uses: jasperBLCK/AigisSAST@v0.2.0
        with:
          fail-on: high

Находки появятся во вкладке Security → Code scanning и прямо в diff пулл-реквеста.

pre-commit

repos:
  - repo: https://github.com/jasperBLCK/AigisSAST
    rev: v0.2.0
    hooks:
      - id: aigis

Как устроено

aigis scan
   │
   ├── scanner      git ls-files → фильтры → .aigisignore → чтение файлов
   ├── checks/
   │    ├── python_ast   ast.NodeVisitor: SQL, shell, eval, pickle, JWT, CORS, debug, random, FastAPI auth
   │    └── text         regex: токены, ключи, DSN, конфиги, Dockerfile, compose, JS/TS
   ├── ai           (опционально) OpenAI-совместимый API, секреты отфильтрованы
   └── report       text · json · sarif · markdown  +  score / grade

aigis fix       AST-позиции находок → точечные правки → .env / .env.example / .gitignore
aigis history   git log -p --all → добавленные строки → те же детекторы секретов
aigis badge     score / grade → SVG или shields.io

Разработка:

python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
ruff check . && ruff format --check . && pytest -q

Roadmap

• Python AST-правила, секреты, конфиги, Dockerfile, compose, JS/TS
• SARIF, JSON, Markdown, GitHub Action, pre-commit
• AI-исправления через OpenAI-совместимый API
• aigis fix: автоматическое исправление безопасных случаев (вынос секретов в .env)
• aigis history: поиск секретов во всей истории git
• aigis badge: бейдж с оценкой безопасности
• Проверка зависимостей на известные CVE и тайпсквоттинг
• Правила для Django и Flask, Go и PHP
• VS Code extension

License

MIT