aa669553db
- 네 영역 분리: ① 수집(adapters/ 쇼핑몰 10곳 + sync.py) ② 보안(security/ + credentials.py) ③ 계산·저장(calc.py + db.py) ④ 화면(dashboard.py, router.py, templates, performance.css/js) - 대시보드: 기간(오늘/이번주/이번달/올해/직접선택, 이전·다음), 쇼핑몰 필터, KPI 5개(진행 중 기간은 직전 기간 같은 경과일 대비), 일자×쇼핑몰 표(주간합계, 총매출/수수료/차감매출 전환), 일별 추이· 쇼핑몰 비중(SVG), 월 누적(비중)·연간 누적, 금액 클릭 → 주문 상세 - 설정(관리자): 사용/매출 집계, 수수료율 이력(적용 시작일), 쇼핑몰별 API 인증정보 입력·연결 테스트· 연결 상태, 마스터 키 상태·재암호화, 테스트(모의) 데이터 생성/삭제 - 인증정보: 설정 화면 입력 → AES-256-GCM(키 버전, AAD=쇼핑몰+항목) 암호화 저장, secret 원문은 화면으로 다시 보내지 않음, 오류·로그·raw 는 비밀값 가린 뒤 저장. 마스터 키는 APP_ENCRYPTION_KEY(.env) - 매출 기준일: 결제=결제일, 취소·반품=발생일. 금액 원 단위 정수, 수수료 반올림은 calc.commission 한 곳 - 동기화: 같은 쇼핑몰 동시 실행 차단(running 부분 유니크), 쇼핑몰별 실패 격리, 중복 방지 UNIQUE+UPSERT - 카페24 어댑터는 기존 app/integrations/cafe24 OAuth 토큰 재사용, 나머지는 입력칸만(수집은 다음 단계) - performance_db 초기화 스크립트, 권한키 performance(설정은 is_admin), 문서·.env.example Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
175 lines
8.1 KiB
Python
175 lines
8.1 KiB
Python
"""② 쇼핑몰 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) -> str:
|
|
"""암호문을 (쇼핑몰, 항목)에 묶는 추가 인증 데이터."""
|
|
return f"perf:{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 = "") -> None:
|
|
self._store = store
|
|
self._code = code
|
|
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._persist = persist
|
|
self._user = user
|
|
|
|
def has(self, key: str) -> bool:
|
|
return bool(self._overrides.get(key)) or key in self._rows
|
|
|
|
def get(self, key: str) -> str:
|
|
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), 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), 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:
|
|
def __init__(self, store: Any, ring_loader: Callable[[], KeyRing]) -> None:
|
|
self._store = store
|
|
self._ring_loader = ring_loader
|
|
|
|
def accessor(self, code: str, *, overrides: dict[str, str] | None = None, persist: bool = True,
|
|
user: str = "") -> CredentialAccessor:
|
|
return CredentialAccessor(self._store, code, self._ring_loader, overrides=overrides,
|
|
persist=persist, user=user)
|
|
|
|
# ── 화면용 요약(비밀 원문 없음) ─────────────────────────
|
|
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,
|
|
"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),
|
|
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()
|
|
saved = []
|
|
for key, raw in values.items():
|
|
if key not in allowed:
|
|
continue
|
|
v = (raw or "").strip()
|
|
if not v:
|
|
continue
|
|
self._store.upsert_credential(
|
|
adapter.code, key, encrypted_value=encrypt(v, aad=aad_for(adapter.code, key), 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:
|
|
self._store.delete_credential(adapter.code, key)
|
|
return saved
|
|
|
|
# ── 마스터 키 교체 후 재암호화 ─────────────────────────
|
|
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), ring=ring)
|
|
except Exception: # noqa: BLE001
|
|
failed += 1
|
|
continue
|
|
self._store.upsert_credential(
|
|
code, key, encrypted_value=encrypt(plain, aad=aad_for(code, key), 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
|