์—…๋ฐ์ดํŠธ๋กœ ๋Œ์•„๊ฐ€๊ธฐ
New releaseSep 10, 2026

pii-shield v2.2.3

์ฝ”๋“œ ์—†๋Š” K8s ์‚ฌ์ด๋“œ์นด๋กœ ๋กœ๊ทธ๋ฅผ ์ •ํ™”ํ•ฉ๋‹ˆ๋‹ค. ์—”ํŠธ๋กœํ”ผ ๋ถ„์„์„ ํ†ตํ•ด ๋น„๋ฐ€์„ ๊ฐ์ง€ํ•˜๊ณ , JSON ๋ฌด๊ฒฐ์„ฑ์„ ์œ ์ง€ํ•˜๋ฉฐ, PII๋ฅผ ๊ฒฐ์ •๋ก ์ ์œผ๋กœ ๊ฐ€๋ฆฝ๋‹ˆ๋‹ค. ๐Ÿ›ก๏ธ

๊ณต์œ 

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)

์นดํ…Œ๊ณ ๋ฆฌ