"""비밀값 가리기 — 오류 메시지·로그·원본 데이터(raw_data)에 인증정보가 남지 않게. 원칙은 "애초에 남기지 않는다"이고, 이 모듈은 그래도 섞여 들어올 수 있는 값을 걸러내는 마지막 방어선이다. - `redact_text(text, known_secrets)`: 문자열 안의 비밀값을 가린다. · 알고 있는 실제 비밀값(저장된 인증정보 원문)은 어디에 있든 통째로 치환 · "Authorization: ...", "Bearer ...", "Basic ...", 쿠키 · key=value / "key": "value" 형태에서 key 가 비밀 이름(password, secret, token …)인 값 · 길이 제한(기본 300자) - `redact_mapping(obj)`: dict/list 를 깊이 복사하며 비밀 이름 키의 값을 가린다. - `mask(value)`: 꼭 보여야 할 때 앞 4자 + **** + 뒤 4자(짧으면 전부 가림). """ from __future__ import annotations import re from typing import Any, Iterable MASK = "****" # 이름만 보고 비밀로 판단하는 키(대소문자 무시, 부분 일치). _SENSITIVE_NAME = re.compile( r"(pass(word|wd)?|pwd|secret|token|api[_\-]?key|access[_\-]?key|private[_\-]?key|" r"authorization|auth[_\-]?header|cookie|session|signature|credential|client[_\-]?secret|" r"refresh|bearer|x[_\-]?api)", re.IGNORECASE, ) # 헤더 이름 뒤의 "인증 방식 + 값" 한 덩어리(예: Bearer xxx, CEA algorithm=…, signature=…). _AUTH_HEADER = re.compile( r"(?i)\b(authorization|proxy-authorization)[\"']?\s*[:=]\s*[\"']?" r"(?:(?:bearer|basic|digest|cea|hmac\S*)\s+)?[^\s\"',;}\]]+" ) _BEARER = re.compile(r"(?i)\b(bearer|basic|cea)\s+[A-Za-z0-9._~+/=\-]{6,}") _COOKIE = re.compile(r"(?i)\b(set-cookie|cookie)\s*[:=]\s*[^\r\n]+") _KV = re.compile( r"""(?ix) (["']?) # 여는 따옴표(선택) ([A-Za-z0-9_\-\.]*? # 키 이름 (?:pass(?:word|wd)?|pwd|secret|token|api[_\-]?key|access[_\-]?key| private[_\-]?key|signature|credential|client[_\-]?secret|refresh) [A-Za-z0-9_\-\.]*) \1\s*[:=]\s* (["']?)([^"'&\s,;}\]]+)\3 """ ) DEFAULT_MAX_LEN = 300 def is_sensitive_name(name: str) -> bool: return bool(_SENSITIVE_NAME.search(name or "")) def mask(value: str | None) -> str: v = value or "" if len(v) < 12: return MASK return f"{v[:4]}{MASK}{v[-4:]}" def redact_text( text: Any, known_secrets: Iterable[str] = (), *, max_len: int = DEFAULT_MAX_LEN, ) -> str: s = "" if text is None else str(text) for secret in sorted({x for x in known_secrets if x and len(x) >= 4}, key=len, reverse=True): s = s.replace(secret, MASK) s = _AUTH_HEADER.sub(lambda m: f"{m.group(1)}: {MASK}", s) s = _COOKIE.sub(lambda m: f"{m.group(1)}: {MASK}", s) s = _BEARER.sub(lambda m: f"{m.group(1)} {MASK}", s) s = _KV.sub(lambda m: f"{m.group(1)}{m.group(2)}{m.group(1)}={MASK}", s) if max_len and len(s) > max_len: s = s[:max_len] + "…" return s def redact_mapping(obj: Any, known_secrets: Iterable[str] = ()) -> Any: secrets = tuple(known_secrets) if isinstance(obj, dict): out: dict[str, Any] = {} for k, v in obj.items(): if is_sensitive_name(str(k)): out[k] = MASK else: out[k] = redact_mapping(v, secrets) return out if isinstance(obj, (list, tuple)): return [redact_mapping(v, secrets) for v in obj] if isinstance(obj, str): return redact_text(obj, secrets, max_len=0) if secrets else obj return obj