Files
dbx-main/app/modules/performance/security/crypto.py
T
king aa669553db feat(performance): 실적(쇼핑몰 통합 매출) 모듈 1단계 — 대시보드·설정·보안·어댑터 구조
- 네 영역 분리: ① 수집(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>
2026-09-29 16:07:46 +09:00

162 lines
6.2 KiB
Python

"""쇼핑몰 인증정보 암호화 — AES-256-GCM(인증 암호화) + 키 버전.
- 라이브러리: `cryptography` 의 AESGCM (직접 만든 알고리즘 없음).
- 해시가 아니라 **복호화 가능한** 암호화다 — API Secret/Token 은 나중에 원문이 필요하다.
- 마스터 키는 DB 에 두지 않는다. 환경변수(.env)에서만 읽는다.
APP_ENCRYPTION_KEY 현재 키(32바이트). `openssl rand -hex 32` 의 64자 hex
또는 32바이트 base64/base64url 둘 다 받는다.
APP_ENCRYPTION_KEY_VERSION 현재 키의 버전 번호(기본 1).
APP_ENCRYPTION_KEY_V{n} 키 교체 중 남겨 두는 예전 키(버전 n). 재암호화가
끝나면 지운다.
암호문 형식: ``v{버전}:{base64url(nonce 12바이트 + 암호문 + tag 16바이트)}``
AAD(추가 인증 데이터)로 "어느 쇼핑몰의 어느 항목"인지를 묶는다
(예: ``perf:coupang:secret_key``). DB 에서 암호문을 다른 행/칸으로 옮겨 붙이면
복호화가 실패한다.
"""
from __future__ import annotations
import base64
import binascii
import os
import re
from dataclasses import dataclass, field
from typing import Mapping
KEY_ENV = "APP_ENCRYPTION_KEY"
VERSION_ENV = "APP_ENCRYPTION_KEY_VERSION"
_OLD_KEY_RE = re.compile(r"^APP_ENCRYPTION_KEY_V(\d+)$")
_TOKEN_RE = re.compile(r"^v(\d+):([A-Za-z0-9_\-]+={0,2})$")
_NONCE_LEN = 12
class CryptoConfigError(RuntimeError):
"""마스터 키가 없거나 형식이 틀림 — 설정 문제."""
class DecryptError(RuntimeError):
"""복호화 실패(키 버전 없음/키 바뀜/손상/다른 칸의 암호문). 원문·키는 메시지에 넣지 않는다."""
def _parse_key(raw: str, *, name: str) -> bytes:
value = (raw or "").strip()
if not value:
raise CryptoConfigError(f"{name} 가 비어 있습니다.")
if re.fullmatch(r"[0-9a-fA-F]{64}", value):
return bytes.fromhex(value)
try:
padded = value + "=" * (-len(value) % 4)
decoded = base64.urlsafe_b64decode(padded.replace("+", "-").replace("/", "_"))
except (binascii.Error, ValueError):
decoded = b""
if len(decoded) == 32:
return decoded
raise CryptoConfigError(
f"{name} 형식이 올바르지 않습니다. 32바이트 키가 필요합니다 "
"(`openssl rand -hex 32` 로 만든 64자 hex 권장)."
)
@dataclass(frozen=True)
class KeyRing:
"""현재 키 + (교체 중이면) 예전 키들. 키 값은 repr 에 나오지 않는다."""
current_version: int
_keys: Mapping[int, bytes] = field(repr=False)
@classmethod
def from_env(cls, environ: Mapping[str, str] | None = None) -> "KeyRing":
env = os.environ if environ is None else environ
raw_current = (env.get(KEY_ENV) or "").strip()
if not raw_current:
raise CryptoConfigError(
f"{KEY_ENV} 환경변수가 설정되지 않았습니다. "
"`openssl rand -hex 32` 로 값을 만들어 .env 에 넣고 컨테이너를 재기동하세요."
)
try:
version = int((env.get(VERSION_ENV) or "1").strip())
except ValueError:
raise CryptoConfigError(f"{VERSION_ENV} 는 1 이상의 정수여야 합니다.") from None
if version < 1:
raise CryptoConfigError(f"{VERSION_ENV} 는 1 이상의 정수여야 합니다.")
keys: dict[int, bytes] = {}
for name, raw in env.items():
m = _OLD_KEY_RE.match(name)
if m and (raw or "").strip():
keys[int(m.group(1))] = _parse_key(raw, name=name)
keys[version] = _parse_key(raw_current, name=KEY_ENV)
return cls(current_version=version, _keys=keys)
@property
def versions(self) -> list[int]:
return sorted(self._keys)
def key(self, version: int) -> bytes:
try:
return self._keys[version]
except KeyError:
raise DecryptError(
f"암호화 키 버전 v{version} 이 서버에 없습니다. "
f"{KEY_ENV}_V{version} 환경변수를 확인하세요."
) from None
def _aesgcm(key: bytes):
from cryptography.hazmat.primitives.ciphers.aead import AESGCM # 지연 import
return AESGCM(key)
def encrypt(plaintext: str, *, aad: str, ring: KeyRing) -> str:
"""평문 → ``v{버전}:{...}``. 항상 현재 키로 암호화한다."""
if plaintext is None:
raise ValueError("암호화할 값이 없습니다.")
nonce = os.urandom(_NONCE_LEN)
ct = _aesgcm(ring.key(ring.current_version)).encrypt(
nonce, plaintext.encode("utf-8"), aad.encode("utf-8")
)
body = base64.urlsafe_b64encode(nonce + ct).decode("ascii")
return f"v{ring.current_version}:{body}"
def key_version_of(token: str) -> int:
m = _TOKEN_RE.match(token or "")
if not m:
raise DecryptError("암호문 형식이 올바르지 않습니다.")
return int(m.group(1))
def decrypt(token: str, *, aad: str, ring: KeyRing) -> str:
"""``v{버전}:{...}`` → 평문. 실패 원인은 알려 주되 값은 절대 담지 않는다."""
m = _TOKEN_RE.match(token or "")
if not m:
raise DecryptError("암호문 형식이 올바르지 않습니다.")
version = int(m.group(1))
try:
raw = base64.urlsafe_b64decode(m.group(2))
except (binascii.Error, ValueError):
raise DecryptError("암호문이 손상되었습니다.") from None
if len(raw) <= _NONCE_LEN:
raise DecryptError("암호문이 손상되었습니다.")
from cryptography.exceptions import InvalidTag # 지연 import
try:
pt = _aesgcm(ring.key(version)).decrypt(raw[:_NONCE_LEN], raw[_NONCE_LEN:], aad.encode("utf-8"))
except InvalidTag:
raise DecryptError(
"복호화하지 못했습니다. 마스터 키가 바뀌었거나 값이 손상되었습니다. "
"인증정보를 다시 입력해야 할 수 있습니다."
) from None
return pt.decode("utf-8")
def needs_reencrypt(token: str, ring: KeyRing) -> bool:
"""현재 키 버전이 아닌 암호문인가(키 교체 후 재암호화 대상)."""
try:
return key_version_of(token) != ring.current_version
except DecryptError:
return False