위키득계정 ↗
기술

Gitleaks

Gitleaks기술
주요 대상
Git 기록과 파일
입력 모드
git과 dir 및 stdin
주요 결과
비밀정보 후보 보고서
관리 기능
규칙 설정과 기준선
Gitleaks는 Git 기록과 파일, 표준 입력에서 비밀번호와 API 키 같은 비밀정보 후보를 탐지하는 도구다. 탐지 규칙과 기준선, 보고서 형식을 설정해 저장소의 유출 검사를 구성할 수 있다.

기록과 현재 파일의 차이

현재 파일에서 삭제한 문자열도 과거 커밋에는 남아 있을 수 있다. Gitleaks는 Git 모드에서 커밋 패치를 검사하고 디렉터리 모드에서는 파일과 디렉터리를 대상으로 한다. 표준 입력으로 전달한 데이터도 검사할 수 있으므로 무엇을 입력으로 선택했는지에 따라 탐지 범위가 달라진다.

기준선으로 결과 구분

기존 보고서를 기준선으로 지정하면 이미 기록된 항목과 새로 발견한 항목을 구분할 수 있다. 탐지 규칙과 출력 형식을 설정하고 JSON과 CSV, SARIF 등의 보고서를 생성한다. 기준선에 있다는 사실이 해당 자격 증명이 안전하거나 폐기됐다는 의미는 아니다.

개발 흐름과 유지보수

커밋 전 훅이나 GitHub Action에 연결하는 구성을 제공한다. 공식 저장소는 기능 개발을 완료한 상태로 설명하며 후속 릴리스를 보안 패치 중심으로 제한한다고 안내한다. 탐지된 항목의 실제 성격과 영향 범위를 검토하고 필요한 대응을 수행하는 과정은 검사 결과와 별도로 남는다.

관련 문서

Detect-secrets / TruffleHog / Pre-commit / Lefthook / Semgrep