Skip to content

Security Model

wcorn edited this page Aug 30, 2026 · 5 revisions

보안 위협 모델

orino의 보안 위협 식별·완화 전략. 단일 사용자 + 셀프 호스트 환경 기준.

1. 자산 식별

보호해야 할 자산과 가치.

자산 민감도 영향
학습 데이터 (목표·복습·일정) 중 개인 정보지만 금전적 가치 낮음
로그인 비밀번호 높음 탈취 시 서비스 완전 접근
JWT 서명 키 높음 탈취 시 토큰 위조 가능
DB 접근 정보 높음 DB 완전 접근
Kubernetes cluster 접근 치명 인프라 완전 접근
GitHub repo 쓰기 권한 치명 코드·인프라 임의 배포 가능
S3/MinIO 접근 중 백업·로그 열람/삭제
단축 링크 목적지 (shortlink) 중 목적지 교체 권한 탈취 시 이미 뿌린 주소가 임의 사이트로 향한다

2. 위협 시나리오

2.1 외부 위협 (인터넷 경유)

위협 가능성 영향 완화
무차별 로그인 시도 중 낮음 (BCrypt) Rate limit·IP 차단 (향후)
SQL Injection 낮음 높음 JPA parameterized query 강제
XSS 낮음 중 React 기본 escape + CSP 헤더
CSRF 낮음 중 JWT Authorization 헤더 (쿠키 미사용)
DDoS 낮음 중 CDN 흡수 없음(집 회선 직결) — 감수한 리스크(§3.1·§4), 공유기 443만 포워딩·향후 Istio rate limit
Public endpoint 정보 노출 중 낮음 Swagger prod 비활성·민감 에러 메시지 마스킹

2.2 봇/크롤러

위협 완화
자동화 스캐너 비정상 트래픽 Istio rate limit(향후), 관리 포트 내부 only (CF bot protection은 CF 제거로 상실)
취약점 스캔 Actuator /actuator 외부 미노출 (관리 포트 9090 내부 only)

2.3 공급망 공격

위협 완화
악성 의존성 Dependabot 스캔, trivy 컨테이너 이미지 스캔 (이미 적용: 커밋 18f7cb4)
GitHub Actions 변조 @sha로 action 버전 고정
base image 변조 공식 이미지 digest 고정, 정기 재빌드

2.4 내부 위협 (운영자 실수)

위협 완화
.env 평문 커밋 .gitignore·.secrets 분리 (CLAUDE.md)
kubeconfig 유출 1Password 저장, 기기 fullDisk encryption
destructive 명령 실수 kubectl 직접 배포 금지, ArgoCD만 사용
잘못된 SealedSecret 커밋 kubeseal은 ssh note1에서만 수행

2.5 공개 표면 — s.orino.dev (모듈 10 단축 URL)

orino 최초의 비인증 기능 표면이다. 나머지 전 API가 JWT 뒤에 있는 것과 성질이 다르다. 설계 근거는 단축 URL 확정 명세 §7 · 아키텍처 §5·§6.

위협 가능성 영향 완화
슬러그 열거로 유효 주소 수집 중 중 (목적지 노출) 32⁵≈3,355만 공간 + 난수 생성 + 실패 응답이 상태를 구분하지 않음(404 하나) + IP별 rate limit(한 IP당 분당 300 → 78일). IP를 돌리면 뚫리므로 본체는 여전히 「404 하나」다
OG 프리뷰를 통한 SSRF 중 높음 (내부망 MySQL·Redis·MinIO·메타데이터 엔드포인트) DNS 해석 결과 IP로 사설·링크로컬·CGNAT·k3s 대역 차단, 해석한 IP로 직접 연결(재바인딩 방어), 3홉·3초·1MB, 실패 사유 비노출
오픈 리다이렉트 악용(피싱) 중 중 설계상 임의 목적지로 보내는 것이 기능이다. 통제는 "발급이 인증된 1인에게만 열려 있다"는 것 하나뿐 — 감수한 리스크로 명시
비밀번호 링크 존재 노출 높음 낮음 알고 켠 예외(결정 기록 D-10). 기본 꺼짐 + 슬러그당 분당 10회 제한
공개 표면에 트래픽 집중(집 회선) 중 중 Envoy local rate limit. CF 제거로 흡수 계층이 없다는 §4의 조건은 그대로
방문자 프라이버시 — — IP 컬럼을 두지 않는다. 리퍼러는 도메인까지만, UA 원문 미저장, 원시 90일 후 삭제

2026-08-31 — 한 번 정정했고, 그다음 고쳤다.

