# ahmd-nabil/spring-security architecture

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

- Interactive diagram: https://gitdiagram.com/ahmd-nabil/spring-security
- Repository: https://github.com/ahmd-nabil/spring-security

## Overview

Spring Security is a modular Java security framework for Spring applications. Its runtime spans authentication identities and context, protocol integrations, request/message authorization, and ACL-backed object permissions; configuration modules assemble those capabilities for applications. The sampled sources directly show pre-authenticated user construction, OAuth2 user-info conversion and authorized-client persistence, plus context-aware executor delegation. Other substantial product branches are retained from the module tree, but their internal call paths were not sampled, so relationships to them are not inferred.

Main entry points: [`web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java`](https://github.com/ahmd-nabil/spring-security/blob/main/web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java) (Pre-auth User Mapping), [`oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/registration/ClientRegistration.java`](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/registration/ClientRegistration.java) (OAuth Client Registration), [`oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.java`](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.java) (Authorized Client Store), [`core/src/main/java/org/springframework/security/concurrent/DelegatingSecurityContextExecutorService.java`](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/concurrent/DelegatingSecurityContextExecutorService.java) (Context Executors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Context"]
  node_authentication["Authentication"]
  node_authorities["Granted Authorities"]
  node_user_details["User Details<br/>[UserDetails.java]"]
  node_user["User Principal<br/>[User.java]"]
  node_security_context["Security Context"]
  node_context_executor["Context Executors"]
end

subgraph group_protocols["Authentication Protocols"]
  node_preauth_service["Pre-auth User Mapping"]
  node_cas["CAS Integration"]
  node_ldap["LDAP Integration"]
  node_oauth_registration["OAuth Client Registration"]
  node_oauth_userinfo["OAuth User Info"]
  node_oidc_userinfo["OIDC User Info"]
  node_saml["SAML Service Provider"]
  node_resource_server["Resource Server"]
end

subgraph group_authorization["Authorization"]
  node_web_authorization["Web Authorization"]
  node_method_security["Method Security"]
  node_acl_identity["ACL Object Identity"]
  node_acl_service["ACL Services"]
  node_message_authorization["Message Authorization"]
  node_rsocket_authorization["RSocket Authorization"]
end

subgraph group_configuration["Application Configuration"]
  node_security_configuration["Security Configuration"]
end

subgraph group_persistence["Security State"]
  node_authorized_clients["Authorized Client Store"]
end

node_application(("Spring Application"))
node_relational_db[("Relational Database")]

node_application -.->|"configures"| node_security_configuration
node_preauth_service -->|"reads token"| node_authentication
node_preauth_service -->|"creates details"| node_user_details
node_preauth_service -->|"constructs user"| node_user
node_preauth_service -->|"uses authorities"| node_authorities
node_context_executor -->|"propagates context"| node_security_context
node_oauth_userinfo -->|"reads registration"| node_oauth_registration
node_oidc_userinfo -->|"reads registration"| node_oauth_registration
node_authorized_clients -->|"looks up registration"| node_oauth_registration
node_authorized_clients -->|"queries and updates"| node_relational_db

click node_authentication "https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/Authentication.java"
click node_authorities "https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/GrantedAuthority.java"
click node_user_details "https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/userdetails/UserDetails.java"
click node_user "https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/userdetails/User.java"
click node_security_context "https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/context/SecurityContextHolder.java"
click node_context_executor "https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/concurrent/DelegatingSecurityContextExecutorService.java"
click node_preauth_service "https://github.com/ahmd-nabil/spring-security/blob/main/web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java"
click node_cas "https://github.com/ahmd-nabil/spring-security/blob/main/cas/src/main/java/org/springframework/security/cas/authentication/CasAuthenticationProvider.java"
click node_ldap "https://github.com/ahmd-nabil/spring-security/blob/main/ldap/src/main/java/org/springframework/security/ldap/userdetails/LdapUserDetailsService.java"
click node_oauth_registration "https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/registration/ClientRegistration.java"
click node_oauth_userinfo "https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/userinfo/DefaultOAuth2UserService.java"
click node_oidc_userinfo "https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/oidc/userinfo/OidcReactiveOAuth2UserService.java"
click node_saml "https://github.com/ahmd-nabil/spring-security/blob/main/saml2/saml2-service-provider/src/main/java/org/springframework/security/saml2/provider/service/web/Saml2AuthenticationRequestRepository.java"
click node_resource_server "https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-resource-server/src/main/java/org/springframework/security/oauth2/server/resource/authentication/JwtIssuerAuthenticationManagerResolver.java"
click node_web_authorization "https://github.com/ahmd-nabil/spring-security/blob/main/web/src/main/java/org/springframework/security/web/access/intercept/RequestMatcherDelegatingAuthorizationManager.java"
click node_method_security "https://github.com/ahmd-nabil/spring-security/blob/main/config/src/main/java/org/springframework/security/config/annotation/method/configuration/EnableMethodSecurity.java"
click node_acl_identity "https://github.com/ahmd-nabil/spring-security/blob/main/acl/src/main/java/org/springframework/security/acls/model/ObjectIdentity.java"
click node_acl_service "https://github.com/ahmd-nabil/spring-security/blob/main/acl/src/main/java/org/springframework/security/acls/jdbc/JdbcAclService.java"
click node_message_authorization "https://github.com/ahmd-nabil/spring-security/blob/main/messaging/src/main/java/org/springframework/security/messaging/access/intercept/MessageMatcherDelegatingAuthorizationManager.java"
click node_rsocket_authorization "https://github.com/ahmd-nabil/spring-security/blob/main/rsocket/src/main/java/org/springframework/security/rsocket/authorization/PayloadExchangeMatcherReactiveAuthorizationManager.java"
click node_security_configuration "https://github.com/ahmd-nabil/spring-security/blob/main/config/src/main/java/org/springframework/security/config/annotation/AbstractConfiguredSecurityBuilder.java"
click node_authorized_clients "https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.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_authentication,node_authorities,node_user_details,node_user,node_security_context,node_context_executor toneBlue
class node_preauth_service,node_cas,node_ldap,node_oauth_registration,node_oauth_userinfo,node_oidc_userinfo,node_saml,node_resource_server,node_relational_db toneAmber
class node_web_authorization,node_method_security,node_acl_identity,node_acl_service,node_message_authorization,node_rsocket_authorization toneMint
class node_security_configuration toneRose
class node_authorized_clients,node_application toneIndigo
```

## Components

### Identity and Context

- [Authentication](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/Authentication.java): `core/src/main/java/org/springframework/security/core/Authentication.java`
- [Granted Authorities](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/GrantedAuthority.java): `core/src/main/java/org/springframework/security/core/GrantedAuthority.java`
- [User Details](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/userdetails/UserDetails.java): `core/src/main/java/org/springframework/security/core/userdetails/UserDetails.java`
- [User Principal](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/userdetails/User.java): `core/src/main/java/org/springframework/security/core/userdetails/User.java`
- [Security Context](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/core/context/SecurityContextHolder.java): `core/src/main/java/org/springframework/security/core/context/SecurityContextHolder.java`
- [Context Executors](https://github.com/ahmd-nabil/spring-security/blob/main/core/src/main/java/org/springframework/security/concurrent/DelegatingSecurityContextExecutorService.java): `core/src/main/java/org/springframework/security/concurrent/DelegatingSecurityContextExecutorService.java`

### Authentication Protocols

- [Pre-auth User Mapping](https://github.com/ahmd-nabil/spring-security/blob/main/web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java): `web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java`
- [CAS Integration](https://github.com/ahmd-nabil/spring-security/blob/main/cas/src/main/java/org/springframework/security/cas/authentication/CasAuthenticationProvider.java): `cas/src/main/java/org/springframework/security/cas/authentication/CasAuthenticationProvider.java`
- [LDAP Integration](https://github.com/ahmd-nabil/spring-security/blob/main/ldap/src/main/java/org/springframework/security/ldap/userdetails/LdapUserDetailsService.java): `ldap/src/main/java/org/springframework/security/ldap/userdetails/LdapUserDetailsService.java`
- [OAuth Client Registration](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/registration/ClientRegistration.java): `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/registration/ClientRegistration.java`
- [OAuth User Info](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/userinfo/DefaultOAuth2UserService.java): `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/userinfo/DefaultOAuth2UserService.java`
- [OIDC User Info](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/oidc/userinfo/OidcReactiveOAuth2UserService.java): `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/oidc/userinfo/OidcReactiveOAuth2UserService.java`
- [SAML Service Provider](https://github.com/ahmd-nabil/spring-security/blob/main/saml2/saml2-service-provider/src/main/java/org/springframework/security/saml2/provider/service/web/Saml2AuthenticationRequestRepository.java): `saml2/saml2-service-provider/src/main/java/org/springframework/security/saml2/provider/service/web/Saml2AuthenticationRequestRepository.java`
- [Resource Server](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-resource-server/src/main/java/org/springframework/security/oauth2/server/resource/authentication/JwtIssuerAuthenticationManagerResolver.java): `oauth2/oauth2-resource-server/src/main/java/org/springframework/security/oauth2/server/resource/authentication/JwtIssuerAuthenticationManagerResolver.java`

### Authorization

- [Web Authorization](https://github.com/ahmd-nabil/spring-security/blob/main/web/src/main/java/org/springframework/security/web/access/intercept/RequestMatcherDelegatingAuthorizationManager.java): `web/src/main/java/org/springframework/security/web/access/intercept/RequestMatcherDelegatingAuthorizationManager.java`
- [Method Security](https://github.com/ahmd-nabil/spring-security/blob/main/config/src/main/java/org/springframework/security/config/annotation/method/configuration/EnableMethodSecurity.java): `config/src/main/java/org/springframework/security/config/annotation/method/configuration/EnableMethodSecurity.java`
- [ACL Object Identity](https://github.com/ahmd-nabil/spring-security/blob/main/acl/src/main/java/org/springframework/security/acls/model/ObjectIdentity.java): `acl/src/main/java/org/springframework/security/acls/model/ObjectIdentity.java`
- [ACL Services](https://github.com/ahmd-nabil/spring-security/blob/main/acl/src/main/java/org/springframework/security/acls/jdbc/JdbcAclService.java): `acl/src/main/java/org/springframework/security/acls/jdbc/JdbcAclService.java`
- [Message Authorization](https://github.com/ahmd-nabil/spring-security/blob/main/messaging/src/main/java/org/springframework/security/messaging/access/intercept/MessageMatcherDelegatingAuthorizationManager.java): `messaging/src/main/java/org/springframework/security/messaging/access/intercept/MessageMatcherDelegatingAuthorizationManager.java`
- [RSocket Authorization](https://github.com/ahmd-nabil/spring-security/blob/main/rsocket/src/main/java/org/springframework/security/rsocket/authorization/PayloadExchangeMatcherReactiveAuthorizationManager.java): `rsocket/src/main/java/org/springframework/security/rsocket/authorization/PayloadExchangeMatcherReactiveAuthorizationManager.java`

### Application Configuration

- [Security Configuration](https://github.com/ahmd-nabil/spring-security/blob/main/config/src/main/java/org/springframework/security/config/annotation/AbstractConfiguredSecurityBuilder.java): `config/src/main/java/org/springframework/security/config/annotation/AbstractConfiguredSecurityBuilder.java`

### Security State

- [Authorized Client Store](https://github.com/ahmd-nabil/spring-security/blob/main/oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.java): `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.java`

### Other components

- **Spring Application**
- **Relational Database**

## Connections

- Spring Application → Security Configuration: configures (evidence: `README.adoc`)
- Pre-auth User Mapping → Authentication: reads token (evidence: `web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java`)
- Pre-auth User Mapping → User Details: creates details (evidence: `web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java`)
- Pre-auth User Mapping → User Principal: constructs user (evidence: `web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java`)
- Pre-auth User Mapping → Granted Authorities: uses authorities (evidence: `web/src/main/java/org/springframework/security/web/authentication/preauth/PreAuthenticatedGrantedAuthoritiesUserDetailsService.java`)
- Context Executors → Security Context: propagates context (evidence: `core/src/main/java/org/springframework/security/concurrent/DelegatingSecurityContextExecutorService.java`)
- OAuth User Info → OAuth Client Registration: reads registration (evidence: `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/userinfo/DefaultOAuth2UserService.java`)
- OIDC User Info → OAuth Client Registration: reads registration (evidence: `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/oidc/userinfo/OidcReactiveOAuth2UserService.java`)
- Authorized Client Store → OAuth Client Registration: looks up registration (evidence: `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.java`)
- Authorized Client Store → Relational Database: queries and updates (evidence: `oauth2/oauth2-client/src/main/java/org/springframework/security/oauth2/client/JdbcOAuth2AuthorizedClientService.java`)
