Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
pii-shield — 코드 없는 K8s 사이드카로 로그를 정화합니다. 엔트로피 분석을 통해 비밀을 감지하고, JSON 무결성을 유지하며, PII를 결정론적으로 가립니다. 🛡️ | Kitploit
도구/GitHubGitHub/pii-shield/pii-shield
Container SecurityData ExfiltrationCloud SecurityDevSecOpsPrivacySecret DetectionLog Analysis
GitHubpii-shield/pii-shield

pii-shield

코드 없는 K8s 사이드카로 로그를 정화합니다. 엔트로피 분석을 통해 비밀을 감지하고, JSON 무결성을 유지하며, PII를 결정론적으로 가립니다. 🛡️

저장소 보기
16310733일 전Kitploit 검토 완료
공유
웹사이트

PII-Shield 🛡️

Kubernetes를 위한 제로 코드 로그 정제 사이드카. 로그가 파드(pod)를 떠나기 전에 PII를 마스킹하여 데이터 유출(GDPR/SOC2)을 방지합니다.

PII-Shield는 인프로세스(in-process)로 실행됩니다 — CLI, 사이드카 또는 WASM. 호스팅 API도 없고, 데이터가 전송되는 서버도 없습니다.

같은 이름, 다른 프로젝트. 이 프로젝트는 Microsoft 개발자 커뮤니티 블로그(2026년 5월, vikasgautam18/pii-shield)의 PII Shield 프라이버시 프록시가 아니며, piishield.ai 또는 piishield.com의 프롬프트 마스킹 제품도 아니고, Intellirim의 PyPI pii-shield 패키지도 아닙니다. 저희 패키지는 PyPI의 pii-shield-wasi와 npm의 @aragossa/pii-shield-wasi이며, 본문에서는 이 프로젝트를 PII-Shield 사이드카라고 부릅니다.

Release License Docker Pulls Artifact Hub
OpenSSF Best Practices Go Report Card Test Coverage Sponsor

"PII가 AI 모델을 오염시키지 않도록 하세요." PII-Shield는 민감한 데이터가 학습 데이터셋에 절대 도달하지 않도록 보장하여, GDPR로 인한 모델 재학습을 피할 수 있게 해줍니다.

[!WARNING] v2.0.0으로 업그레이드하시나요? 최종 사용자 배포 방식을 Helm 기반 설치와 Distroless 네이티브 사이드카로 전환했습니다. Kustomize는 더 이상 프로덕션 사용자를 위한 지원되는 릴리스 설치 경로가 아니지만, 운영자(operator) 저장소는 로컬 개발 및 매니페스트 생성을 위해 Kustomize 스캐폴딩을 여전히 유지합니다. PII-Shield 사이드카 내부의 /bin/sh 접근은 더 이상 지원되지 않습니다. 마이그레이션 가이드를 읽어보세요.

두 가지 배포 모델

PII-Shield는 스택에 통합하는 두 가지 방식을 제공합니다:

  1. Kubernetes Operator (제로 코드): 대표 배포 모델입니다. 고도로 안전한 Distroless 사이드카를 파드에 주입하여 로그를 실시간으로 가로채고 정제하는 완전 자동화된 K8s Operator입니다.
  2. 인프로세스 WASM (핵심 통합용): 극한의 성능을 위해 코어 엔진을 WASM을 통해 직접 임베드할 수 있으며, 네트워크 홉 없이 <1ms 지연 시간을 제공합니다.

프로젝트 상태 및 로드맵

PII-Shield는 프로덕션 강화 단계에 있는 활발히 개발 중인 오픈소스 보안 도구입니다. v2.x 릴리스 라인은 사용 가능한 CLI, 컨테이너, Helm/operator, WASM SDK 아티팩트를 제공합니다. 핵심 마스킹 경로는 통제된 배포에 사용할 준비가 되어 있으나, 일부 Kubernetes 배포 모드와 공급망 보장은 아직 안정화 중입니다.

구성 요소상태
코어 스캐너릴리스됨 / 통제된 배포
CLI 사이드카릴리스됨 / 통제된 배포
Kubernetes operator안정화 단계
WASM SDK릴리스된 베타
Proxy-Wasm 게이트웨이 통합계획된 R&D
규칙 서버 (중앙 규칙, 패널)첫 버전, 셀프 호스팅 이미지
eBPF 감사 에이전트 (stdout/stderr 관찰, 마스킹은 하지 않음)실험적, docs/ebpf-audit.md 참조

현재 프로덕션 강화 경계에 대해서는 KNOWN_LIMITATIONS.md를 참조하세요.

PII-Shield를 사용하는 이유

개발자들은 종종 민감한 데이터를 마스킹하는 것을 잊습니다. Fluentd/Logstash의 전통적인 정규식 필터는 느리고 유지 관리가 어려우며, 로그 수집기에서 값비싼 CPU를 소비합니다.

