GitGuardian/ggshield

어떤 프로젝트인가요?

핵심 기능

• 01검증 절차를 통해 500가지 이상의 비밀 정보를 탐지합니다.
• 02파일, Git 저장소, Docker 이미지, PyPI 패키지를 검사합니다.
• 03pre-commit, pre-push, pre-receive Git 훅으로 실행합니다.
• 04GitHub Action과 CI/CD 연동을 지원합니다.
• 05AI 코딩 어시스턴트와의 상호작용을 검사하는 훅을 설치합니다.
• 06pip, pipx, Homebrew 또는 패키지를 통해 macOS, Linux, Windows에 설치할 수 있습니다.

활용 사례

• pre-commit 훅으로 비밀 정보가 저장소에 커밋되는 것을 차단합니다.
• 배포 전에 CI 파이프라인에서 유출된 자격 증명을 검사합니다.
• 기존 Git 기록이나 Docker 이미지에 하드코딩된 키가 있는지 점검합니다.
• AI 코딩 어시스턴트가 비밀 정보가 포함된 작업을 실행하지 못하도록 합니다.

빠른 시작

1. 1

   pipx로 ggshield를 설치합니다 (Python과 git 필요)

   pipx install ggshield
2. 2

   GitGuardian 서버에 인증합니다

   ggshield auth login
3. 3

   현재 디렉터리에서 시크릿을 검사합니다

   ggshield secret scan path -r .

사용 전 알아둘 점

• !검사하려면 GitGuardian 서버 인증이 필요하며, GitGuardian의 공개 API를 사용합니다.
• !PyPI에서 설치할 때는 지원 대상이며 지원 종료(EOL)되지 않은 버전의 Python과 git이 필요합니다.
• !macOS에서 1.54.0으로 업그레이드하면 ggshield-py 바이너리에 대한 Keychain 확인 메시지가 표시됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

ggshield은(는) 무엇인가요?

파일, Git 저장소, Docker 이미지, 패키지에서 500가지 이상의 하드코딩된 비밀 정보를 탐지하고 검증하는 CLI로, pre-commit 훅이나 CI에서 사용할 수 있습니다. ggshield는 API 키와 자격 증명 같은 하드코딩된 비밀 정보가 유출되기 전에 찾아내는 GitGuardian의 명령줄 도구입니다. 로컬 파일, Git 저장소, Docker 이미지, PyPI 패키지를 검사하며, 개발자 컴퓨터에서 실행하거나 CI 파이프라인에 포함할 수 있습니다.

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

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

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

활발히 유지보수 중. ggshield의 마지막 커밋은 2026년 11월 6일입니다.

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

pre-commit 훅으로 비밀 정보가 저장소에 커밋되는 것을 차단합니다. 배포 전에 CI 파이프라인에서 유출된 자격 증명을 검사합니다. 기존 Git 기록이나 Docker 이미지에 하드코딩된 키가 있는지 점검합니다. AI 코딩 어시스턴트가 비밀 정보가 포함된 작업을 실행하지 못하도록 합니다.

ggshield는 어떻게 설치하나요?

pipx로 ggshield를 설치합니다 (Python과 git 필요): pipx install ggshield GitGuardian 서버에 인증합니다: ggshield auth login 현재 디렉터리에서 시크릿을 검사합니다: ggshield secret scan path -r .

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

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