trufflesecurity/trufflehog

어떤 프로젝트인가요?

핵심 기능

• 01Git, GitHub, GitLab, S3, GCS, Docker 이미지, 파일 시스템, Postman, Jenkins 등에서 검색
• 02800개가 넘는 비밀 정보 유형을 해당 서비스별로 분류
• 03관련 API로 자격 증명을 확인해 유효 여부 표시
• 04흔히 쓰이는 약 20가지 자격 증명 유형을 심층 분석해 권한과 리소스 확인
• 05일반 텍스트, JSON 또는 SARIF 형식으로 출력하며 GitHub Actions와 pre-commit 훅 지원

활용 사례

• 유출되기 전에 실수로 커밋한 키가 있는지 Git 저장소와 pull request 검색
• S3 또는 GCS 버킷의 설정 파일이나 데이터 파일에 저장된 자격 증명 확인
• --fail 플래그를 사용해 CI 파이프라인에서 비밀 정보 차단
• Docker 이미지 또는 Postman 워크스페이스에 포함된 자격 증명 감사

빠른 시작

1. 1

   Homebrew로 macOS에 설치

   brew install trufflehog
2. 2

   검증된 시크릿만 저장소에서 스캔

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

   검증된 시크릿만 GitHub 조직에서 스캔

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

사용 전 알아둘 점

• !AGPL-3.0에 따라 공개됩니다. 카피레프트 라이선스이므로 독점 제품에서의 사용이 제한될 수 있습니다.
• !github-experimental object discovery와 같은 일부 고급 기능은 알파 버전이며 변경될 수 있습니다.

토픽

자주 묻는 질문

trufflehog은(는) 무엇인가요?

Git, 클라우드 스토리지, 채팅 등에서 유출된 자격 증명을 찾고 아직 유효한지 확인하는 CLI입니다. TruffleHog는 Git 저장소, 채팅 및 위키 플랫폼, 로그, 오브젝트 스토리지, 파일 시스템, Docker 이미지 등 다양한 곳에서 API 키, 데이터베이스 비밀번호, 개인 키와 같은 비밀 정보를 찾아냅니다. 800개가 넘는 비밀 정보 유형을 해당 서비스별로 분류하므로, 일반 문자열도 AWS 키인지 Stripe 키인지 식별할 수 있습니다.

trufflehog은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

trufflehog은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

trufflehog은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. trufflehog의 마지막 커밋은 2026년 10월 19일입니다.

trufflehog은(는) 어디에 사용할 수 있나요?

유출되기 전에 실수로 커밋한 키가 있는지 Git 저장소와 pull request 검색 S3 또는 GCS 버킷의 설정 파일이나 데이터 파일에 저장된 자격 증명 확인 --fail 플래그를 사용해 CI 파이프라인에서 비밀 정보 차단 Docker 이미지 또는 Postman 워크스페이스에 포함된 자격 증명 감사

trufflehog는 어떻게 설치하나요?

Homebrew로 macOS에 설치: brew install trufflehog 검증된 시크릿만 저장소에서 스캔: trufflehog git https://github.com/trufflesecurity/test_keys --results=verified 검증된 시크릿만 GitHub 조직에서 스캔: trufflehog github --org=trufflesecurity --results=verified

trufflehog은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/trufflesecurity/trufflehog