프로젝트 소개

## 개요 **Nginx Access Log Detections Mod**는 Nginx 접근 로그 분석을 위한 사전 구축된 SQL 탐지와 대화형 대시보드를 제공하는 Powerpipe 확장 모듈입니다. Powerpipe에 Tailpipe CLI(및 Nginx 플러그인)를 결합하면 로그 데이터를 수집하고, 보안 중심 벤치마크를 실행하며, 활동을 실시간으로 시각화할 수 있습니다. ## 주요 기능 - Tailpipe 파일 소스를 활용한 **로그 수집**(최근 7일 자동 백필 및 증분 업데이트) - 의심스러운 패턴, OWASP 관련 문제, 기타 보안 인사이트를 발견하는 **SQL 기반 탐지** - 활동 개요, 요청 추이, 벤치마크 결과를 위한 **사전 준비된 대시보드** - `powerpipe benchmark`를 통한 **명령줄 벤치마크**(빠른 터미널 기반 보고) - `http://localhost:9033`에서 대시보드를 호스팅하는 **로컬 서버**(`powerpipe server`) ## 시작하기 1. **Powerpipe 설치** (brew: `brew install turbot/tap/powerpipe`) 2. **모듈 설치**: ```sh mkdir dashboards && cd dashboards powerpipe mod install github.com/turbot/tailpipe-mod-nginx-access-log-detections ``` 3. **Tailpipe 및 Nginx 플러그인 설치**: ```sh brew install turbot/tap/tailpipe tailpipe plugin install nginx ``` 4. **로그 소스 구성** (예: `~/.tailpipe/config/nginx.tpc`): ```hcl partition "nginx_access_log" "test" { source "file" { paths = ["/path/to/nginx_access_logs"] file_layout = "%{DATA}.log" } } ``` 5. **로그 수집**: ```sh tailpipe collect nginx_access_log ``` 시작 날짜 또는 상대 시간을 지정하려면 `--from`을 사용하세요 (예: `T-60d`). 6. **대시보드 서버 시작**: ```sh powerpipe server ``` 브라우저에서 `http://localhost:9033`을 열어 대시보드를 탐색하세요. 7. **터미널에서 벤치마크 실행**: ```sh powerpipe benchmark list powerpipe benchmark run nginx_access_log_detections.benchmark.access_log_detections ``` ## 문서 및 리소스 - 대시보드: https://hub.powerpipe.io/mods/turbot/tailpipe-mod-nginx-access-log-detections/dashboards - 벤치마크 및 탐지: https://hub.powerpipe.io/mods/turbot/tailpipe-mod-nginx-access-log-detections/benchmarks - Tailpipe 문서: https://tailpipe.io/docs/reference/cli/collect ## 라이선스 및 기여 본 프로젝트는 Apache 2.0 라이선스에 따라 배포됩니다. GitHub 저장소를 통해 기여를 환영하며, 행동 강령이 제공됩니다. Slack(`#tailpipe` 및 `#powerpipe`)에서 커뮤니티에 참여하세요. ## 사용 사례 - 보안 팀은 Nginx 로그에서 이상 징후 요청 패턴이나 OWASP 위반을 빠르게 탐지할 수 있습니다. - 운영 팀은 사용자 정의 파이프라인을 구축하지 않고도 트래픽 추이와 성능 메트릭스를 모니터링할 수 있습니다. - 개발자는 로그 기반 알림을 CI/CD 또는 사고 대응 워크플로우에 통합할 수 있습니다. 본 모듈은 자체적으로 완결되어 로컬에서 실행되며, Powerpipe 및 Tailpipe 바이너리만 필요하므로 온프레미스 모니터링 환경에 적합합니다.