trufflesecurity/trufflehog
TruffleHog: 유출된 자격증명 찾고 검증하는 오픈소스 도구
원제 trufflesecurity/trufflehog
스타 29,086당일 +115Go
Key Point
개발팀이 코드 저장소나 협업 도구에 실수로 노출한 API 키·비밀번호를 조직 규모로 체계적으로 찾아 검증하고 관리해야 할 때 필수적인 도구다.
핵심 요약
- TruffleHog는 API 키, 데이터베이스 암호, 개인 암호화 키 등 800개 이상의 자격증명 유형을 탐지·분류·검증·분석하는 Go 기반 도구다.
- Git, Slack, 위키, 로그, API 테스트 플랫폼, S3, GCS, 파일시스템, Docker 이미지 등 다양한 소스에서 기밀정보를 발견할 수 있다.
- 탐지된 모든 자격증명에 대해 실제 서비스 API로 로그인을 시도해 활성 상태인지 검증하며, 검증 결과는 verified(유효함), unverified(확인 안 됨), unknown(오류) 세 가지로 분류된다.
- 가장 흔히 유출되는 20여 개 자격증명 유형에 대해서는 심화 분석을 수행해 생성자, 접근 가능한 리소스, 권한 정보까지 조사한다.
- GitHub, GitLab, 허깅페이스, Postman, Jenkins, Elasticsearch 등 특정 플랫폼별 전용 스캔 커맨드를 제공하며, CI/CD 파이프라인에 통합하거나 사전 커밋 훅으로도 사용할 수 있다.
- GitHub Action과 GitLab CI를 위한 공식 통합을 지원하고, SARIF 형식으로 결과를 내보내 GitHub 코드 스캔에 직접 연동할 수 있다.
- 정규식 기반 커스텀 감지기를 지원하며, 웹훅을 통한 검증도 가능하므로 자체 비즈니스 로직에 맞춘 기밀정보 탐지가 가능하다.
- 로컬 Git 저장소 스캔 시 악성 git 설정으로부터 보호하기 위해 임시 디렉토리로 복제 후 스캔하며, CVE-2025-41390 완화를 위해 `--clone-path` 또는 `--trust-local-git-config` 플래그를 제공한다.
- S3 스캔 시 IAM 역할 가정을 지원해 여러 AWS 계정을 하드코딩된 자격증명 없이 스캔할 수 있으며, S3 객체는 접두사·확장자 필터로 스캔 범위를 좁힐 수 있다.
- 종료 코드는 0(성공), 1(오류), 183(결과 발견, --fail 플래그 사용 시)으로 구분되며, GitHub Actions와 GitLab CI에서 얕은 복제(shallow clone)를 통해 스캔 시간을 단축할 수 있다.
- v3부터 700개 이상의 활성 검증 기능이 있는 자격증명 감지기를 추가했으며, Driftwood 기술로 프라이빗 키를 수백만 GitHub 사용자와 수십억 TLS 인증서 대비 즉시 검증한다.
- AGPL 3 라이선스로 배포되며, 엔터프라이즈 버전은 Git, Jira, Slack, Confluence, Microsoft Teams, SharePoint 등의 지속적인 모니터링을 제공한다.
저장소 보기 ↗github.com