tillson/git-hound빠른 GitHub 정찰 도구. GitHub 전체에서 유출된 비밀을 스캔하며, 알려진 리포지토리 및 조직에 국한되지 않습니다. GitHub dorks를 지원합니다.
GitHound는 GitHub dork와 패턴 매칭, 컨텍스트 감지, 커밋 기록 분석을 결합하여 GitHub 전반에서 노출된 API 키, 비밀 및 자격 증명을 사냥합니다. GitHub dork를 GitHound에 입력하면 쿼리와 일치하는 모든 파일과 리포지토리에서 비밀을 스캔합니다. 일반적인 스캐너와 달리 GitHound는 GitHub의 Code Search API를 활용하여 소수의 타겟이 아닌 모든 공개 리포지토리에 대한 전체 가시성을 제공합니다. 자세한 내용은 관련 블로그 포스트에서 확인할 수 있습니다.
새로운 GitHound Explore 대시보드를 통해 실시간으로 검색 결과를 시각화하고 관리하세요. 지금 https://githoundexplore.com에서 무료로 시작하거나 --dashboard 플래그를 사용하세요. 로컬에 설치된 GitHound 또는 TruffleHog와 함께 사용하는 방법은 Wiki 페이지에서 확인하세요. 대시보드 없이도 GitHound를 계속 사용할 수 있다는 점을 기억하세요.
또한 GitHub Dorks 데이터베이스를 시작했습니다. 여기서 다양한 API 키워드에 대한 dork를 검색하고 새로운 dork에 대한 아이디어를 얻을 수 있습니다! https://githoundexplore.com/github-dorks에서 확인하세요.
🔍 글로벌 GitHub 검색 – Gist를 포함한 GitHub 전체에서 비밀 찾기
🔑 스마트 API 키 감지 – 정규식 + 엔트로피 + 컨텍스트 매칭
🕵️ 커밋 기록 발굴 – 삭제되거나 되돌려진 자격 증명 발견
🧮 적응형 점수 매기기 – 오탐지 필터링
🧰 Base64 디코딩 및 인코딩된 비밀 추출
💻 자동화 파이프라인을 위한 JSON 출력 및 사용자 정의 정규식 규칙
echo "AKIA" | git-hound 또는 git-hound --query "AKIA"
config.yml에 API 키가 설정되어 있는지 확인합니다../git-hound를 실행하여 테스트합니다 (올바른 디렉토리에 있는지 확인하세요!).설정:
GitHound는 주로 config.yml (현재 디렉토리 또는 $HOME/.githound/에 위치)을 사용하여 설정합니다. 예제는 config.example.yml을 참조하세요.
또는 환경 변수를 사용할 수 있으며, 이는 config.yml의 값을 재정의합니다:
GITHOUND_GITHUB_TOKEN: GitHub API 액세스 토큰을 설정합니다.GITHOUND_INSERT_KEY: --dashboard 기능을 위한 GitHoundExplore Insert Key를 설정합니다.GitHound는 Gitleaks 작성자가 유지 관리하는 API 키 정규식 데이터베이스를 활용합니다.
특정 서비스의 API 키 패턴을 알면 GitHub에서 해당 키를 검색할 수 있습니다. 그런 다음 사용자 정의 키 정규식과 일치하는 결과를 자체 스크립트로 파이프하여 서비스에 대해 API 키를 테스트하고 위험에 처한 계정을 식별할 수 있습니다.
echo "api.halcorp.biz" | githound --dig-files --dig-commits --many-results --rules halcorp-api-regexes.txt --results-only | python halapitester.py
향후 API 키 유출을 감지하기 위해 GitHub는 Push Token Scanning을 제공하여 API 키가 게시되는 즉시 감지합니다.
제 GitHound 주요 용도는 버그 바운티 프로그램의 민감한 정보를 찾는 것입니다. 높은 프로필 대상의 경우 --many-results 핵과 --languages 플래그가 100페이지 이상의 결과를 스크래핑하는 데 유용합니다.
echo "\"uberinternal.com\"" | githound --dig-files --dig-commits --many-results --languages common-languages.txt --threads 100
https://github.com/tillson/git-hound/blob/master/internal/app/keyword_scan.go GitHound는 Slack 및 AWS와 같은 일반 서비스에 대한 정확한 정규식과 컨텍스트에 민감한 일반 API 정규식의 조합으로 API 키를 찾습니다. 이는 "Authorization" 및 "API-Token"과 같은 키워드로 둘러싸인 API 키처럼 보이는 긴 문자열을 찾습니다. GitHound는 이것들을 오탐지로 가정한 다음 섀넌 엔트로피, 사전 단어 검사, 고유성 계산 및 인코딩 감지를 통해 그 진위를 증명합니다. 그런 다음 GitHound는 높은 확신을 가진 긍정 결과를 출력합니다. 비밀을 인코딩하는 파일의 경우 base64 문자열을 디코딩하고 인코딩된 문자열에서 API 키를 검색합니다.
사용 사례 및 방법론에 대한 자세한 내용은 이 블로그 포스트를 확인하세요.
GitHound는 패턴 매칭, 타겟팅된 쿼리 및 강력한 점수 시스템을 사용하여 GitHub에서 노출된 API 키를 쉽게 찾을 수 있습니다.
Usage:
-h, --help help for githound
--dashboard Stream results to web dashboard (see https://githoundexplore.com)
--all-results Print all results, even if they do not contain secrets
--api-debug Prints details about GitHub API requests and counts them.
--config-file string Supply the path to a config file.
--debug Enables verbose debug logging.
--dig-commits Dig through commit history to find more secrets (CPU intensive).
--dig-files Dig through the repo's files to find more secrets (CPU intensive).
--fast Skip file grepping and only return search preview
--json Print results in JSON format
--many-results Search >100 pages with filtering hack
--no-api-keys Don't search for generic API keys.
--no-files Don't search for interesting files.
--no-gists Don't search Gists
--no-keywords Don't search for built-in keywords
--no-repos Don't search repos
--no-scoring Don't use scoring to filter out false positives.
--otp-code string Github account 2FA token used for sign-in. (Only use if you have 2FA enabled on your account via authenticator app)
--pages int Maximum pages to search per query (default 100)
--profile Enable pprof profiling on localhost:6060
--profile-addr string Address to serve pprof profiles (default "localhost:6060")
--query string A query string (default: stdin)
--query-file string A file containing a list of subdomains (or other queries).
--results-only Only print match strings.
--rules string Path to a list of regexes or a GitLeaks rules folder. (default "rules/")
--search-type api Search interface (api or `ui`).
--threads int Threads to dig with (default 20)
launch.json에서 필요한 플래그를 args로 보냅니다. "args": [ "searchKeyword", "tillsongalloway.com", "--regex-file", "regexes.txt" ]
메인 폴더에서: go build .
Git-Hound의 Docker 이미지를 빌드하려면 다음 명령을 사용하세요:
docker build -t my-githound-container .
이 명령은 my-githound-container 태그로 Docker 이미지를 빌드합니다. 태그 이름은 원하는 대로 변경할 수 있습니다.
Git-Hound Docker 컨테이너를 실행하려면 Docker 볼륨을 통해 config.yaml 파일과 입력 파일(예: subdomains.txt)을 제공해야 합니다.
config.yaml 마운트호스트 머신의 알려진 위치에 config.yaml 파일을 배치합니다. 이 파일에는 GitHub 자격 증명을 포함한 Git-Hound 구성이 포함되어야 합니다.
config.yaml 예제:
# config.yaml
github_username: "your_username"
github_password: "your_password"
# Optional: GitHub TOTP seed
# github_totp_seed: "ABCDEF1234567890"
subdomains.txt와 같은 파일이 있는 경우 호스트 머신의 디렉토리에 배치합니다.
다음 명령을 사용하여 구성 및 입력 파일과 함께 컨테이너를 실행하세요:
docker run -v /path/to/config.yaml:/root/.githound/config.yaml -v $(pwd)/data:/data my-githound-container --subdomain-file /data/subdomains.txt
/path/to/config.yaml을 실제 config.yaml 파일의 경로로 바꾸세요. -v $(pwd)/data:/data 부분은 입력 파일(subdomains.txt)이 포함된 디렉토리를 컨테이너에 마운트합니다.