#!/usr/bin/env python3 """하네스 플러그인 PostToolUse(Write·Edit·MultiEdit) 넛지 — N4 비밀 값 알림. 방금 쓴 내용에 비밀 값처럼 보이는 것이 있으면 모델에게 몇 줄 알린다. 막지 않는다(종료 코드 0). - 모양으로 아는 것: 개인 키 머리, AWS 접근 키, GitHub·GitLab·Slack 토큰, sk- API 키, Google API 키 - 값이 있는 대입: password·secret·token·api_key 같은 이름에 예시가 아닌 값(따옴표 안이거나 6자 이상) 값이 `example`·`dummy`·`changeme`·`${…}`·`<…>`처럼 예시나 참조이면 알리지 않는다. 알림에는 값의 앞 4자만 쓴다(값 전체를 컨텍스트에 다시 넣지 않는다). 시험: `python3 -m unittest discover -s plugins/harness/tests` """ import json import re import sys PATTERNS = [ ("개인 키", re.compile(r"-----BEGIN (?:[A-Z0-9]+ )*PRIVATE KEY-----")), ("AWS 접근 키", re.compile(r"\b(?:AKIA|ASIA)[0-9A-Z]{16}\b")), ("GitHub 토큰", re.compile(r"\b(?:gh[pousr]_[A-Za-z0-9]{36,}|github_pat_[A-Za-z0-9_]{60,})\b")), ("GitLab 토큰", re.compile(r"\bglpat-[A-Za-z0-9_-]{20,}")), ("Slack 토큰", re.compile(r"\bxox[abprs]-[A-Za-z0-9-]{10,}")), ("API 키(sk-)", re.compile(r"\bsk-(?:ant-|proj-)?[A-Za-z0-9_-]{32,}")), ("Google API 키", re.compile(r"\bAIza[0-9A-Za-z_-]{35}\b")), ] ASSIGN_RE = re.compile( r"(?i)\b([A-Za-z0-9_.-]*(?:password|passwd|secret|api[_-]?key|access[_-]?key|private[_-]?key|token))" r"\s*[:=]\s*(?:(['\"])([^'\"\n]{4,})\2|([^\s'\"#,;]{6,}))") PLACEHOLDER_RE = re.compile( r"(?i)example|dummy|sample|changeme|change-me|placeholder|your[-_ ]|xxx|\*\*\*|redacted|fake|test|" r"^(none|null|true|false|secret|password|token)$|localhost") REFERENCE_CHARS = set("$<>{}()[]%") MAX_LINES = 5 def written_text(tool_input): """도구 입력에서 새로 쓴 글만 모은다.""" parts = [tool_input.get("content"), tool_input.get("new_string")] parts += [e.get("new_string") for e in tool_input.get("edits") or [] if isinstance(e, dict)] return "\n".join(p for p in parts if isinstance(p, str)) def mask(value): return value[:4] + "…" if len(value) > 4 else "…" def findings(text): out = [] for line_no, line in enumerate(text.split("\n"), 1): for label, pattern in PATTERNS: m = pattern.search(line) if m and not PLACEHOLDER_RE.search(m.group(0)): out.append("%d줄: %s 모양 `%s`" % (line_no, label, mask(m.group(0)))) for m in ASSIGN_RE.finditer(line): value = m.group(3) or m.group(4) if value.isdigit() or REFERENCE_CHARS & set(value) or PLACEHOLDER_RE.search(value): continue out.append("%d줄: `%s`에 값 `%s`" % (line_no, m.group(1), mask(value))) return out def main(): data = json.load(sys.stdin) if data.get("tool_name") not in ("Write", "Edit", "MultiEdit"): return 0 tool_input = data.get("tool_input") or {} found = findings(written_text(tool_input)) if not found: return 0 path = tool_input.get("file_path", "") lines = ["[N4 비밀 값 알림] %s에 비밀 값처럼 보이는 것이 있다:" % path] + found[:MAX_LINES - 2] lines.append("진짜 값이면 지우고 환경 변수·비밀 저장소에서 읽는다. 예시 값이면 `example`·`dummy`로 표시한다.") print(json.dumps({"hookSpecificOutput": {"hookEventName": "PostToolUse", "additionalContext": "\n".join(lines)}}, ensure_ascii=False)) return 0 if __name__ == "__main__": try: sys.exit(main()) except Exception: # 넛지는 실패해도 작업을 막지 않는다 sys.exit(0)