정정: 이 표는 Envoy rate limit을 열거 완화책으로 세고 있었는데 나눗셈이 틀렸다. 「200년」이 아니라 33,554,432 ÷ 300/분 ≈ 78일이었고, 버킷이 route마다이고 파드가 2개라 실제로는 약 39일이었다(#1299).

조치: 그래서 #1301에서 IP별 버킷으로 바꿨다. externalTrafficPolicy: Local로 클라이언트 IP를 살리고, remote_address descriptor로 IP마다 버킷을 준다. 이제 한 IP가 쓸 수 있는 것은 분당 300이라 IP 하나당 78일이고, 무엇보다 한 대가 전체 대역을 독점하지 못한다.

그래도 본체는 「404 하나」다. IP를 돌리면 뚫린다. rate limit은 독점을 막는 보조로만 센다.

기존 EnvoyFilter는 api.orino.dev vhost에만 걸려 있다. s.orino.dev를 추가하지 않으면 새 공개 표면이 rate limit 없이 열린다.

3. 현재 방어 계층

3.1 네트워크

Internet
   │  Route53 wildcard A (orino.dev / *.orino.dev) → 집 공인 IP (직결)
   ▼
공유기 443 포워딩 → MetalLB(L2) VIP 192.168.0.240
   │
   ▼
Istio Gateway (cert-manager + Let's Encrypt wildcard, TLS 443 종단 · 호스트 기반 라우팅)
   │
   ▼
Pod (Istio sidecar, mTLS 지원)

2026-06 Cloudflare 완전 제거 → 집 회선 직결 (ELOG-009, #456). 무료 CF anycast의 LAX 라우팅 지연(TTFB 872ms→~20ms)을 없애려 CF·터널을 걷어냈고, 그 대가로 CF가 제공하던 방어(DDoS 흡수·WAF·bot protection·origin IP 은닉·기본 보안헤더)를 함께 상실했다. 단일 사용자·개인 프로젝트라 감수한 리스크로 두되, 대체 가능한 것(TLS)은 대체하고 남은 항목은 §4에 명시한다.

  • NodePort 미사용, LoadBalancer는 MetalLB(L2)로 사설망 VIP만 할당 → 외부에서 노드/클러스터 IP 직접 접근 불가
  • 공인 IP 노출: CF origin 은닉이 사라져 Route53 A레코드가 집 공인 IP를 그대로 가리킨다. 공유기에서 443만 포워딩하고 나머지 포트는 차단해 노출면을 최소화한다
  • TLS: cert-manager + Let's Encrypt wildcard 인증서(Route53 DNS-01)로 istio Gateway 443에서 종단 — CF 자동 TLS를 대체
  • 관리 포트(9090, 3000 등)는 내부 네트워크에만 노출

3.2 인증·인가

계층 방식
BE API JWT (Access 30분 + Refresh 14일 Redis 저장)
Password BCrypt 해시 (강도 기본값)
K8s API kubeconfig (1Password 저장)
ArgoCD UI SSO 미적용, 내부 네트워크 only
Grafana 관리자 계정 + SealedSecret

3.3 시크릿 관리

  • SealedSecret: 평문 Secret 커밋 금지. .secrets 로컬 파일만 유지(gitignored)
  • 환경 변수: prod는 SealedSecret에서 주입, local은 docker-compose
  • GitHub Actions secrets: GHCR 토큰·기타 CI 시크릿

3.4 이미지·코드

  • Trivy: 컨테이너 이미지 취약점 스캔 (CI)
  • Dependabot: 의존성 알림
  • Checkstyle / ESLint: 코드 품질

3.5 공개 표면 최소화 (s.orino.dev)

  • 인증 예외는 /r/** 한 경로뿐. 공개 주소 s.orino.dev/{slug}는 게이트웨이가 /r/{slug}로 재작성한다 — BE 루트에 catch-all을 만들지 않아 예외 표면이 설정 한 줄로 보인다
  • 슬러그 문자셋(^/[a-z0-9]{1,32}$) 밖 요청은 게이트웨이에서 404로 끊어 BE에 닿지 않는다
  • robots.txt는 Disallow: /를 게이트웨이 directResponse로 반환
  • 실패 화면·비밀번호 화면은 BE 서버 렌더 정적 HTML이며 외부 요청이 0이다(FE 번들·CDN 의존 없음)

4. 미흡한 영역

현재 미구축된 보안 통제. 단일 사용자라 위험도는 낮지만 인지는 필요.

영역 현재 상태 향후
Rate limiting (로그인) 없음 Istio EnvoyFilter·Spring Security로 추가 검토
Rate limiting (s.orino.dev) 모듈 10과 함께 신설 공개 표면이라 선택이 아니라 전제다 (§2.5)
CSP 헤더 없음 React 빌드 시 meta/Nginx 설정
보안 헤더 (HSTS 등) 없음 (CF 기본값 의존분이 CF 제거로 사라짐) istio Gateway·Nginx에서 명시적 설정 필요
WAF / DDoS 흡수 없음 (CF 제거, ELOG-009) 감수한 리스크. 향후 Istio EnvoyFilter rate limit·공유기/방화벽 레벨 차단 검토
Audit log Loki의 애플리케이션 로그만 Kubernetes audit log·Istio access log 별도 인덱싱
Network Policy 없음 네임스페이스·Pod 간 통신 최소화
2FA (login) 없음 단일 사용자라 유예
비밀번호 만료 정책 없음 단일 사용자라 유예

5. 대응 절차 (계정·키 탈취 의심 시)

1. 즉시 BE Pod scale to 0 (서비스 중단)
2. 비밀번호 재설정 (DB에 BCrypt 해시 직접 업데이트)
3. JWT 서명 키 rotation (SealedSecret 재발급)
4. Redis flush (모든 Refresh Token 무효화)
5. 감사: Loki에서 최근 로그인·토큰 발급 이력 확인
6. 서비스 재개

K8s·GitHub·AWS 키 탈취 의심 시:

1. 해당 토큰 즉시 revoke (GitHub Settings, AWS IAM(Route53·S3), K8s ServiceAccount)
2. 새 토큰 발급·저장
3. Git 커밋 이력·GitHub Actions 로그 감사
4. 필요 시 SealedSecret master key rotation

6. 정기 점검 항목

분기 1회 확인.

  • GitHub repo collaborators·SSH 키 목록 점검
  • Route53 DNS·wildcard 인증서(cert-manager/LE) 만료·이상 여부
  • Dependabot/Trivy 경고 잔량
  • SealedSecret master key 백업 확인
  • 비정상 로그인 시도 (Loki audit log)

7. 관련 문서

Clone this wiki locally