Gitleaks

소개

Gitleaks는 오픈소스 시크릿 스캐너로, Git 저장소, 파일, 디렉터리에서 노출된 비밀번호, API 키, 토큰 등을 탐지합니다.

핵심 기능

• Git 저장소 및 로컬 파일·디렉터리 스캔
• 비밀번호, API 키, 토큰 등 다양한 시크릿 패턴 탐지
• 스캔 결과를 구조화된 보고서로 생성 (JSON, CSV 등)
• 프리커밋 훅 또는 GitHub Action (Gitleaks‑Action)으로 통합 가능

지원 환경

• 운영 체제: Windows, macOS, Linux
• 필수 사양: Git 설치, 약 50MB의 여유 디스크 공간

기본 사용법

1. 공식 GitHub 저장소에서 최신 릴리스를 다운로드하고 압축 해제
2. 명령 프롬프트에서 gitleaks detect –source 실행하여 스캔 시작
3. 스캔 결과는 기본적으로 콘솔에 출력되며, –report-format json –report-path result.json 옵션으로 파일 저장 가능
4. 프리커밋 훅으로 사용하려면 .gitleaks.toml 설정 파일을 저장소에 추가하고 pre‑commit 프레임워크에 등록

제한 사항 및 체크포인트

• Git이 설치되어 있어야 저장소 스캔이 가능합니다.
• 조직 계정의 GitHub 저장소를 스캔하려면 라이선스 키가 필요할 수 있습니다.
• 대규모 저장소나 많은 파일을 스캔할 경우 처리 시간이 늘어날 수 있습니다.
• 탐지 결과는 보안 검토의 보조 도구로 사용하며, 최종 판단은 개발자나 보안 담당자가 수행해야 합니다.

FAQ

Gitleaks는 무료인가요?

예. 개인 계정에서의 사용은 무료이며 오픈소스 라이선스로 제공됩니다.

스캔 결과를 다른 도구와 연동할 수 있나요?

네. JSON 또는 CSV 형식으로 내보내기를 지원하여 기타 감사·보안 도구와 통합할 수 있습니다.

Windows에서 어떻게 설치하나요?

GitHub releases 페이지에서 Windows용 바이너리를 받아 압축을 풀고 PATH에 추가하거나 winget을 통해 설치할 수 있습니다.