# hamilton2959/spring-security-jwt-authentication-and-authorization- architecture

> Architecture diagram of the GitHub repository hamilton2959/spring-security-jwt-authentication-and-authorization-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hamilton2959/spring-security-jwt-authentication-and-authorization-
- Repository: https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-

## Overview

This is a Spring Boot JWT-security application with a small protected book API. The principal workflow is registration or login, credential verification, JWT issuance and persistence, then bearer-token validation on protected requests; users can also refresh tokens, log out, and change passwords. Role-based authorization and auditing support protected operations. The graph preserves the documented security capabilities and visible book-management components. Some controllers and configuration wiring were not excerpted, so uncertain relationships are omitted or marked dashed.

Main entry points: [`src/main/java/com/hamilton/security/auth/AuthenticationService.java`](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationService.java) (Auth Service), [`src/main/java/com/hamilton/security/token/TokenRepository.java`](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/token/TokenRepository.java) (Token Repository), [`src/main/java/com/hamilton/security/book/BookService.java`](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookService.java) (Book Service), [`src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java`](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java) (JWT Filter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Tokens"]
  node_auth_controller["Auth API"]
  node_auth_service["Auth Service"]
  node_auth_models["Auth Models"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_token_repo["Token Repository"]
  node_logout["Logout Handler<br/>[LogoutService.java]"]
end

subgraph group_security["Request Security"]
  node_jwt_filter["JWT Filter"]
  node_security_config["Security Rules"]
  node_app_config["App Configuration"]
end

subgraph group_accounts["Accounts &amp; Roles"]
  node_user_controller["User API"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_user_repo["User Repository"]
  node_user_role["User &amp; Roles<br/>[User.java]"]
  node_demo_apis["Role Demo APIs"]
end

subgraph group_books["Books &amp; Audit"]
  node_book_controller["Book API"]
  node_book_service["Book Service<br/>[BookService.java]"]
  node_book_repo["Book Repository"]
  node_book_entity["Book &amp; Audit Fields<br/>[Book.java]"]
  node_audit_aware["Audit Identity"]
end

node_client(("API Client"))
node_database[("Application Database")]

node_client -->|"registers or logs in"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"issues tokens"| node_jwt_service
node_auth_service -->|"loads and saves users"| node_user_repo
node_auth_service -->|"stores and revokes"| node_token_repo
node_auth_service -->|"returns tokens"| node_auth_models
node_jwt_filter -->|"validates JWT"| node_jwt_service
node_jwt_filter -->|"checks revocation"| node_token_repo
node_security_config -->|"registers filter"| node_jwt_filter
node_logout -->|"revokes tokens"| node_token_repo
node_user_controller -->|"delegates password change"| node_user_service
node_user_service -->|"saves password"| node_user_repo
node_user_role -.->|"persists user records"| node_database
node_user_repo -.->|"queries users"| node_database
node_token_repo -.->|"queries tokens"| node_database
node_book_controller -->|"delegates"| node_book_service
node_book_service -->|"saves and lists"| node_book_repo
node_book_service -->|"creates books"| node_book_entity
node_book_repo -.->|"queries books"| node_database
node_app_config -->|"configures auditing"| node_audit_aware
node_audit_aware -->|"resolves current user"| node_user_role
node_client -.->|"changes password"| node_user_controller
node_client -.->|"uses book API"| node_book_controller
node_client -.->|"requests role demos"| node_demo_apis

click node_auth_controller "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationController.java"
click node_auth_service "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationService.java"
click node_auth_models "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationResponse.java"
click node_jwt_service "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/JwtService.java"
click node_token_repo "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/token/TokenRepository.java"
click node_logout "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/LogoutService.java"
click node_jwt_filter "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/SecurityConfiguration.java"
click node_app_config "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/ApplicationConfig.java"
click node_user_controller "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/UserController.java"
click node_user_service "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/UserService.java"
click node_user_repo "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/UserRepository.java"
click node_user_role "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/User.java"
click node_demo_apis "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/tree/master/src/main/java/com/hamilton/security/demo"
click node_book_controller "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookController.java"
click node_book_service "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookService.java"
click node_book_repo "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookRepository.java"
click node_book_entity "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/Book.java"
click node_audit_aware "https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auditing/ApplicationAuditAware.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_controller,node_auth_service,node_auth_models,node_jwt_service,node_token_repo,node_logout,node_client toneBlue
class node_jwt_filter,node_security_config,node_app_config,node_database toneAmber
class node_user_controller,node_user_service,node_user_repo,node_user_role,node_demo_apis toneMint
class node_book_controller,node_book_service,node_book_repo,node_book_entity,node_audit_aware toneRose
```

## Components

### Identity & Tokens

- [Auth API](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationController.java): `src/main/java/com/hamilton/security/auth/AuthenticationController.java`
- [Auth Service](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationService.java): `src/main/java/com/hamilton/security/auth/AuthenticationService.java`
- [Auth Models](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auth/AuthenticationResponse.java): `src/main/java/com/hamilton/security/auth/AuthenticationResponse.java`
- [JWT Service](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/JwtService.java): `src/main/java/com/hamilton/security/config/JwtService.java`
- [Token Repository](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/token/TokenRepository.java): `src/main/java/com/hamilton/security/token/TokenRepository.java`
- [Logout Handler](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/LogoutService.java): `src/main/java/com/hamilton/security/config/LogoutService.java`

### Request Security

- [JWT Filter](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java): `src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java`
- [Security Rules](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/SecurityConfiguration.java): `src/main/java/com/hamilton/security/config/SecurityConfiguration.java`
- [App Configuration](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/config/ApplicationConfig.java): `src/main/java/com/hamilton/security/config/ApplicationConfig.java`

### Accounts & Roles

- [User API](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/UserController.java): `src/main/java/com/hamilton/security/user/UserController.java`
- [User Service](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/UserService.java): `src/main/java/com/hamilton/security/user/UserService.java`
- [User Repository](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/UserRepository.java): `src/main/java/com/hamilton/security/user/UserRepository.java`
- [User & Roles](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/user/User.java): `src/main/java/com/hamilton/security/user/User.java`
- [Role Demo APIs](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/tree/master/src/main/java/com/hamilton/security/demo): `src/main/java/com/hamilton/security/demo`

### Books & Audit

- [Book API](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookController.java): `src/main/java/com/hamilton/security/book/BookController.java`
- [Book Service](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookService.java): `src/main/java/com/hamilton/security/book/BookService.java`
- [Book Repository](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/BookRepository.java): `src/main/java/com/hamilton/security/book/BookRepository.java`
- [Book & Audit Fields](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/book/Book.java): `src/main/java/com/hamilton/security/book/Book.java`
- [Audit Identity](https://github.com/hamilton2959/spring-security-jwt-authentication-and-authorization-/blob/master/src/main/java/com/hamilton/security/auditing/ApplicationAuditAware.java): `src/main/java/com/hamilton/security/auditing/ApplicationAuditAware.java`

### Other components

- **API Client**
- **Application Database**

## Connections

- API Client → Auth API: registers or logs in (evidence: `README.md`)
- Auth API → Auth Service: delegates to (evidence: `src/main/java/com/hamilton/security/auth/AuthenticationController.java`)
- Auth Service → JWT Service: issues tokens (evidence: `src/main/java/com/hamilton/security/auth/AuthenticationService.java`)
- Auth Service → User Repository: loads and saves users (evidence: `src/main/java/com/hamilton/security/auth/AuthenticationService.java`)
- Auth Service → Token Repository: stores and revokes (evidence: `src/main/java/com/hamilton/security/auth/AuthenticationService.java`)
- Auth Service → Auth Models: returns tokens (evidence: `src/main/java/com/hamilton/security/auth/AuthenticationService.java`)
- JWT Filter → JWT Service: validates JWT (evidence: `src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java`)
- JWT Filter → Token Repository: checks revocation (evidence: `src/main/java/com/hamilton/security/config/JwtAuthenticationFilter.java`)
- Security Rules → JWT Filter: registers filter (evidence: `src/main/java/com/hamilton/security/config/SecurityConfiguration.java`)
- Logout Handler → Token Repository: revokes tokens (evidence: `src/main/java/com/hamilton/security/config/LogoutService.java`)
- User API → User Service: delegates password change (evidence: `src/main/java/com/hamilton/security/user/UserController.java`)
- User Service → User Repository: saves password (evidence: `src/main/java/com/hamilton/security/user/UserService.java`)
- User & Roles → Application Database: persists user records
- User Repository → Application Database: queries users
- Token Repository → Application Database: queries tokens
- Book API → Book Service: delegates (evidence: `src/main/java/com/hamilton/security/book/BookController.java`)
- Book Service → Book Repository: saves and lists (evidence: `src/main/java/com/hamilton/security/book/BookService.java`)
- Book Service → Book & Audit Fields: creates books (evidence: `src/main/java/com/hamilton/security/book/BookService.java`)
- Book Repository → Application Database: queries books
- App Configuration → Audit Identity: configures auditing (evidence: `src/main/java/com/hamilton/security/config/ApplicationConfig.java`)
- Audit Identity → User & Roles: resolves current user (evidence: `src/main/java/com/hamilton/security/auditing/ApplicationAuditAware.java`)
- API Client → User API: changes password
- API Client → Book API: uses book API
- API Client → Role Demo APIs: requests role demos
