# woojae9488/oauthclient architecture

> Architecture diagram of the GitHub repository woojae9488/oauthclient, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/woojae9488/oauthclient
- Repository: https://github.com/woojae9488/oauthclient

## Overview

##### Main Components

A. Client Layer
- Web Interface (login.html)
- Authentication Filters
- TokenAuthenticationFilter
- TwitterCallbackAuthenticationFilter
- TwitterLoginProcessingFilter

B. Security Layer
- WebSecurityConfig
- OAuth Client Configurations
- OAuth2 (Kakao, Naver)
- OAuth1 (Twitter)

C. Core Service Layer
- AuthorizationTokenService
- OAuth2UserService
- Authentication Success Handler

D. Data Layer
- Repositories
- SocialUserRepository
- TokenStoreRepository
- Models
- SocialUser
- TokenStore
- OAuth User Attributes

E. External Services
- Kakao OAuth2 Provider
- Naver OAuth2 Provider
- Twitter OAuth1 Provider

##### Key Flows to Highlight

a. OAuth2.0 Flow (Kakao, Naver):
- Path from login request through OAuth2 client configuration
- Token handling and user attribute processing
- Storage of social user data

b. OAuth1.0a Flow (Twitter):
- Demonstrate the specific Twitter authentication process
- Callback handling mechanism
- Token management flow

##### Important Details

a. Configuration Components:
- Properties configuration (OAuth1ClientProperties, OAuth2ClientProperties)
- Authorization token properties
- Security configurations

b. Authentication Aspects:
- AOP components (AuthenticatedUser, AuthenticatedUserAspect)
- Token handling mechanisms
- User principal management

c. Data Models:
- Token attributes (Access, Refresh)
- User roles and permissions
- Social user data structure

##### Additional Recommendations

- Version information for major components
- Notes about supported OAuth providers
- Error handling paths
- Security boundaries

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        WI["Web Interface (login.html)"]:::client
        click WI "https://github.com/woojae9488/OAuthClient/blob/main/src/main/resources/static/login.html"
    end

    subgraph "Authentication Filters"
        TAF["Token Authentication Filter"]:::security
        TCF["Twitter Callback Filter"]:::security
        TLF["Twitter Login Filter"]:::security
        click TAF "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/filter/TokenAuthenticationFilter.java"
        click TCF "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/filter/TwitterCallbackAuthenticationFilter.java"
        click TLF "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/filter/TwitterLoginProcessingFilter.java"
    end

    subgraph "Security Configuration"
        WSC["Web Security Config"]:::security
        OCC["OAuth Client Config"]:::security
        click WSC "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/config/WebSecurityConfig.java"
        click OCC "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/config/OAuthClientConfig.java"
    end

    subgraph "Properties Configuration"
        O1P["OAuth1 Properties"]:::config
        O2P["OAuth2 Properties"]:::config
        ATP["Authorization Token Properties"]:::config
        click O1P "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/config/properties/OAuth1ClientProperties.java"
        click O2P "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/config/properties/OAuth2ClientProperties.java"
        click ATP "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/config/properties/AuthorizationTokenProperties.java"
    end

    subgraph "Core Services"
        ATS["Authorization Token Service"]:::service
        O2US["OAuth2 User Service"]:::service
        ASH["Authentication Success Handler"]:::service
        click ATS "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/service/AuthorizationTokenService.java"
        click O2US "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/service/OAuth2UserService.java"
        click ASH "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/filter/AuthenticationSuccessHandler.java"
    end

    subgraph "Data Layer"
        SUR["Social User Repository"]:::data
        TSR["Token Store Repository"]:::data
        SUM["Social User Model"]:::data
        TSM["Token Store Model"]:::data
        click SUR "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/repository/SocialUserRepository.java"
        click TSR "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/repository/TokenStoreRepository.java"
        click SUM "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/repository/model/SocialUser.java"
        click TSM "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/repository/model/TokenStore.java"
    end

    subgraph "OAuth User Components"
        OUP["OAuth User Principal"]:::model
        OUA["OAuth User Attributes"]:::model
        OP["OAuth Provider"]:::model
        click OUP "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/model/oauth/OAuthUserPrincipal.java"
        click OUA "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/model/oauth/OAuthUserAttributes.java"
        click OP "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/model/oauth/OAuthProvider.java"
    end

    subgraph "Authentication Aspects"
        AU["Authenticated User"]:::aspect
        AUA["Authenticated User Aspect"]:::aspect
        click AU "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/aop/AuthenticatedUser.java"
        click AUA "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/aop/AuthenticatedUserAspect.java"
    end

    subgraph "Token Models"
        AT["Access Token"]:::model
        RT["Refresh Token"]:::model
        TT["Token Type"]:::model
        click AT "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/model/token/AccessTokenAttributes.java"
        click RT "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/model/token/RefreshTokenAttributes.java"
        click TT "https://github.com/woojae9488/OAuthClient/blob/main/src/main/java/com/example/oauth/model/token/TokenType.java"
    end

    subgraph "External OAuth Providers"
        KA["Kakao OAuth2"]:::external
        NA["Naver OAuth2"]:::external
        TW["Twitter OAuth1"]:::external
    end

    %% Connections
    WI --> TAF & TCF & TLF
    TAF & TCF & TLF --> WSC
    WSC --> OCC
    OCC --> O1P & O2P
    O1P & O2P --> ATP
    WSC --> ATS
    ATS --> O2US
    O2US --> ASH
    ASH --> SUR & TSR
    SUR --> SUM
    TSR --> TSM
    O2US --> OUP
    OUP --> OUA
    OUA --> OP
    ATS --> AU
    AU --> AUA
    ATS --> AT & RT
    AT & RT --> TT
    OCC -.-> KA & NA & TW

    %% Styles
    classDef client fill:#a8d1ff,stroke:#333,stroke-width:2px
    classDef security fill:#90EE90,stroke:#333,stroke-width:2px
    classDef config fill:#FFE5CC,stroke:#333,stroke-width:2px
    classDef service fill:#FFFF99,stroke:#333,stroke-width:2px
    classDef data fill:#FFB366,stroke:#333,stroke-width:2px
    classDef model fill:#E6E6FA,stroke:#333,stroke-width:2px
    classDef aspect fill:#DDA0DD,stroke:#333,stroke-width:2px
    classDef external fill:#DDA0DD,stroke:#333,stroke-width:2px
```