PII-Shield는 앱 컨테이너 바로 옆에 위치합니다:

  • 프로덕션 수준으로 강화된 Core Engine: 핫 경로에서의 낮은 메모리 할당과 결정론적 정규식 매칭에 최적화되어 Kubernetes 사이드카에 적합합니다.
  • 컨텍스트 인식 엔트로피 분석: 컨텍스트 키워드를 분석하여 키가 없는 고엔트로피 시크릿(예: Error: ... 44saCk9...)도 탐지합니다.
  • 사용자 정의 정규식 규칙: 알려진 패턴에 대해서는 엔트로피 검사를 재정의하는 구조화된 데이터(UUID, ID)에 대한 결정론적 마스킹을 제공합니다.
  • 내장 시크릿 시그니처: 발급자 접두사가 붙은 자격 증명 — AWS 및 Google API 키, GitHub, Slack 및 Stripe 토큰, JWT, Bearer 자격 증명, PEM 개인 키 블록 — 은 형식에 따라 마스킹되므로, 본문의 엔트로피가 낮거나 임계값이 높아진 경우에도 유효한 키가 탐지됩니다.
  • 형태 기반 전화번호: +가 붙은 국제 번호, 북미 형식 (555) 234-5678, 그리고 전화 관련 이름의 키(phone, mobile, wa_id, ...) 아래의 숫자는 숫자만으로는 시크릿으로 판정되지 않음에도 불구하고 숨겨집니다.
  • 키 기반 신원 번호: 신원 문서를 나타내는 키(idNumber, national_id, ssn, passport_number, tax_id, ...) 아래의 숫자는 숨겨지지만, user_id 또는 order_id와 같은 레코드 id는 숨겨지지 않습니다.
  • 회귀 및 퍼즈 커버리지: 바이너리 쓰레기 데이터, JSON 중첩, 다국어 로그를 포함한 스트레스 케이스에 대해 테스트되었습니다.
  • 결정론적 해싱: 시크릿을 고유한 해시(예: [HIDDEN:a1b2c])로 대체하여, QA가 원본 데이터를 보지 않고도 오류를 상호 연관시킬 수 있습니다.
  • 드롭인: 코드 변경이 필요하지 않습니다. 모든 언어(Node, Python, Java, Go)에서 작동합니다.
  • 화이트리스트 지원: PII_SAFE_REGEX_LIST를 사용하여 안전한 패턴(예: git 해시, 시스템 ID)을 명시적으로 허용해 오탐을 방지합니다.

수십 개의 클러스터에서 PII-Shield를 관리하시나요?

규칙 서버는 규칙 세트를 한 곳에 유지합니다: 보안 팀이 브라우저에서 세트를 편집하고, 실제 스캐너에서 초안이 붙여넣은 로그 라인에 어떤 영향을 주는지 확인하고, 버전을 게시하면, 해당 세트를 지정한 PiiPolicy를 가진 모든 클러스터가 읽기 전용 토큰으로, 파드 재시작 없이 이를 가져옵니다. 클러스터가 통계 채널을 켜지 않는 한 클러스터에 관한 어떤 것도 전송되지 않으며, 이 채널은 카운터만 전송합니다. 자체 경계 내에서 사용할 수 있도록 ghcr.io/pii-shield/pii-shield-rules 이미지로 제공되며, 자세한 내용은 docs/rules-server.md를 참조하세요. 게시물은 게시자만 보유한 키로 서명할 수 있고, 모든 변경은 활동 로그에 기록되며, 선택적 통계 채널은 클러스터별로 어떤 규칙 버전이 실행 중인지와 얼마나 많은 값이 숨겨졌는지를 카운터로만 보여줍니다. SQLite에서 실행되며, 여러 인스턴스의 경우 Postgres에서도 실행됩니다. deploy/rules-server는 HTTPS와 지속적 백업을 갖춘 단일 머신에서 이를 실행합니다.

통합

PII-Shield의 인프로세스 WASM 빌드는 오픈소스 AI 코드 거버넌스 GitHub Action인 GuardSpine Code에 포함되어 제공되며, 이 Action은 바이너리를 벤더링하고 NOTICE에 이를 명시합니다.

성능 고려 사항

