Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
trufflehog — 유출된 자격 증명을 찾고, 검증하고, 분석합니다. | Kitploit
도구/GitHubGitHub/trufflesecurity/trufflehog
Vulnerability ScannersDynamic Analysis (Sandboxing)Code AnalysisCloud SecurityDevSecOpsSecret DetectionThreat IntelligenceSupply Chain SecurityIncident ResponseDevSecOps #4위
27.4k2.5k30222시간 46분 전Kitploit 검토 완료
Secret Detection #2위
Supply Chain Security #19위
GitHubtrufflesecurity/trufflehog

trufflehog

유출된 자격 증명을 찾고, 검증하고, 분석합니다.

저장소 보기웹사이트

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    1.0k
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    593
  • 3

    looking-glass

    anonghosty/looking-glass

    Shadowserver 보고서를 MongoDB로 수집하고 이를 대화형 지도, 분석, 발견 사항, 권고 및 경영진 대시보드로 재생하는 CSIRT 플랫폼입니다.

    371
  • 4

    redforge

    cybersecurity91/redforge

    브라우저 측 레드 팀 툴킷으로, 정찰, 페이로드 생성, 자격 증명 공격, 암호화, 인코딩 및 참여 보고를 위한 102개의 오프라인 도구를 제공합니다.

    336
  • 5

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    326
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.

    322

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →
공유
<p align="center">
  <img alt="GoReleaser Logo" src="https://assets.kitploit.com/production/public/readmes/3815/31dbdb577b88b3a967e2c18f9b0f3d4a7031dafe7e392c51320178aba6352603.png" height="140" />
  <h2 align="center">TruffleHog</h2>
  <p align="center">유출된 자격 증명을 찾아냅니다.</p>
</p>

---

<div align="center">

[![Go Report Card](https://goreportcard.com/badge/github.com/trufflesecurity/trufflehog/v3)](https://goreportcard.com/report/github.com/trufflesecurity/trufflehog/v3)
[![License](https://img.shields.io/badge/license-AGPL--3.0-brightgreen)](/LICENSE)
[![Total Detectors](https://img.shields.io/github/directory-file-count/trufflesecurity/truffleHog/pkg/detectors?label=Total%20Detectors&type=dir)](/pkg/detectors)

</div>

---

# :mag_right: _현재 스캔 중_

<div align="center">

<img src="https://raw.githubusercontent.com/trufflesecurity/trufflehog/HEAD/assets/scanning_logos.svg">

**...그리고 더 많은 것들**

TruffleHog와 그 기능 및 역량에 대해 더 알아보려면 [제품 페이지](https://trufflesecurity.com/trufflehog?gclid=CjwKCAjwouexBhAuEiwAtW_Zx5IW87JNj97Ci7heFnA5ar6-DuNzT2Y5nIl9DuZ-FOUqx0Qg3vb9nxoClcEQAvD_BwE)를 방문하세요.

</div>

# :globe_with_meridians: TruffleHog Enterprise

**Git, Jira, Slack, Confluence, Microsoft Teams, Sharepoint(및 그 이상)** 에서 자격 증명을 지속적으로 모니터링하는 데 관심이 있으신가요? 도움이 될 수 있는 엔터프라이즈 제품이 있습니다! <https://trufflesecurity.com/trufflehog-enterprise>에서 자세히 알아보세요.

저희는 엔터프라이즈 제품의 수익을 전체 커뮤니티가 혜택을 받을 수 있는 더 많은 멋진 오픈 소스 프로젝트에 투자합니다.

</div>

# TruffleHog란 무엇인가 🐽

TruffleHog는 가장 강력한 시크릿 **탐색(Discovery), 분류(Classification), 검증(Validation),** 및 **분석(Analysis)** 도구입니다. 여기서 시크릿이란 머신이 다른 머신에 자신을 인증하기 위해 사용하는 자격 증명을 의미합니다. 여기에는 API 키, 데이터베이스 비밀번호, 개인 암호화 키 등이 포함됩니다.

## 탐색 🔍

TruffleHog는 Git, 채팅, 위키, 로그, API 테스트 플랫폼, 오브젝트 스토어, 파일 시스템 등 다양한 위치에서 시크릿을 찾을 수 있습니다.

## 분류 📁

TruffleHog는 800개 이상의 시크릿 유형을 분류하여 해당 시크릿이 속한 특정 ID로 매핑합니다. AWS 시크릿인가요? Stripe 시크릿인가요? Cloudflare 시크릿인가요? Postgres 비밀번호인가요? SSL 개인 키인가요? 때로는 보기만 해서는 구분하기 어렵기 때문에 TruffleHog는 발견한 모든 것을 분류합니다.

## 검증 ✅

TruffleHog는 분류할 수 있는 모든 시크릿에 대해 로그인을 시도하여 해당 시크릿이 유효한지 여부를 확인할 수 있습니다. 이 단계는 현재 활성화된 위험이 있는지 여부를 파악하는 데 매우 중요합니다.

## 분석 🔬

가장 흔히 유출되는 20여 가지 자격 증명 유형에 대해서는 시크릿이 로그인할 수 있는지 확인하기 위해 하나의 요청을 보내는 대신, TruffleHog는 시크릿에 대해 알아야 할 모든 것을 파악하기 위해 여러 요청을 보낼 수 있습니다. 누가 생성했나요? 어떤 리소스에 접근할 수 있나요? 해당 리소스에 어떤 권한을 가지고 있나요?

# :loudspeaker: 커뮤니티에 참여하세요

질문이 있으신가요? 피드백이 있으신가요? Slack 또는 Discord에 참여하여 저희와 함께하세요.

[Slack 커뮤니티](https://join.slack.com/t/trufflehog-community/shared_invite/zt-pw2qbi43-Aa86hkiimstfdKH9UCpPzQ)에 참여하세요

[Secret Scanning Discord](https://discord.gg/8Hzbrnkr7E)에 참여하세요

# :tv: 데모

![GitHub scanning demo](https://storage.googleapis.com/truffle-demos/non-interactive.svg)

```bash
docker run --rm -it -v "$PWD:/pwd" trufflesecurity/trufflehog:latest github --org=trufflesecurity
```

# :floppy_disk: 설치

다음과 같은 몇 가지 옵션이 있습니다:

### MacOS 사용자

```bash
brew install trufflehog
```

### Docker:

<sub><i>_다음 명령을 실행하기 전에 Docker 엔진이 실행 중인지 확인하세요:_</i></sub>

#### &nbsp;&nbsp;&nbsp;&nbsp;Unix

```bash
docker run --rm -it -v "$PWD:/pwd" trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
```

#### &nbsp;&nbsp;&nbsp;&nbsp;Windows 명령 프롬프트

```bash
docker run --rm -it -v "%cd:/=\%:/pwd" trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
```

#### &nbsp;&nbsp;&nbsp;&nbsp;Windows PowerShell

```bash
docker run --rm -it -v "${PWD}:/pwd" trufflesecurity/trufflehog github --repo https://github.com/trufflesecurity/test_keys
```

#### &nbsp;&nbsp;&nbsp;&nbsp;M1 및 M2 Mac

```bash
docker run --platform linux/arm64 --rm -it -v "$PWD:/pwd" trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
```

### 바이너리 릴리스

```bash
Download and unpack from https://github.com/trufflesecurity/trufflehog/releases
```

### 소스에서 컴파일

```bash
git clone https://github.com/trufflesecurity/trufflehog.git
cd trufflehog; go install
```

### 설치 스크립트 사용

```bash
curl -sSfL https://raw.githubusercontent.com/trufflesecurity/trufflehog/main/scripts/install.sh | sh -s -- -b /usr/local/bin
```

### 설치 스크립트 사용, 체크섬 서명 검증 (cosign이 설치되어 있어야 함)

```bash
curl -sSfL https://raw.githubusercontent.com/trufflesecurity/trufflehog/main/scripts/install.sh | sh -s -- -v -b /usr/local/bin
```

### 설치 스크립트를 사용하여 특정 버전 설치하기

```bash
curl -sSfL https://raw.githubusercontent.com/trufflesecurity/trufflehog/main/scripts/install.sh | sh -s -- -b /usr/local/bin <ReleaseTag like v3.56.0>
```

# :closed_lock_with_key: 아티팩트 검증

모든 아티팩트에 체크섬이 적용되며, 생성된 체크섬 파일은 cosign을 사용하여 서명됩니다.

서명을 검증하려면 다음 도구가 필요합니다:

- [Cosign](https://docs.sigstore.dev/cosign/system_config/installation/)

검증 단계는 다음과 같습니다:

1. 원하는 아티팩트 파일과 [releases](https://github.com/trufflesecurity/trufflehog/releases) 페이지에서 다음 파일들을 다운로드합니다.

   - trufflehog\_{version}\_checksums.txt
   - trufflehog\_{version}\_checksums.txt.pem
   - trufflehog\_{version}\_checksums.txt.sig

2. 서명을 검증합니다:

   ```shell
   cosign verify-blob <path to trufflehog_{version}_checksums.txt> \
   --certificate <path to trufflehog_{version}_checksums.txt.pem> \
   --signature <path to trufflehog_{version}_checksums.txt.sig> \
   --certificate-identity-regexp 'https://github\.com/trufflesecurity/trufflehog/\.github/workflows/.+' \
   --certificate-oidc-issuer "https://token.actions.githubusercontent.com"
   ```

3. 서명이 유효한 것으로 확인되면, 다운로드한 아티팩트와 SHA256 합계가 일치하는지 검증을 진행할 수 있습니다:

   ```shell
   sha256sum --ignore-missing -c trufflehog_{version}_checksums.txt
   ```

`{version}`을 다운로드한 파일의 버전으로 바꾸세요.

또는 설치 스크립트를 사용하는 경우 `-v` 옵션을 전달하여 서명 검증을 수행하세요.
이를 위해서는 설치 스크립트를 실행하기 전에 Cosign 바이너리가 설치되어 있어야 합니다.

# :rocket: 빠른 시작

## 1: 검증된 시크릿만 대상으로 저장소 스캔

명령:

```bash
trufflehog git https://github.com/trufflesecurity/test_keys --results=verified
```

예상 출력:

```
🐷🔑🐷  TruffleHog. Unearth your secrets. 🐷🔑🐷

Found verified result 🐷🔑
Detector Type: AWS
Decoder Type: PLAIN
Raw result: AKIAYVP4CIPPERUVIFXG
Line: 4
Commit: fbc14303ffbf8fb1c2c1914e8dda7d0121633aca
File: keys
Email: counter <[email protected]>
Repository: https://github.com/trufflesecurity/test_keys
Timestamp: 2022-06-16 10:17:40 -0700 PDT
...
```

## 2: 검증된 시크릿만을 대상으로 GitHub 조직 스캔하기

```bash
trufflehog github --org=trufflesecurity --results=verified
```

## 3: 아카이브된 리포지토리를 제외하고 GitHub 조직 스캔

```bash
trufflehog github --org=trufflesecurity --exclude-archived
```

## 4: 검증된 시크릿만을 대상으로 GitHub 리포지토리를 스캔하고 JSON 출력 얻기

명령:

```bash
trufflehog git https://github.com/trufflesecurity/test_keys --results=verified --json
```

예상 출력:

```
{"SourceMetadata":{"Data":{"Git":{"commit":"fbc14303ffbf8fb1c2c1914e8dda7d0121633aca","file":"keys","email":"counter \[email protected]\u003e","repository":"https://github.com/trufflesecurity/test_keys","timestamp":"2022-06-16 10:17:40 -0700 PDT","line":4}}},"SourceID":0,"SourceType":16,"SourceName":"trufflehog - git","DetectorType":2,"DetectorName":"AWS","DecoderName":"PLAIN","Verified":true,"Raw":"AKIAYVP4CIPPERUVIFXG","Redacted":"AKIAYVP4CIPPERUVIFXG","ExtraData":{"account":"595918472158","arn":"arn:aws:iam::595918472158:user/canarytokens.com@@mirux23ppyky6hx3l6vclmhnj","user_id":"AIDAYVP4CIPPJ5M54LRCY"},"StructuredData":null}
...
```

TruffleHog는 `--json` 대신 `--sarif`를 사용하여 [SARIF](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html)를 출력할 수도 있습니다. GitHub 코드 스캐닝은 SARIF를 기본적으로 이해하므로, 이를 업로드하면 풀 리퀘스트 diff와 리포지토리의 Security 탭에 발견 사항이 인라인으로 표시되며, 매 실행마다 동일한 발견 사항을 보고하는 대신 스캔 간에 발견 사항을 신규/수정됨으로 추적합니다. 업로드 방법은 아래의 [TruffleHog Github Action](#octocat-trufflehog-github-action) 섹션을 참조하세요. 다른 출력 형식과 달리 SARIF 결과는 전체 스캔 동안 메모리에 버퍼링되었다가 마지막에 기록된다는 점에 유의하세요. SARIF는 스트림이 아닌 단일 JSON 문서를 요구하기 때문입니다. 일반적인 스캔에는 문제없지만, 매우 많은 수의 결과를 생성하는 스캔은 그에 비례하여 더 많은 메모리를 사용합니다.

## 5: GitHub 리포지토리 + 해당 이슈 및 풀 리퀘스트 스캔

```bash
trufflehog github --repo=https://github.com/trufflesecurity/test_keys --issue-comments --pr-comments
```

## 6: 높은 신뢰도의 결과(검증됨 + 알 수 없음)를 위해 S3 버킷 스캔

```bash
trufflehog s3 --bucket=<bucket name> --results=verified,unknown
```

## 7: IAM 역할을 사용하여 S3 버킷 스캔

```bash
trufflehog s3 --role-arn=<iam role arn>
```

## 8: Docker에서 SSH 인증을 사용하여 Github Repo 스캔하기

```bash
docker run --rm -v "$HOME/.ssh:/root/.ssh:ro" trufflesecurity/trufflehog:latest git ssh://github.com/trufflesecurity/test_keys
```

## 9: 개별 파일 또는 디렉터리 스캔

```bash
trufflehog filesystem path/to/file1.txt path/to/file2.txt path/to/dir
```

## 10: 로컬 git 저장소 스캔

git 저장소를 클론합니다. 예를 들어 [test keys](https://github.com/trufflesecurity/trufflehog/blob/main/git%40github.com%3Atrufflesecurity/test_keys.git) 저장소입니다.
```bash
git clone [email protected]:trufflesecurity/test_keys.git
```

상위 디렉터리(git 저장소 외부)에서 trufflehog를 실행하세요.
```bash
trufflehog git file://test_keys --results=verified,unknown
```

로컬 스캔 시 악성 git config로부터 보호하기 위해(참조: CVE-2025-41390), TruffleHog는 스캔 전에 로컬 git 저장소를 임시 디렉터리로 복제합니다. 이는 [Git의 보안 모범 사례](https://git-scm.com/docs/git#_security)를 따릅니다. 저장소를 복제할 사용자 지정 경로를 지정하려면(임시 디렉터리 대신) `--clone-path` 플래그를 사용할 수 있습니다. 로컬 복제 과정을 건너뛰고 저장소를 직접 스캔하려면(신뢰할 수 있는 저장소에만 이렇게 하십시오) `--trust-local-git-config` 플래그를 사용할 수 있습니다.

## 11: 검증된 시크릿만 대상으로 GCS 버킷 스캔

```bash
trufflehog gcs --project-id=<project-ID> --cloud-environment --results=verified
```

## 12: 검증된 시크릿만을 대상으로 Docker 이미지 스캔

`--image` 플래그를 여러 번 사용하여 여러 이미지를 스캔하세요.

```bash
# to scan from a remote registry
trufflehog docker --image trufflesecurity/secrets --results=verified

# to scan from the local docker daemon
trufflehog docker --image docker://new_image:tag --results=verified

# to scan from an image saved as a tarball
trufflehog docker --image file://path_to_image.tar --results=verified
```

## 13: CI에서 스캔하기

`--since-commit` 플래그를 사람들이 병합하는 기본 브랜치(예: "main")로 설정하세요. `--branch` 플래그를 PR의 브랜치 이름(예: "feature-1")으로 설정하세요. 사용하는 CI/CD 플랫폼에 따라 이 값은 동적으로 가져올 수 있습니다(예: [Circle CI의 CIRCLE_BRANCH](https://circleci.com/docs/variables/) 및 [Travis CI의 TRAVIS_PULL_REQUEST_BRANCH](https://docs.travis-ci.com/user/environment-variables/)). CI/CD 워크플로 중에 저장소가 복제되고 대상 브랜치가 이미 체크아웃되어 있다면 `--branch HEAD`로 충분합니다. `--fail` 플래그는 유효한 자격 증명이 발견되면 183 오류 코드를 반환합니다.

```bash
trufflehog git file://. --since-commit main --branch feature-1 --results=verified,unknown --fail
```

## 14: Postman 워크스페이스 스캔

`--workspace-id`, `--collection-id`, `--environment` 플래그를 여러 번 사용하여 여러 대상을 스캔합니다.

```bash
trufflehog postman --token=<postman api token> --workspace-id=<workspace id>
```

## 15: Jenkins 서버 스캔

```bash
trufflehog jenkins --url https://jenkins.example.com --username admin --password admin
```

## 16: Elasticsearch 서버 스캔

### 로컬 클러스터 스캔

TruffleHog로 로컬 클러스터에 인증하는 방법에는 두 가지가 있습니다: (1) 사용자 이름과 비밀번호, (2) 서비스 토큰.

#### 사용자 이름과 비밀번호로 로컬 클러스터에 연결

```bash
trufflehog elasticsearch --nodes 192.168.14.3 192.168.14.4 --username truffle --password hog
```

#### 서비스 토큰으로 로컬 클러스터에 연결

```bash
trufflehog elasticsearch --nodes 192.168.14.3 192.168.14.4 --service-token ‘AAEWVaWM...Rva2VuaSDZ’
```

### Elastic Cloud 클러스터 스캔

Elastic Cloud의 클러스터를 스캔하려면 Cloud ID와 API 키가 필요합니다.

```bash
trufflehog elasticsearch \
  --cloud-id 'search-prod:dXMtY2Vx...YjM1ODNlOWFiZGRlNjI0NA==' \
  --api-key 'MlVtVjBZ...ZSYlduYnF1djh3NG5FQQ=='
```

## 17. GitHub 리포지토리에서 Cross Fork Object References 및 삭제된 커밋 스캔

다음 명령은 GitHub 리포지토리에서 삭제되고 숨겨진 커밋을 열거한 다음, 해당 커밋에서 시크릿을 스캔합니다. 이 기능은 알파 릴리스 기능입니다.

```bash
trufflehog github-experimental --repo https://github.com/<USER>/<REPO>.git --object-discovery
```

일반적인 TruffleHog 출력 외에도 `--object-discovery` 플래그는 새로운 `$HOME/.trufflehog` 디렉터리에 `valid_hidden.txt`와 `invalid.txt` 두 개의 파일을 생성합니다. 이 파일들은 커밋 열거 중 상태를 추적하는 데 사용되며, 사용자에게 모든 숨겨진 커밋과 삭제된 커밋의 전체 목록(`valid_hidden.txt`)을 제공하는 데에도 사용됩니다. 스캔 후 이 파일들을 자동으로 제거하려면 `--delete-cached-data` 플래그를 추가하세요.

**참고**: 이 방법을 사용하여 저장소의 모든 유효한 커밋을 열거하는 데는 저장소 크기에 따라 20분에서 몇 시간까지 걸립니다. 열거에 소요될 시간을 알 수 있도록 진행 표시줄을 추가했습니다. 실제 비밀 스캔은 매우 빠르게 실행됩니다.

Cross Fork Object References에 대한 자세한 내용은 [블로그 게시물을 읽어보세요](https://trufflesecurity.com/blog/anyone-can-access-deleted-and-private-repo-data-github).

## 18. Hugging Face 스캔

### Hugging Face 모델, 데이터셋, Space 또는 버킷 스캔

```bash
trufflehog huggingface \
    --model <model_id> \
    --dataset <dataset_id> \
    --space <space_id> \
    --bucket <bucket_id>
```

### Hugging Face 조직 또는 사용자에 속한 모든 모델, 데이터셋, 스페이스 및 버킷 스캔

```bash
trufflehog huggingface --org <orgname> --user <username>
```

(선택 사항) 조직 또는 사용자를 스캔할 때 `--skip-all-models`, `--skip-all-datasets`, `--skip-all-spaces`, `--skip-all-buckets`로 전체 리소스 클래스를 건너뛰거나, `--ignore-models <model_id>`, `--ignore-datasets <dataset_id>`, `--ignore-spaces <space_id>`, `--ignore-buckets <bucket_id>`로 특정 리소스를 건너뛸 수 있습니다.

### 토론 및 PR 댓글 스캔

```bash
trufflehog huggingface --model <model_id> --include-discussions --include-prs
```

## 19. stdin 입력 스캔

```bash
aws s3 cp s3://example/gzipped/data.gz - | gunzip -c | trufflehog stdin
```

# :question: FAQ

- `🐷🔑🐷  TruffleHog. Unearth your secrets. 🐷🔑🐷`만 보이고 프로그램이 종료되는데, 무슨 일인가요?
  - 시크릿이 탐지되지 않았다는 의미입니다
- GitHub 조직을 스캔할 때 스캔이 오래 걸리는 이유는 무엇인가요
  - 인증되지 않은 GitHub 스캔에는 속도 제한이 있습니다. 속도 제한을 개선하려면 개인 액세스 토큰과 함께 `--token` 플래그를 포함하세요
- 개인 키가 검증되었다고 하는데, 무슨 의미인가요?
  - 검증된 결과는 TruffleHog가 서비스의 API에 대해 자격 증명을 테스트하여 유효함을 확인했다는 의미입니다. 개인 키의 경우, 해당 키가 SSH 또는 SSL 인증에 실제로 사용될 수 있음을 확인한 것입니다. 자세한 내용은 Driftwood 블로그 게시물을 확인하세요 [블로그 게시물](https://trufflesecurity.com/blog/driftwood-know-if-private-keys-are-sensitive/)
- 특정 시크릿을 무시하는 쉬운 방법이 있나요?
  - 스캔한 소스가 [줄 번호를 지원](https://github.com/trufflesecurity/trufflehog/blob/d6375ba92172fd830abb4247cca15e3176448c5d/pkg/engine/engine.go#L358-L365)하는 경우, 시크릿이 포함된 줄에 `trufflehog:ignore` 주석을 추가하여 해당 시크릿을 무시할 수 있습니다.
- `trufflehog:ignore`가 포함된 시크릿을 찾을 수 있나요?
  - 해당 줄에 `trufflehog:ignore` 주석이 있어도 결과를 보고하려면 `--no-ignore-tag`를 전달하세요. 이는 이전에 수용된 발견 사항을 검토할 때 유용합니다.

# :newspaper: v3의 새로운 기능은 무엇인가요?

TruffleHog v3는 Go로 완전히 재작성되었으며 많은 새로운 강력한 기능을 갖추고 있습니다.

- **각 API에 대해 능동적 검증을 지원하는 700개 이상의 자격 증명 탐지기를 추가**했습니다.
- 또한 **GitHub, GitLab, Docker, 파일 시스템, S3, GCS, Circle CI 및 Travis CI 스캔에 대한 기본 지원**을 추가했습니다.
- [Driftwood](https://trufflesecurity.com/blog/driftwood) 기술을 사용하여 수백만 명의 GitHub 사용자 및 **수십억** 개의 TLS 인증서에 대해 **개인 키를 즉시 검증**합니다.
- 바이너리, 문서 및 기타 파일 형식 스캔
- GitHub Action 및 pre-commit 훅으로 사용 가능

## 자격 증명 검증이란 무엇인가요?

탐지된 모든 잠재적 자격 증명에 대해, 해당 자격 증명이 속한다고 판단되는 API에 대한 프로그래밍 방식 검증을 공들여 구현했습니다. 검증은 오탐을 제거하고 세 가지 결과 상태를 제공합니다:

- **verified**: API 테스트를 통해 자격 증명이 유효하고 활성 상태임이 확인됨
- **unverified**: 자격 증명이 탐지되었지만 유효함이 확인되지 않음 (유효하지 않거나, 만료되었거나, 검증이 비활성화되었을 수 있음)  
- **unknown**: 검증을 시도했지만 네트워크 또는 API 오류와 같은 오류로 인해 실패함

예를 들어, [AWS 자격 증명 탐지기](https://github.com/trufflesecurity/trufflehog/blob/main/pkg/detectors/aws/access_keys/accesskey.go)는 AWS 자격 증명이 활성 상태인지 검증하기 위해 AWS API에 대해 `GetCallerIdentity` API 호출을 수행합니다.

# :memo: 사용법

TruffleHog에는 스캔하고자 하는 각 데이터 소스에 대한 하위 명령이 있습니다:

- git
- github
- gitlab
- huggingface
- docker
- s3
- filesystem (파일 및 디렉터리)
- syslog
- circleci
- travisci
- gcs (Google Cloud Storage)
- postman
- jenkins
- elasticsearch
- stdin
- multi-scan

각 하위 명령에는 하위 명령에 제공되는 `--help` 플래그로 확인할 수 있는 옵션이 있을 수 있습니다:

```
$ trufflehog git --help
usage: TruffleHog [<flags>] <command> [<args> ...]

TruffleHog is a tool for finding credentials.


Flags:
  -h, --[no-]help                Show context-sensitive help (also try --help-long and --help-man).
      --log-level=0              Logging verbosity on a scale of 0 (info) to 5 (trace). Can be
                                 disabled with "-1".
      --[no-]profile             Enables profiling and sets a pprof and fgprof server on :18066.
  -j, --[no-]json                Output in JSON format.
      --[no-]json-legacy         Use the pre-v3.0 JSON format. Only works with git, gitlab,
                                 and github sources.
      --[no-]github-actions      Output in GitHub Actions format.
      --[no-]sarif               Output in SARIF format for upload to GitHub code scanning (e.g.
                                 via github/codeql-action/upload-sarif).
      --concurrency=12           Number of concurrent workers.
      --[no-]no-verification     Don't verify the results.
      --results=RESULTS          Specifies which type(s) of results to output: verified (confirmed
                                 valid by API), unknown (verification failed due to error),
                                 unverified (detected but not verified), filtered_unverified
                                 (unverified but would have been filtered out). Defaults to
                                 verified,unverified,unknown.
      --[no-]no-color            Disable colorized output
      --[no-]allow-verification-overlap
                                 Allow verification of similar credentials across detectors
      --[no-]filter-unverified   Only output first unverified result per chunk per detector if there
                                 are more than one results.
      --filter-entropy=FILTER-ENTROPY
                                 Filter unverified results with Shannon entropy. Start with 3.0.
      --config=CONFIG            Path to configuration file.
      --[no-]print-avg-detector-time
                                 Print the average time spent on each detector.
      --[no-]no-update           Don't check for updates.
      --[no-]fail                Exit with code 183 if results are found.
      --[no-]fail-on-scan-errors
                                 Exit with non-zero error code if an error occurs during the scan.
      --verifier=VERIFIER ...    Set custom verification endpoints.
      --[no-]custom-verifiers-only
                                 Only use custom verification endpoints.
      --detector-timeout=DETECTOR-TIMEOUT
                                 Maximum time to spend scanning chunks per detector (e.g., 30s).
      --archive-max-size=ARCHIVE-MAX-SIZE
                                 Maximum size of archive to scan. (Byte units eg. 512B, 2KB, 4MB)
      --archive-max-depth=ARCHIVE-MAX-DEPTH
                                 Maximum depth of archive to scan.
      --archive-timeout=ARCHIVE-TIMEOUT
                                 Maximum time to spend extracting an archive.
      --include-detectors="all"  Comma separated list of detector types to include. Protobuf name or
                                 IDs may be used, as well as ranges.
      --exclude-detectors=EXCLUDE-DETECTORS
                                 Comma separated list of detector types to exclude. Protobuf name
                                 or IDs may be used, as well as ranges. IDs defined here take
                                 precedence over the include list.
      --[no-]no-verification-cache
                                 Disable verification caching
      --[no-]force-skip-binaries
                                 Force skipping binaries.
      --[no-]force-skip-archives
                                 Force skipping archives.
      --[no-]skip-additional-refs
                                 Skip additional references.
      --user-agent-suffix=USER-AGENT-SUFFIX
                                 Suffix to add to User-Agent.
      --[no-]version             Show application version.

Commands:
help [<command>...]
    Show help.

git [<flags>] <uri>

    Find credentials in git repositories.

github [<flags>]
    Find credentials in GitHub repositories.

github-experimental --repo=REPO [<flags>]
    Run an experimental GitHub scan. Must specify at least one experimental sub-module to run:
    object-discovery.

gitlab --token=TOKEN [<flags>]
    Find credentials in GitLab repositories.

filesystem [<flags>] [<path>...]
    Find credentials in a filesystem.

s3 [<flags>]
    Find credentials in S3 buckets.

gcs [<flags>]
    Find credentials in GCS buckets.

syslog --format=FORMAT [<flags>]
    Scan syslog

circleci --token=TOKEN
    Scan CircleCI

docker [<flags>]
    Scan Docker Image


travisci --token=TOKEN
    Scan TravisCI

postman [<flags>]
    Scan Postman

elasticsearch [<flags>]
    Scan Elasticsearch

jenkins --url=URL [<flags>]
    Scan Jenkins

huggingface [<flags>]
    Find credentials in HuggingFace datasets, models, spaces and buckets.

stdin
    Find credentials from stdin.

multi-scan
    Find credentials in multiple sources defined in configuration.

json-enumerator [<path>...]
    Find credentials from a JSON enumerator input.

analyze
    Analyze API keys for fine-grained permissions information.
```

예를 들어, `git` 저장소를 스캔하려면 다음으로 시작하세요

```
trufflehog git https://github.com/trufflesecurity/trufflehog.git
```

## 구성

TruffleHog는 `--config` 플래그를 통해 제공되는 구성 파일에서 [사용자 정의 정규식 탐지기](#custom-regex-detector-alpha)와 여러 소스를 정의하는 것을 지원합니다.
정규식 탐지기는 모든 하위 명령과 함께 사용할 수 있지만, 구성에 정의된 소스는 `multi-scan` 하위 명령 전용입니다.

소스의 구성 형식은 Truffle Security의
[소스 구성 문서 페이지](https://trufflesecurity.com/docs/connect-sources)에서 확인할 수 있습니다.

GitHub 소스 구성 예시 및 [옵션 참조](https://docs.trufflesecurity.com/github#Fvm1I):

```yaml
sources:
- connection:
    '@type': type.googleapis.com/sources.GitHub
    repositories:
    - https://github.com/trufflesecurity/test_keys.git
    unauthenticated: {}
  name: example config scan
  type: SOURCE_TYPE_GITHUB
  verify: true
```

`sources` 키 아래에 여러 연결을 정의할 수 있으며(위 참조), TruffleHog는 모든 소스를 동시에 스캔합니다.

단일 소스에 대해서만 디버그 로그를 확인하려면 해당 소스에 `debug: true`를 추가하세요. 그러면 해당 소스는 모든 디버그 로그를 기록하고, 다른 모든 소스는 일반 로그 수준을 유지합니다. 이는 여러 소스 중 하나가 오작동할 때 유용합니다:

```yaml
sources:
- connection:
    '@type': type.googleapis.com/sources.GitHub
    repositories:
    - https://github.com/trufflesecurity/test_keys.git
    unauthenticated: {}
  name: example config scan
  type: SOURCE_TYPE_GITHUB
  debug: true
```

모든 소스에 대해 디버그 로그를 켜려면 대신 `--log-level=5`를 사용하세요.

## S3

S3 소스는 IAM 사용자 외에도 스캔을 위한 IAM 역할 수임(assume)을 지원합니다. 이를 통해 사용자는 각 계정에 대해 하드코딩된 자격 증명에 의존하지 않고도 여러 AWS 계정을 더 쉽게 스캔할 수 있습니다.

TruffleHog가 처음 사용하는 IAM 자격 증명은 수임할 각 IAM 역할의 [신뢰 정책](https://aws.amazon.com/blogs/security/how-to-use-trust-policies-with-iam-roles/)에서 주체(principal)로서 `AssumeRole` 권한을 가져야 합니다.

로컬에 설정된 자격 증명을 사용하거나, EC2 인스턴스에 있는 경우 인스턴스 메타데이터를 사용하여 특정 버킷을 스캔하려면:

```bash
trufflehog s3 --bucket=<bucket-name>
```

특정 버킷을 assumed role을 사용하여 스캔하려면:

```bash
trufflehog s3 --bucket=<bucket-name> --role-arn=<iam-role-arn>
```

여러 역할을 별도의 인수로 전달할 수 있습니다. 다음 명령은 각 역할이 S3 API에서 나열할 수 있는 권한을 가진 모든 버킷을 스캔하려고 시도합니다:

```bash
trufflehog s3 --role-arn=<iam-role-arn-1> --role-arn=<iam-role-arn-2>
```

### 스캔 범위를 특정 객체로 좁히기

대규모 버킷에는 아카이브, 미디어, 빌드 아티팩트처럼 스캔할 가치가 없는 데이터가 담겨 있는 경우가 많습니다. 두 가지 플래그 세트를 사용하면 이러한 객체를 스캔에서 제외할 수 있습니다. 두 플래그 모두 객체를 다운로드하기 전에 객체 키와 대조되므로, 건너뛴 객체에는 GET 요청 비용이 발생하지 않습니다.

하나 이상의 키 접두사 아래에 있는 객체만 스캔하려면:

```bash
trufflehog s3 --bucket=<bucket-name> --include-prefix=infra/ --include-prefix=services/
```

키 접두사 아래의 객체를 건너뜁니다:

```bash
trufflehog s3 --bucket=<bucket-name> --exclude-prefix=projects/archived/
```

두 접두사 플래그를 함께 사용하면 하위 트리를 스캔하면서 그중 한 부분을 제외할 수 있습니다. 제외 접두사와 일치하는 객체는 포함 접두사와도 일치하더라도 항상 건너뜁니다:

```bash
trufflehog s3 --bucket=<bucket-name> --include-prefix=src/ --exclude-prefix=src/vendor/
```

접두사는 glob이 아닌 리터럴로 매칭되며, 경로 경계에 국한되지 않습니다. `--include-prefix=log`는 `logs/app.txt`와 `logs-archive/app.txt` 모두와 매칭됩니다.

파일 확장자는 별도로 필터링됩니다. 앞에 점 없이 작성하세요:

```bash
trufflehog s3 --bucket=<bucket-name> --exclude-extension=zip --exclude-extension=mp4
```

```bash
trufflehog s3 --bucket=<bucket-name> --include-extension=tf --include-extension=yaml
```

접두사 플래그와 달리 `--include-extension`과 `--exclude-extension`은 함께 사용할 수 없습니다. 스캔할 확장자를 지정하는 것만으로 이미 다른 모든 확장자가 제외되기 때문입니다. 둘 다 사용하면 시작 시 실패합니다.

확장자 매칭은 대소문자를 구분하지 않으므로 `--exclude-extension=zip`은 `BACKUP.ZIP`도 건너뜁니다. `Makefile`처럼 확장자가 전혀 없는 키를 가진 객체는 어떤 항목과도 일치하지 않습니다. `--include-extension`이 설정된 경우에는 건너뛰고, `--exclude-extension`만 설정된 경우에는 유지됩니다.

`--include-extension`을 사용할 때 주의할 점이 두 가지 있습니다. 닷파일(dotfile)은 전체가 확장자로 간주되므로 `.env`의 확장자는 `env`이며, `env`를 빼놓은 포함 목록은 버킷의 모든 `.env` 파일을 건너뜁니다. `.env` 파일은 비밀이 흔히 위치하는 곳이므로, 건너뛸 의도가 아니라면 `--include-extension=env`를 추가하세요. 또한 마지막 확장자만 유효하므로 `backup.tar.gz`의 확장자는 `gz`입니다. `--exclude-extension=tar.gz`는 아무것도 일치하지 않지만 `--exclude-extension=gz`는 동작합니다.

---

[Read more](https://github.com/trufflesecurity/trufflehog)
도구 다운로드