"""② 쇼핑몰 API 인증정보 — 저장(암호화) / 화면용 요약 / 어댑터용 복호화 접근자 / 재암호화. 흐름: 설정 화면 입력 → 이 서비스(암호화) → perf_credentials(암호문) 어댑터 → CredentialAccessor.get() → 서버 안에서만 복호화 화면으로 돌려주는 값 - secret 항목: 값 있음/없음(has_value)만. 원문·일부·길이 모두 보내지 않는다. - 일반 항목(Vendor ID 등): 확인용으로 원문을 보여 준다(이것도 DB 에는 암호문). """ from __future__ import annotations from typing import Any, Callable from .adapters.base import MarketplaceAdapter from .security.crypto import KeyRing, decrypt, encrypt, needs_reencrypt def aad_for(code: str, key: str, ns: str = "") -> str: """암호문을 (쇼핑몰, 항목)에 묶는 추가 인증 데이터. ns = 이름 공간(광고 API 인증정보는 "ad:") — 쇼핑몰 암호문과 광고 암호문을 서로 바꿔 넣어도 복호화되지 않는다.""" return f"perf:{ns}{code}:{key}" class CredentialAccessor: """어댑터 전용 — 서버 안에서만 복호화. 값은 처음 꺼낼 때 한 번 복호화해 둔다.""" def __init__(self, store: Any, code: str, ring_loader: Callable[[], KeyRing], *, overrides: dict[str, str] | None = None, persist: bool = True, user: str = "", aad_ns: str = "", cleared: set[str] | None = None) -> None: self._store = store self._code = code self._ns = aad_ns self._ring_loader = ring_loader self._rows = store.credential_rows(code) if store is not None else {} self._cache: dict[str, str] = {} self._overrides = {k: v for k, v in (overrides or {}).items() if v} # 연결 테스트에서 화면 칸을 비운 항목 — 저장값이 있어도 빈 값으로(저장하지 않음) self._cleared = {k for k in (cleared or set()) if k not in self._overrides} self._persist = persist self._user = user def has(self, key: str) -> bool: if key in self._cleared: return False return bool(self._overrides.get(key)) or key in self._rows def get(self, key: str) -> str: if key in self._cleared: return "" if key in self._overrides: return self._overrides[key] if key in self._cache: return self._cache[key] row = self._rows.get(key) if not row: return "" value = decrypt(row["encrypted_value"], aad=aad_for(self._code, key, self._ns), ring=self._ring_loader()) self._cache[key] = value return value def set(self, key: str, value: str) -> None: """어댑터가 새로 받은 토큰 등을 저장. 테스트(persist=False)면 메모리에만.""" self._cache[key] = value if not self._persist or self._store is None: return ring = self._ring_loader() self._store.upsert_credential( self._code, key, encrypted_value=encrypt(value, aad=aad_for(self._code, key, self._ns), ring=ring), key_version=ring.current_version, user=self._user or "system", ) self._rows[key] = {"encrypted_value": "", "key_version": ring.current_version} def known_secrets(self) -> list[str]: """가리기(redact)용 — 지금까지 꺼낸 원문들.""" return [v for v in list(self._cache.values()) + list(self._overrides.values()) if v] class CredentialService: """store = 인증정보 저장소(쇼핑몰: PerformanceStore, 광고 API: db.AdCredentialTable). aad_ns = 암호문 이름 공간.""" def __init__(self, store: Any, ring_loader: Callable[[], KeyRing], *, aad_ns: str = "") -> None: self._store = store self._ring_loader = ring_loader self._ns = aad_ns def accessor(self, code: str, *, overrides: dict[str, str] | None = None, persist: bool = True, user: str = "", cleared: set[str] | None = None) -> CredentialAccessor: return CredentialAccessor(self._store, code, self._ring_loader, overrides=overrides, persist=persist, user=user, aad_ns=self._ns, cleared=cleared) # ── 화면용 요약(비밀 원문 없음) ───────────────────────── def describe(self, adapter: MarketplaceAdapter) -> dict[str, Any]: rows = self._store.credential_rows(adapter.code) fields = [] decrypt_error = "" for f in adapter.visible_fields(): row = rows.get(f.key) item: dict[str, Any] = { "key": f.key, "label": f.label, "secret": f.secret, "required": f.required, "help": f.help, "placeholder": f.placeholder, "has_value": row is not None, "multiline": bool(getattr(f, "multiline", False)), "updated_at": row["updated_at"].isoformat(timespec="seconds") if row and row.get("updated_at") else "", } if row is not None and not f.secret: try: item["value"] = decrypt(row["encrypted_value"], aad=aad_for(adapter.code, f.key, self._ns), ring=self._ring_loader()) except Exception as exc: # noqa: BLE001 — 키 없음/손상: 값 없이 안내만 item["value"] = "" decrypt_error = str(exc) if "환경변수" in str(exc) else "저장된 값을 복호화하지 못했습니다." fields.append(item) return {"fields": fields, "decrypt_error": decrypt_error, "configured": all(x["has_value"] for x in fields if x["required"])} def configured_codes(self, adapters: list[MarketplaceAdapter]) -> dict[str, bool]: keys = self._store.credential_keys_by_code() out = {} for a in adapters: if a.uses_shared_integration: out[a.code] = True continue have = keys.get(a.code, set()) required = [f.key for f in a.visible_fields() if f.required] out[a.code] = bool(required) and all(k in have for k in required) return out # ── 저장 ──────────────────────────────────────────────── def merged_values(self, adapter: MarketplaceAdapter, values: dict[str, str]) -> dict[str, str]: """검사용 — 새 입력 + (빈 칸은) 기존 값 존재 여부. 비밀 원문은 꺼내지 않고 표식만.""" rows = self._store.credential_rows(adapter.code) merged = {} for f in adapter.visible_fields(): v = (values.get(f.key) or "").strip() merged[f.key] = v if v else ("__stored__" if f.key in rows else "") return merged def save(self, adapter: MarketplaceAdapter, values: dict[str, str], *, clear: list[str] | None = None, user: str = "") -> list[str]: """빈 칸 = 기존 값 유지. clear 에 든 항목은 삭제. 저장한 항목 키 목록 반환.""" allowed = {f.key for f in adapter.visible_fields()} ring = self._ring_loader() rows = self._store.credential_rows(adapter.code) saved = [] changed = False # 화면 항목이 실제로 바뀌었나 — 바뀌었으면 그 인증정보로 받은 토큰 등 내부 값을 지운다(F04) for key, raw in values.items(): if key not in allowed: continue v = (raw or "").strip() if not v: continue if not changed and self._stored_value(adapter.code, key, rows) != v: changed = True self._store.upsert_credential( adapter.code, key, encrypted_value=encrypt(v, aad=aad_for(adapter.code, key, self._ns), ring=ring), key_version=ring.current_version, user=user, ) saved.append(key) for key in clear or []: if key in allowed and key not in saved: if key in rows: changed = True self._store.delete_credential(adapter.code, key) if changed: # 계정·키가 바뀌면 예전 계정으로 받은 토큰·만료 시각을 남기지 않는다. 같은 값을 다시 저장했으면 그대로 둔다 # (토큰을 불필요하게 다시 받지 않게). 어댑터도 토큰을 발급 인증정보 지문에 묶어 한 번 더 막는다. for f in adapter.credential_fields(): if f.internal and f.key in rows: self._store.delete_credential(adapter.code, f.key) return saved def _stored_value(self, code: str, key: str, rows: dict[str, Any]) -> str | None: """저장된 값 원문(서버 안에서만, 비교용) — 없거나 복호화할 수 없으면 None(= 바뀐 것으로 본다).""" row = rows.get(key) if not row: return None try: return decrypt(row["encrypted_value"], aad=aad_for(code, key, self._ns), ring=self._ring_loader()) except Exception: # noqa: BLE001 — 키 교체·손상 등: 비교할 수 없으니 바뀐 것으로 return None # ── 마스터 키 교체 후 재암호화 ───────────────────────── def reencrypt_all(self) -> dict[str, int]: """예전 키 버전으로 된 암호문을 현재 키로 다시 암호화. (재암호화 수, 실패 수).""" ring = self._ring_loader() done = failed = 0 for row in self._store.all_credential_rows(): token = row["encrypted_value"] if not needs_reencrypt(token, ring): continue code, key = row["marketplace_code"], row["credential_key"] try: plain = decrypt(token, aad=aad_for(code, key, self._ns), ring=ring) except Exception: # noqa: BLE001 failed += 1 continue self._store.upsert_credential( code, key, encrypted_value=encrypt(plain, aad=aad_for(code, key, self._ns), ring=ring), key_version=ring.current_version, user="rekey", ) done += 1 return {"reencrypted": done, "failed": failed} def key_versions_in_use(self) -> dict[int, int]: counts: dict[int, int] = {} for row in self._store.all_credential_rows(): v = int(row["key_version"]) counts[v] = counts.get(v, 0) + 1 return counts