How khinya-khinev/auth-service works
Auth-Service is a Spring-based OAuth2/OpenID Connect authorization server for WMS employees. The main account workflow is an administrator submitting a registration request, which the API delegates to the user service to encode credentials, create a role-bearing user, and persist it; the server also authenticates users and issues tokens. The README documents PostgreSQL and token capabilities, while sampled code and the source index substantiate the registration and security wiring. Some persistence and token-runtime links are shown as unverified where source excerpts do not establish the connection.
Main entry points: AuthServerConfiguration.java Authorization server · CustomUserDetailsService.java User service · User.java User and roles · SecurityFilterChainConfiguration.java Security filter chain
Components 25
Account management
- User API
src/main/java/com/waregang/auth_service/user/api/UserController.java - Registration request
src/main/java/com/waregang/auth_service/user/api/dto/RegisterUserRequest.java - User service
src/main/java/com/waregang/auth_service/user/application/CustomUserDetailsService.java - User and roles
src/main/java/com/waregang/auth_service/user/domain/User.java - Authentication DTOs
src/main/java/com/waregang/auth_service/user/api/dto/AuthenticationRequest.java - User details adapter
src/main/java/com/waregang/auth_service/auth_server_config/UserPrincipal.java
OAuth authorization
- Authorization server
src/main/java/com/waregang/auth_service/auth_server_config/AuthServerConfiguration.java - Access and identity tokens
src/main/java/com/waregang/auth_service/auth_server_config/AuthServerConfiguration.java
Security and configuration
- Security filter chain
src/main/java/com/waregang/auth_service/auth_server_config/SecurityFilterChainConfiguration.java - Security settings
src/main/java/com/waregang/auth_service/auth_server_config/SecurityConfig.java - Auth properties
src/main/java/com/waregang/auth_service/auth_server_config/properties/AuthProperties.java - Gateway properties
src/main/java/com/waregang/auth_service/auth_server_config/properties/GatewayProperties.java - JWT properties
src/main/java/com/waregang/auth_service/auth_server_config/properties/JwtProperties.java - Access denied handler
src/main/java/com/waregang/auth_service/auth_server_config/CustomAccessDeniedHandler.java - Authentication entry point
src/main/java/com/waregang/auth_service/auth_server_config/CustomAuthenticationEntryPoint.java
Persistence and errors
- User repository
src/main/java/com/waregang/auth_service/user/repository/UserRepository.java - PostgreSQL
- Database migrations
src/main/resources/db/migration/V1__init_schema.sql - Database error translation
src/main/java/com/waregang/auth_service/common/exception_handling/DatabaseExceptionTranslator.java - Error codes
src/main/java/com/waregang/auth_service/common/exception_handling/error_code/ErrorCode.java - Application exceptions
src/main/java/com/waregang/auth_service/common/exception_handling/AppException.java - Global error handler
src/main/java/com/waregang/auth_service/common/exception_handling/GlobalExceptionHandler.java - ID generation
src/main/java/com/waregang/auth_service/common/uuid/IdGenerator.java
Other components
- Administrator
- Employee or client
Connections 25
- Administrator → User API: registers accounts
src/main/java/com/waregang/auth_service/user/api/UserController.java - User API → Registration request: accepts request
src/main/java/com/waregang/auth_service/user/api/UserController.java - User API → User service: delegates registration
src/main/java/com/waregang/auth_service/user/api/UserController.java - User service → User repository: saves and looks up
src/main/java/com/waregang/auth_service/user/application/CustomUserDetailsService.java - User service → User and roles: creates users
src/main/java/com/waregang/auth_service/user/application/CustomUserDetailsService.java - User service → Registration request: reads registration data
src/main/java/com/waregang/auth_service/user/application/CustomUserDetailsService.java - User service → Database error translation: translates database errors
src/main/java/com/waregang/auth_service/user/application/CustomUserDetailsService.java - User and roles → ID generation: generates identifier
src/main/java/com/waregang/auth_service/user/domain/User.java - User repository → User and roles: persists users
src/main/java/com/waregang/auth_service/user/repository/UserRepository.java - User repository → PostgreSQL: stores records
- Database migrations → PostgreSQL: defines schema
- Employee or client → Authorization server: authenticates
README.md - Authorization server → Access and identity tokens: issues tokens
README.md - Authorization server → Auth properties: uses settings
src/main/java/com/waregang/auth_service/auth_server_config/AuthServerConfiguration.java - Authorization server → Gateway properties: uses settings
src/main/java/com/waregang/auth_service/auth_server_config/AuthServerConfiguration.java - Authorization server → JWT properties: uses settings
src/main/java/com/waregang/auth_service/auth_server_config/AuthServerConfiguration.java - Authorization server → User and roles: uses user identity
src/main/java/com/waregang/auth_service/auth_server_config/AuthServerConfiguration.java - Authorization server → User details adapter: adapts user details
- Employee or client → Authentication DTOs: submits credentials
- Security filter chain → Access denied handler: configures handler
src/main/java/com/waregang/auth_service/auth_server_config/SecurityFilterChainConfiguration.java - Security filter chain → Authentication entry point: configures handler
src/main/java/com/waregang/auth_service/auth_server_config/SecurityFilterChainConfiguration.java - Security filter chain → Security settings: applies settings
- Database error translation → Error codes: selects codes
src/main/java/com/waregang/auth_service/common/exception_handling/DatabaseExceptionTranslator.java - Database error translation → Application exceptions: creates exceptions
src/main/java/com/waregang/auth_service/common/exception_handling/DatabaseExceptionTranslator.java - Global error handler → Application exceptions: handles exceptions
src/main/java/com/waregang/auth_service/common/exception_handling/GlobalExceptionHandler.java