aigis-sast

Зачем

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.
• Ссылка на каждую находку. В выводе сразу кликабельная ссылка на файл и строку на GitHub/GitLab/Bitbucket, а history даёт ссылку на коммит.
• Русский и английский. Весь интерфейс, советы и отчёты на двух языках, язык берётся из системы или --lang.
• CI-ready. Exit-коды, SARIF для GitHub Code Scanning, JSON, Markdown, GitHub Action и pre-commit hook. aigis init подключает всё одной командой.

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

pip install aigis-sast
aigis help              # понятный обзор всех команд
aigis scan              # найти проблемы в текущей папке (или просто: aigis путь/к/проекту)
aigis fix --dry-run     # посмотреть, что исправится автоматически
aigis fix               # исправить
aigis history           # проверить всю историю git на утёкшие ключи
aigis init              # подключить проверку в GitHub Actions

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

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 / заказчика

Каждая находка в выводе выглядит так:

▌ app/config.py
   CRITICAL  AIG001  Токен или API-ключ прямо в коде (Telegram bot token)
           app/config.py:12
           ↗ https://github.com/you/bot/blob/3f2c1ab.../app/config.py#L12
           │ BOT_TOKEN = "7312************"
           чем опасно: ...
           как исправить: ...

Ссылка строится из git remote и текущего коммита, по ней можно сразу перейти к строке. Она есть и в JSON (url), и в Markdown. Если remote нет, ссылки просто не печатаются. В конце отчёта выводится сводка по уровням, оценка безопасности (0–100), грейд от A до F и находка, с которой стоит начать.

Язык

aigis scan --lang en      # или --lang ru
export AIGIS_LANG=en      # насовсем

По умолчанию язык берётся из системы (LANG, на Windows из языка ОС): на русской системе всё по-русски, иначе по-английски. Язык влияет на текст, JSON, Markdown, SARIF и подсказки AI-режима.

Исключения

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  ·  удалён, но остался в истории

Под каждой находкой печатается ссылка ↗ на коммит, где ключ появился. В JSON это поля commit_url и url.

Удалить ключ новым коммитом мало: старая версия файла остаётся в истории, и её видит любой, кто склонировал репо. 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

Быстрее всего одной командой:

aigis init     # создаст .github/workflows/aigis.yml и .aigisignore (существующие файлы не трогает)

Или вручную:

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.5.0
        with:
          fail-on: high
          lang: ru        # язык отчёта: ru или en

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

pre-commit

repos:
  - repo: https://github.com/jasperBLCK/AigisSAST
    rev: v0.5.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: бейдж с оценкой безопасности
• Кликабельные ссылки на строку и коммит прямо в выводе
• Интерфейс на русском и английском, aigis help, aigis init
• Проверка зависимостей на известные CVE и тайпсквоттинг
• Правила для Django и Flask, Go и PHP
• VS Code extension

License

MIT