2026-10-25에 CLI가 stdin을 읽고 파일에 쓰는 방식으로, Apple M1 코어 1개(GOMAXPROCS=1), Go 1.27.3, 200,000줄 코퍼스, 5회 실행의 중앙값, 2.2.8 릴리스 이후의 main 기준으로 측정:

  • 텍스트 로그 (애플리케이션 및 syslog 스타일 라인, 평균 122바이트): 약 92,000줄/s, 10.7 MiB/s.
  • JSON 로그 (중첩 객체가 있는 구조화된 라인, 평균 161바이트): 약 90,000줄/s, 13.8 MiB/s. JSON 라인은 encoding/json이 아닌 따옴표 인식 토크나이저를 거치며, 핫 경로는 라인당 약 7회의 할당을 수행합니다.
  • nginx 액세스 로그 (평균 312바이트, 모든 라인에 User-Agent 포함): 약 53,000줄/s, 15.7 MiB/s. 이 형태는 스캐너가 처리하는 가장 느린 형태이므로, 로그가 이와 유사하다면 이에 맞춰 용량을 산정하세요.

새니타이저는 단일 스레드이므로 CPU 제한은 처리량 상한입니다(사이징 표는 docs/sidecar-failure-modes.md에 있습니다). 서버 코어는 보통 M1보다 느리므로 ./benchmark/run_benchmarks.sh로 자체 로그를 측정하십시오(아래 성능 벤치마크 참조). 깊게 중첩된 JSON은 재귀 제한으로 제한되므로 악의적인 줄이 스택을 고갈시킬 수 없습니다.

설치

Helm 차트 (Kubernetes Operator)

Kubernetes에서 PII-Shield를 배포하는 공식적이고 권장되는 방법은 완전 자동화된 Operator를 통하는 것입니다:

helm repo add pii-shield https://pii-shield.github.io/pii-shield/
helm repo update
helm install pii-shield-operator pii-shield/pii-shield-operator -n operator-system --create-namespace

이것은 코드나 Dockerfile 변경 없이 Pod에 고보안 distroless 사이드카를 자동으로 주입하는 PII-Shield Operator를 배포합니다.

Docker

Docker Hub 또는 GHCR에서 최신 경량 이미지를 받으세요:

docker pull thelisdeep/pii-shield:3.0.0
# OR from GitHub Container Registry (Enterprise):
docker pull ghcr.io/pii-shield/pii-shield:3.0.0

소스에서 빌드

소스 코드에서 직접 바이너리를 빌드할 수 있습니다:

go build -o pii-shield ./cmd/cleaner

Go 라이브러리

스캐너는 Go 프로그램 내부에서 실행될 수 있으며, 예를 들어 각 레코드가 기록되기 전에 리댁션하는 slog.Handler에서 사용할 수 있습니다. 표준 라이브러리만 필요합니다:

go get github.com/pii-shield/pii-shield/v3/pkg/scanner
import "github.com/pii-shield/pii-shield/v3/pkg/scanner"

clean := scanner.ScanAndRedact(line)         // one line
cleanText := scanner.ScanAndRedactText(text) // several lines, line endings kept

패키지는 로드 시 CLI와 동일한 PII_* 환경 변수를 읽습니다. v3.0.0부터 모듈 경로는 /v3로 끝납니다. v2.2.8부터 v2.3.1까지의 릴리스는 github.com/pii-shield/pii-shield/v2이며, v2.2.8 이전 릴리스는 메이저 버전 없이 경로를 선언하므로 go get에서 거부됩니다.

구성

환경 변수의 전체 목록은 CONFIGURATION.md를 참조하십시오. 여기에는 다음이 포함됩니다:

  • PII_SALT: 사용자 지정 HMAC salt (프로덕션 환경에서 필수).
  • PII_ADAPTIVE_THRESHOLD: 동적 엔트로피 기준선을 활성화합니다.
  • PII_DISABLE_BIGRAM_CHECK: 비영어 로그에 최적화합니다.
  • PII_CUSTOM_REGEX_LIST: 결정적 마스킹을 위한 사용자 지정 정규식 규칙.
  • PII_SAFE_REGEX_LIST: 무시할 정규식 규칙 화이트리스트 (일치 항목은 그대로 반환됨).
  • PII_MODE=audit: 드라이 런. 라인은 변경 없이 통과하며, 마스킹되었을 항목이 집계됩니다(piishield_audit_* 메트릭). 따라서 마스킹을 켜기 전에 실제 트래픽을 관찰할 수 있습니다.

엔트로피 민감도 표 (기본 임계값: 3.6)

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    916
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    558
  • 3

    redforge

    cybersecurity91/redforge

    브라우저 측 레드 팀 툴킷으로, 정찰, 페이로드 생성, 자격 증명 공격, 암호화, 인코딩 및 참여 보고를 위한 102개의 오프라인 도구를 제공합니다.

    370
  • 4

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    360
  • 5

    looking-glass

    anonghosty/looking-glass

    Shadowserver 보고서를 MongoDB로 수집하고 이를 대화형 지도, 분석, 발견 사항, 권고 및 경영진 대시보드로 재생하는 CSIRT 플랫폼입니다.

    317
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.

    289

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →