Перейти к содержимому
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/trufflehogLinux, облака и контейнеры

trufflehog

⁨Auth/lab ref: TruffleHog secret scanning; verified secret types, git/cloud/CI sources, validation evidence, remediation workflow.⁩

v2026.11.13-21cd5683 установки+3 за 7 дней39 ЗвездыAGPL-3.0синхронизировано 10 часов назад

Установка

Ещё нет NotHoly CLI? Сначала установите её.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install aeondave/trufflehog

Пишет в ⁦~/.notholy/skills⁩ после проверки подписи и SHA-256.

ПодписьПодписано, ed25519
+cRzr+D4ov…cGFk4JDg==CLI проверяет SHA-256 и подпись, прежде чем записать хоть один файл.
Пакет290928e5…3059174f
290928e554ed…f7233059174f2 файла · ⁦3.6 KB⁩
ПроверкаНизкий1 замечание
  • Ссылки на внешние домены
Вся проверка
Источникgithub.com/AeonDave/malskill/tree/main/offensive-tools/vuln-scanners/trufflehog@21cd568

Эта запись еще не переведена на русский, поэтому показан текст на другом языке: English.

Secrets scanner with live credential verification — finds + validates real active secrets.

Quick Start

bash
# Scan local git repo
trufflehog git file://. --only-verified

# Scan GitHub repo
trufflehog git https://github.com/org/repo --only-verified

# Scan filesystem
trufflehog filesystem /path/to/project --only-verified

# JSON output
trufflehog git file://. --only-verified --json

Subcommands (Scan Sources)

Command Target
trufflehog git <url> Git repository (local or remote)
trufflehog github GitHub repos / org
trufflehog gitlab GitLab repositories
trufflehog filesystem <path> Files and directories
trufflehog s3 AWS S3 buckets
trufflehog docker Docker images
trufflehog gcs Google Cloud Storage
trufflehog circleci CircleCI pipelines
trufflehog jenkins Jenkins instances
trufflehog postman Postman collections
trufflehog elasticsearch Elasticsearch indices
trufflehog stdin Read from stdin

Core Flags

Flag Purpose
--only-verified Output only confirmed-valid secrets (low noise)
--no-verification Skip API verification, show all pattern matches
--results <types> Filter: verified,unknown,unverified (default: all)
--json JSON output
--branch <branch> Specific branch to scan
--since-commit <sha> Scan from commit SHA (CI delta scanning)
--max-depth <n> Limit git history depth
--concurrency <n> Concurrent workers (default: CPU count)
--max-decode-depth <n> Iterative decoding passes (catches base64-encoded secrets)
--include-paths <file> File with regex patterns for paths to include
--exclude-paths <file> File with regex patterns for paths to exclude
--exclude-globs <globs> Comma-separated glob patterns to exclude
--include-detectors <list> Enable specific detectors only
--exclude-detectors <list> Disable specific detectors
--config <file> Custom detector config file
--fail Exit non-zero when results found

Verification: The Key Differentiator

trufflehog actually tests if secrets work by calling the issuing service API:

Result Meaning
Verified Secret confirmed valid — active, real threat
Unknown Verification failed (network error / API unavailable)
Unverified Pattern matched but credential invalid/expired

No data is altered during verification. Only read-only auth checks.

bash
# CI/CD gate: only verified = real, active secrets
trufflehog git file://. --only-verified --fail
echo $?  # non-zero = live secrets found

# Show verified + unknown (be thorough)
trufflehog git file://. --results=verified,unknown --json

# Skip verification (fast pattern scan only)
trufflehog git file://. --no-verification --json

Common Workflows

bash
# Scan repo since last CI commit (delta scan)
trufflehog git file://. \
    --since-commit "$CI_COMMIT_BEFORE_SHA" \
    --only-verified --fail

# Scan specific branch
trufflehog git file://. --branch main --only-verified

# Limit to recent 500 commits
trufflehog git file://. --max-depth=500 --only-verified

# Full organization scan (GitHub)
trufflehog github --org=MyOrg \
    --token=$GITHUB_TOKEN \
    --include-members \
    --include-wikis \
    --issue-comments --pr-comments \
    --only-verified --json

# Docker image scan
trufflehog docker --image myapp:latest --only-verified

# S3 bucket scan
trufflehog s3 --bucket my-bucket --only-verified

# Decode base64 / encoded secrets
trufflehog filesystem . --max-decode-depth=3 --only-verified

# Exclude paths
trufflehog git file://. \
    --exclude-paths=exclude.txt \
    --exclude-globs="*.log,*.lock,vendor/*" \
    --only-verified

GitHub Actions

yaml
name: TruffleHog Secrets Scan
on: [push, pull_request]
jobs:
  trufflehog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: TruffleHog OSS
        uses: trufflesecurity/trufflehog@main
        with:
          path: ./
          base: ${{ github.event.repository.default_branch }}
          head: HEAD
          extra_args: --only-verified

Output Parsing (JSON)

bash
trufflehog git file://. --only-verified --json > findings.json

# Key fields in each finding:
# .DetectorName    - type of secret (aws, github, slack, etc.)
# .Verified        - true/false
# .Raw             - redacted secret value
# .SourceMetadata.Data.Git.File   - file path
# .SourceMetadata.Data.Git.Commit - commit SHA
# .SourceMetadata.Data.Git.Email  - author email

# Extract finding summary
cat findings.json | jq '{detector: .DetectorName, file: .SourceMetadata.Data.Git.File, commit: .SourceMetadata.Data.Git.Commit, verified: .Verified}'

# List unique secret types found
cat findings.json | jq -r '.DetectorName' | sort -u

# Only show verified with file+commit context
cat findings.json | jq 'select(.Verified == true) | {type: .DetectorName, file: .SourceMetadata.Data.Git.File, commit: .SourceMetadata.Data.Git.Commit}'

Resources

File When to load
references/custom-detectors.md Custom detector YAML config, verification endpoints, filtering strategy

Файлы этой версии

Права

ПравоЗаявленоНайдено проверкой
Читает файлыДаДа
Пишет файлыДаДа
Выполняет команды shellДаДа
Ходит в сетьДаДа
Использует коннекторыНетНет
Управляет браузеромНетНет

Замечания проверки

Проверено 13 нояб. 2026 г.

  1. ИнфоСсылка · Ссылки на внешние домены

Чистая проверка снижает риск, но не доказывает, что пакет безопасен. Читайте то, что ставите.

ВерсияОпубликованаКоммитSHA-256ПодписьИзменение прав
v2026.11.13-21cd56813 нояб. 2026 г.21cd568290928e5Подписана–

Спрашивайте обо всём, что позволяет ваш скоуп.

Создайте аккаунт, пополните баланс и задайте первый вопрос в чате или в терминале.

  1. 1/3

    Создайте аккаунт

    Личный или для компании. Позже можно перейти на аккаунт компании без потери баланса и ключей.

    ЛичныйКомпания
  2. 2/3

    Пополните баланс

    Картой. Оплата за токены, без подписки.

    $5.00минимальное пополнение
  3. 3/3

    Спрашивайте

    В чате, или установите CLI и выполните notholy login в терминале.

    $ notholy login