works/oauth/docs/architecture.md

OAuth 시스템 아키텍처

시스템 구성도

graph TB
    subgraph "Client Layer"
        Browser[사용자 브라우저]
    end
    
    subgraph "API Gateway Layer"
        APISIX[Apache APISIX<br/>- API Gateway<br/>- Rate Limiting<br/>- Authentication<br/>- Load Balancing]
        etcd[etcd<br/>- Service Discovery<br/>- Configuration Store]
    end
    
    subgraph "Application Layer"
        Backend[FastAPI Backend<br/>- Auth Logic<br/>- JWT Handling<br/>- Business Logic]
        Frontend[React Frontend<br/>- Dynamic UI<br/>- Theme Engine<br/>- SPA Routing]
    end
    
    subgraph "Data Layer"
        MongoDB[MongoDB<br/>- Users<br/>- Apps<br/>- History]
        Redis[Redis<br/>- Cache<br/>- Queue<br/>- Session]
        Celery[Celery<br/>- Tasks<br/>- Jobs]
        Backup[Backup Service<br/>- Cron Jobs<br/>- Archives]
    end
    
    Browser -->|HTTP/HTTPS| APISIX
    APISIX -->|/api/v1/*| Backend
    APISIX -->|/*| Frontend
    APISIX <--> etcd
    Backend --> MongoDB
    Backend --> Redis
    Backend --> Celery
    Backend --> Backup

데이터 플로우

1. 인증 플로우

sequenceDiagram
    participant User as 사용자
    participant App as 애플리케이션
    participant OAuth as OAuth 서버
    participant DB as Database
    
    User->>App: 1. 접속
    App->>OAuth: 2. 리다이렉트 (client_id, redirect_uri)
    OAuth->>User: 3. 동적 로그인 페이지 렌더링
    User->>OAuth: 4. 인증 정보 입력
    OAuth->>DB: 5. 인증 검증
    OAuth->>User: 6. Authorization Code 발급
    User->>App: 7. Code 전달
    App->>OAuth: 8. Access Token 요청
    OAuth->>App: 9. Access Token 발급
    App->>OAuth: 10. 사용자 정보 요청
    OAuth->>App: 11. 권한별 사용자 정보 제공

2. 토큰 관리

• Access Token: 30분 유효
• Refresh Token: 7일 유효
• Token Rotation 정책 적용

마이크로서비스 구조

graph LR
    subgraph "Core Services"
        Auth[Authentication Service]
        Authz[Authorization Service]
        UserMgmt[User Management Service]
        AppService[Application Service]
        Audit[Audit Service]
    end
    
    subgraph "Support Services"
        Cache[Cache Service]
        Queue[Queue Service]
        Backup[Backup Service]
    end
    
    Auth --> Cache
    Auth --> Queue
    Authz --> Cache
    UserMgmt --> Audit
    AppService --> Audit

Core Services

1. Authentication Service

   • 사용자 인증
   • 토큰 발급/검증
   • 세션 관리

2. Authorization Service

   • 권한 확인
   • 역할 기반 접근 제어 (RBAC)
   • 리소스 접근 관리

3. User Management Service

   • 사용자 CRUD
   • 프로필 관리
   • 패스워드 관리

4. Application Service

   • 애플리케이션 등록/관리
   • Client Credentials 관리
   • 테마 설정 관리

5. Audit Service

   • 접속 로그
   • 인증 히스토리
   • 보안 이벤트 추적

확장성 고려사항

Horizontal Scaling

graph TB
    LB[Load Balancer]
    
    subgraph "Application Instances"
        App1[App Instance 1]
        App2[App Instance 2]
        App3[App Instance 3]
    end
    
    subgraph "Shared State"
        Redis[Redis Session Store]
        MongoDB[MongoDB Cluster]
    end
    
    LB --> App1
    LB --> App2
    LB --> App3
    
    App1 --> Redis
    App1 --> MongoDB
    App2 --> Redis
    App2 --> MongoDB
    App3 --> Redis
    App3 --> MongoDB

Database Sharding

• User ID 기반 샤딩
• Application ID 기반 샤딩
• 시간 기반 파티셔닝 (히스토리)

Caching Strategy

• User Profile 캐싱
• Application Settings 캐싱
• Token 캐싱

보안 아키텍처

graph TB
    subgraph "External"
        Internet[Internet]
    end
    
    subgraph "DMZ"
        WAF[WAF]
        CDN[CDN]
    end
    
    subgraph "Public Subnet"
        ALB[Application Load Balancer]
        NAT[NAT Gateway]
    end
    
    subgraph "Private Subnet"
        App[Application Servers]
        Cache[Cache Layer]
    end
    
    subgraph "Data Subnet"
        DB[(Database)]
        Backup[(Backup Storage)]
    end
    
    Internet --> WAF
    WAF --> CDN
    CDN --> ALB
    ALB --> App
    App --> Cache
    App --> NAT
    App --> DB
    DB --> Backup

Network Security

• VPC 격리
• Security Groups
• Private Subnets

Application Security

• Rate Limiting
• DDoS Protection
• WAF Rules

Data Security

• Encryption at Rest
• Encryption in Transit
• Key Management Service (KMS)