Repository navigation
Security Model
orino의 보안 위협 식별·완화 전략. 단일 사용자 + 셀프 호스트 환경 기준.
보호해야 할 자산과 가치.
| 자산 | 민감도 | 영향 |
|---|---|---|
| 학습 데이터 (목표·복습·일정) | 중 | 개인 정보지만 금전적 가치 낮음 |
| 로그인 비밀번호 | 높음 | 탈취 시 서비스 완전 접근 |
| JWT 서명 키 | 높음 | 탈취 시 토큰 위조 가능 |
| DB 접근 정보 | 높음 | DB 완전 접근 |
| Kubernetes cluster 접근 | 치명 | 인프라 완전 접근 |
| GitHub repo 쓰기 권한 | 치명 | 코드·인프라 임의 배포 가능 |
| S3/MinIO 접근 | 중 | 백업·로그 열람/삭제 |
단축 링크 목적지 (shortlink) |
중 | 목적지 교체 권한 탈취 시 이미 뿌린 주소가 임의 사이트로 향한다 |
| 위협 | 가능성 | 영향 | 완화 |
|---|---|---|---|
| 무차별 로그인 시도 | 중 | 낮음 (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 비활성·민감 에러 메시지 마스킹 |
| 위협 | 완화 |
|---|---|
| 자동화 스캐너 | 비정상 트래픽 Istio rate limit(향후), 관리 포트 내부 only (CF bot protection은 CF 제거로 상실) |
| 취약점 스캔 | Actuator /actuator 외부 미노출 (관리 포트 9090 내부 only) |
| 위협 | 완화 |
|---|---|
| 악성 의존성 | Dependabot 스캔, trivy 컨테이너 이미지 스캔 (이미 적용: 커밋 18f7cb4) |
| GitHub Actions 변조 |
@sha로 action 버전 고정 |
| base image 변조 | 공식 이미지 digest 고정, 정기 재빌드 |
| 위협 | 완화 |
|---|---|
| .env 평문 커밋 |
.gitignore·.secrets 분리 (CLAUDE.md) |
| kubeconfig 유출 | 1Password 저장, 기기 fullDisk encryption |
| destructive 명령 실수 |
kubectl 직접 배포 금지, ArgoCD만 사용 |
| 잘못된 SealedSecret 커밋 | kubeseal은 ssh note1에서만 수행 |
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_addressdescriptor로 IP마다 버킷을 준다. 이제 한 IP가 쓸 수 있는 것은 분당 300이라 IP 하나당 78일이고, 무엇보다 한 대가 전체 대역을 독점하지 못한다.그래도 본체는 「404 하나」다. IP를 돌리면 뚫린다. rate limit은 독점을 막는 보조로만 센다.
기존 EnvoyFilter는
api.orino.devvhost에만 걸려 있다.s.orino.dev를 추가하지 않으면 새 공개 표면이 rate limit 없이 열린다.
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 등)는 내부 네트워크에만 노출
| 계층 | 방식 |
|---|---|
| BE API | JWT (Access 30분 + Refresh 14일 Redis 저장) |
| Password | BCrypt 해시 (강도 기본값) |
| K8s API | kubeconfig (1Password 저장) |
| ArgoCD UI | SSO 미적용, 내부 네트워크 only |
| Grafana | 관리자 계정 + SealedSecret |
-
SealedSecret: 평문 Secret 커밋 금지.
.secrets로컬 파일만 유지(gitignored) - 환경 변수: prod는 SealedSecret에서 주입, local은 docker-compose
- GitHub Actions secrets: GHCR 토큰·기타 CI 시크릿
- Trivy: 컨테이너 이미지 취약점 스캔 (CI)
- Dependabot: 의존성 알림
- Checkstyle / ESLint: 코드 품질
-
인증 예외는
/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 의존 없음)
현재 미구축된 보안 통제. 단일 사용자라 위험도는 낮지만 인지는 필요.
| 영역 | 현재 상태 | 향후 |
|---|---|---|
| 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) | 없음 | 단일 사용자라 유예 |
| 비밀번호 만료 정책 | 없음 | 단일 사용자라 유예 |
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
분기 1회 확인.
- GitHub repo collaborators·SSH 키 목록 점검
- Route53 DNS·wildcard 인증서(cert-manager/LE) 만료·이상 여부
- Dependabot/Trivy 경고 잔량
- SealedSecret master key 백업 확인
- 비정상 로그인 시도 (Loki audit log)