---
title: "¤gitleaks ¤secretlint 시크릿린트 - 리포 보안 정보 삭제 정리"
url: "https://notes.junghanacs.com/notes/20250131T190035"
author: "Junghan Kim"
date: "2025-01-31T19:00:00+09:00"
lastmod: "2026-01-29T00:00:00+09:00"
tags: ["automation","bib","credential","security","textlint"]
description: "gitleaks와 secretlint로 저장소의 비밀정보를 검사하고 정리하는 노트이다."
---

> [!abstract] 이 노트에 대하여
> 
> secretlint와 gitleaks를 비교하며 저장소에 노출된 키와 인증정보를 어떻게 잡아낼지 정리한다. pre-commit 훅과 규칙 관리까지 포함된 보안 점검 실무 노트다.

## BIBLIOGRAPHY

- “Gitleaks/Gitleaks Find Secrets with Gitleaks 🔑.” 2026. <https://github.com/gitleaks/gitleaks>.
- “Secretlint.” n.d. Accessed July 17, 2025. <https://secretlint.github.io/>.
- “Secretlint/Secretlint.” 2025. <https://github.com/secretlint/secretlint>.

## 히스토리

-   [2026-01-21 Wed 22:25] gitleaks로 전환
-   [2025-07-21 Mon 09:41] 시크릿린트
-   [2025-01-31 Fri 19:00] proselint를 얼마나 다루었던가. [#린터: #교열 #텍스트린트 어떤 도구가 있는가](https://notes.junghanacs.com/notes/20230707T094200)

## 관련메타

-   [†#린터 #맞춤법 #린팅 #오류 #검사](https://notes.junghanacs.com/meta/20240123T173354)

### Secretlint

([“Secretlint” n.d.](https://notes.junghanacs.com/notes/20250131T190035#citeproc_bib_item_2))

#### Secretlint 🔑🛡️

-   [Secretlint](https://secretlint.github.io/)는 파일에 포함되어 있는 기밀 정보를 체크하는 Lint 규칙
-   구조는 textlint 와 매우 유사하며 모든 플러그인입니다.
-   기밀 정보는 공통 지식이 있으므로 preset 은 별도 준비하고 있다
-   개발을 위해 항상 사용하는 상황을 만들어
    -   [global pre-commit hooks](https://github.com/secretlint/secretlint#pre-commit-hook-globally)에서 어느 리포지토리의 커밋에서도 사용하고 있다
    -   항상 Lint 를 사용하면 새로운 규칙을 추가하는 동기 부여가됩니다.
-   바로 사용할 수 있는 상황을 만든다 <https://secretlint.github.io/>
-   사용하는 것이 아니면 퀄리티가 오르지 않는다
-   Find a linter tool on GitHub, similar to textlint, that detects and removes secret keys (credentials). 불필요하게 코드에 노출된 보안 키(secret key)나 인증정보(credential)를 자동으로...

### Secretlint/Secretlint

([“Secretlint/Secretlint” 2025](https://notes.junghanacs.com/notes/20250131T190035#citeproc_bib_item_3))

-   Pluggable linting tool to prevent committing credential.

## gitleaks/gitleaks Find secrets with Gitleaks 🔑

([“Gitleaks/Gitleaks Find Secrets with Gitleaks 🔑” 2026](https://notes.junghanacs.com/notes/20250131T190035#citeproc_bib_item_1))

Find secrets with Gitleaks 🔑

### 대화중에 지원되는 기능

[2026-01-29 Thu 12:05]

```markdown

● - Google API Key: 내장 지원
  - HTTP Token: 일반적인 토큰 패턴 내장
  - Service Account JSON: 내장 지원

  Pre-commit hook 설정 방법:
  1. pre-commit 프레임워크 사용 (권장)
  2. 직접 .git/hooks/pre-commit 스크립트 작성

  gitleaks의 pre-commit 통합은 매우 간단합니다. .pre-commit-config.yaml 파일을
  만들거나, 직접 git hook을 설정할 수 있습니다.

  하지만 NixOS 환경에서는 pre-commit 프레임워크보다 직접 hook 스크립트를
  작성하는 게 더 간단할 수 있습니다.

  결론:
  1. .secretlintrc.json 삭제 가능 - gitleaks가 더 많은 패턴을 내장 지원
  2. pre-commit hook은 선택사항 - 수동 실행도 충분히 효과적
  3. 필요시 .gitleaks.toml로 커스텀 설정 가능

  분석 결과:
  ┌──────────────────────────┬────────────────────────────┐
  │     secretlint 규칙      │     gitleaks 내장 지원     │
  ├──────────────────────────┼────────────────────────────┤
  │ Google API Key (AIza...) │ ✅ 내장                    │
  ├──────────────────────────┼────────────────────────────┤
  │ HTTP Token               │ ✅ 내장 (다양한 토큰 패턴) │
  ├──────────────────────────┼────────────────────────────┤
  │ Service Account JSON     │ ✅ 내장 (GCP credentials)  │
  └──────────────────────────┴────────────────────────────┘
  → .secretlintrc.json 삭제 가능 - gitleaks가 160+ 패턴 내장

  Pre-commit hook 옵션:

  # 방법 1: 직접 hook (간단)
  # .git/hooks/pre-commit

  # 방법 2: pre-commit 프레임워크
  # .pre-commit-config.yaml

  NixOS 환경에서는 수동 실행도 충분합니다 (gitleaks detect 커밋 전).
```

## Proselint

## 18:08 Secretlint

## 로그

### [|2025-07-21 Mon 09:43|](https://notes.junghanacs.com/journal/20250721T000000#2025-07-21-mon)

@user 시크릿린트