# damienbod/angular-auth-oidc-client architecture

> Architecture diagram of the GitHub repository damienbod/angular-auth-oidc-client, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/damienbod/angular-auth-oidc-client
- Repository: https://github.com/damienbod/angular-auth-oidc-client

## Overview

This repository is an Angular OpenID Connect/OAuth2 client library. An Angular application supplies provider configuration and calls the public security service; the library processes login redirects, validates the response, exposes authentication/user state, and can attach access tokens to protected HTTP requests. Separate branches cover login variants, renewal and session management, logout/revocation, and configuration discovery. The README documents these capabilities; sampled sources confirm key check-auth, guard, renewal, iframe, and persistence relationships. Several feature links use tree-supported paths because their implementations were not sampled.

Main entry points: [`projects/angular-auth-oidc-client/src/lib/oidc.security.service.ts`](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/oidc.security.service.ts) (Security service), [`projects/angular-auth-oidc-client/src/lib/auth-state/check-auth.service.ts`](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/auth-state/check-auth.service.ts) (Authentication check), [`projects/angular-auth-oidc-client/src/lib/storage/storage-persistence.service.ts`](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/storage/storage-persistence.service.ts) (Persistence layer), [`projects/angular-auth-oidc-client/src/lib/callback/refresh-session.service.ts`](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/callback/refresh-session.service.ts) (Token renewal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and configuration"]
  node_config["Configuration<br/>[config.service.ts]"]
  node_discovery["Provider discovery"]
end

subgraph group_auth["Authentication flows"]
  node_login["Login dispatch<br/>[login.service.ts]"]
  node_standard["Code and implicit"]
  node_par["Pushed requests"]
  node_popup["Popup login"]
  node_callback["Callback processing"]
  node_handlers["Flow handlers"]
  node_logout["Logout and revoke"]
end

subgraph group_session["Session and state"]
  node_validation["Token validation"]
  node_checkauth["Authentication check"]
  node_state["Auth state"]
  node_user["User data<br/>[user.service.ts]"]
  node_storage["Persistence layer"]
  node_browserstorage["Browser storage"]
  node_renew["Token renewal"]
  node_iframe["Session iframe"]
end

subgraph group_integration["App integration"]
  node_oidc["Security service"]
  node_interceptor["HTTP interceptor"]
  node_events["Public events"]
end

node_app(("Angular app"))
node_idp(("OIDC provider"))
node_api(("Protected API"))
node_browser[("Browser storage")]

node_app -->|"supplies config"| node_config
node_app -->|"calls"| node_oidc
node_oidc -->|"checks auth"| node_checkauth
node_oidc -->|"starts login"| node_login
node_oidc -->|"renews tokens"| node_renew
node_oidc -->|"logs off"| node_logout
node_config -->|"loads metadata"| node_discovery
node_discovery -->|"requests metadata"| node_idp
node_login -->|"dispatches"| node_standard
node_login -.->|"dispatches PAR"| node_par
node_login -.->|"dispatches popup"| node_popup
node_standard -->|"redirects for login"| node_idp
node_par -.->|"submits request"| node_idp
node_popup -.->|"opens authorization"| node_idp
node_checkauth -->|"processes callback"| node_callback
node_callback -->|"dispatches flow"| node_handlers
node_handlers -->|"validates tokens"| node_validation
node_checkauth -->|"checks tokens"| node_state
node_checkauth -->|"publishes user"| node_user
node_checkauth -->|"starts session checks"| node_iframe
node_checkauth -->|"renews when needed"| node_renew
node_state -->|"reads auth tokens"| node_storage
node_user -->|"reads user data"| node_storage
node_renew -->|"loads endpoints"| node_discovery
node_renew -->|"requests token refresh"| node_idp
node_renew -->|"persists renewal state"| node_storage
node_iframe -->|"checks session"| node_idp
node_iframe -->|"reads session state"| node_storage
node_storage -->|"reads and writes"| node_browserstorage
node_browserstorage -->|"persists data"| node_browser
node_oidc -->|"publishes events"| node_events
node_app -->|"configures interceptor"| node_interceptor
node_interceptor -->|"gets access token"| node_oidc
node_interceptor -->|"adds bearer token"| node_api
node_logout -->|"ends session"| node_idp
node_logout -->|"clears auth data"| node_storage

click node_oidc "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/oidc.security.service.ts"
click node_config "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/config/config.service.ts"
click node_discovery "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/config/auth-well-known/auth-well-known.service.ts"
click node_login "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/login.service.ts"
click node_standard "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/standard/standard-login.service.ts"
click node_par "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/par/par-login.service.ts"
click node_popup "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/popup/popup-login.service.ts"
click node_callback "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/callback/callback.service.ts"
click node_handlers "https://github.com/damienbod/angular-auth-oidc-client/tree/main/projects/angular-auth-oidc-client/src/lib/flows/callback-handling"
click node_validation "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/validation/token-validation.service.ts"
click node_checkauth "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/auth-state/check-auth.service.ts"
click node_state "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/auth-state/auth-state.service.ts"
click node_user "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/user-data/user.service.ts"
click node_storage "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/storage/storage-persistence.service.ts"
click node_browserstorage "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/storage/browser-storage.service.ts"
click node_renew "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/callback/refresh-session.service.ts"
click node_iframe "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/iframe/check-session.service.ts"
click node_logout "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/logoff-revoke/logoff-revocation.service.ts"
click node_interceptor "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/interceptor/auth.interceptor.ts"
click node_events "https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/public-events/public-events.service.ts"

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_config,node_discovery toneBlue
class node_login,node_standard,node_par,node_popup,node_callback,node_handlers,node_logout,node_browser toneAmber
class node_validation,node_checkauth,node_state,node_user,node_storage,node_browserstorage,node_renew,node_iframe,node_api toneMint
class node_oidc,node_interceptor,node_events toneRose
class node_app,node_idp toneIndigo
```

## Components

### Setup and configuration

- [Configuration](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/config/config.service.ts): `projects/angular-auth-oidc-client/src/lib/config/config.service.ts`
- [Provider discovery](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/config/auth-well-known/auth-well-known.service.ts): `projects/angular-auth-oidc-client/src/lib/config/auth-well-known/auth-well-known.service.ts`

### Authentication flows

- [Login dispatch](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/login.service.ts): `projects/angular-auth-oidc-client/src/lib/login/login.service.ts`
- [Code and implicit](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/standard/standard-login.service.ts): `projects/angular-auth-oidc-client/src/lib/login/standard/standard-login.service.ts`
- [Pushed requests](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/par/par-login.service.ts): `projects/angular-auth-oidc-client/src/lib/login/par/par-login.service.ts`
- [Popup login](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/login/popup/popup-login.service.ts): `projects/angular-auth-oidc-client/src/lib/login/popup/popup-login.service.ts`
- [Callback processing](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/callback/callback.service.ts): `projects/angular-auth-oidc-client/src/lib/callback/callback.service.ts`
- [Flow handlers](https://github.com/damienbod/angular-auth-oidc-client/tree/main/projects/angular-auth-oidc-client/src/lib/flows/callback-handling): `projects/angular-auth-oidc-client/src/lib/flows/callback-handling`
- [Logout and revoke](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/logoff-revoke/logoff-revocation.service.ts): `projects/angular-auth-oidc-client/src/lib/logoff-revoke/logoff-revocation.service.ts`

### Session and state

- [Token validation](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/validation/token-validation.service.ts): `projects/angular-auth-oidc-client/src/lib/validation/token-validation.service.ts`
- [Authentication check](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/auth-state/check-auth.service.ts): `projects/angular-auth-oidc-client/src/lib/auth-state/check-auth.service.ts`
- [Auth state](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/auth-state/auth-state.service.ts): `projects/angular-auth-oidc-client/src/lib/auth-state/auth-state.service.ts`
- [User data](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/user-data/user.service.ts): `projects/angular-auth-oidc-client/src/lib/user-data/user.service.ts`
- [Persistence layer](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/storage/storage-persistence.service.ts): `projects/angular-auth-oidc-client/src/lib/storage/storage-persistence.service.ts`
- [Browser storage](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/storage/browser-storage.service.ts): `projects/angular-auth-oidc-client/src/lib/storage/browser-storage.service.ts`
- [Token renewal](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/callback/refresh-session.service.ts): `projects/angular-auth-oidc-client/src/lib/callback/refresh-session.service.ts`
- [Session iframe](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/iframe/check-session.service.ts): `projects/angular-auth-oidc-client/src/lib/iframe/check-session.service.ts`

### App integration

- [Security service](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/oidc.security.service.ts): `projects/angular-auth-oidc-client/src/lib/oidc.security.service.ts`
- [HTTP interceptor](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/interceptor/auth.interceptor.ts): `projects/angular-auth-oidc-client/src/lib/interceptor/auth.interceptor.ts`
- [Public events](https://github.com/damienbod/angular-auth-oidc-client/blob/main/projects/angular-auth-oidc-client/src/lib/public-events/public-events.service.ts): `projects/angular-auth-oidc-client/src/lib/public-events/public-events.service.ts`

### Other components

- **Angular app**
- **OIDC provider**
- **Protected API**
- **Browser storage**

## Connections

- Angular app → Configuration: supplies config
- Angular app → Security service: calls
- Security service → Authentication check: checks auth
- Security service → Login dispatch: starts login
- Security service → Token renewal: renews tokens
- Security service → Logout and revoke: logs off
- Configuration → Provider discovery: loads metadata
- Provider discovery → OIDC provider: requests metadata
- Login dispatch → Code and implicit: dispatches
- Login dispatch → Pushed requests: dispatches PAR
- Login dispatch → Popup login: dispatches popup
- Code and implicit → OIDC provider: redirects for login
- Pushed requests → OIDC provider: submits request
- Popup login → OIDC provider: opens authorization
- Authentication check → Callback processing: processes callback
- Callback processing → Flow handlers: dispatches flow
- Flow handlers → Token validation: validates tokens
- Authentication check → Auth state: checks tokens
- Authentication check → User data: publishes user
- Authentication check → Session iframe: starts session checks
- Authentication check → Token renewal: renews when needed
- Auth state → Persistence layer: reads auth tokens
- User data → Persistence layer: reads user data
- Token renewal → Provider discovery: loads endpoints
- Token renewal → OIDC provider: requests token refresh
- Token renewal → Persistence layer: persists renewal state
- Session iframe → OIDC provider: checks session
- Session iframe → Persistence layer: reads session state
- Persistence layer → Browser storage: reads and writes
- Browser storage → Browser storage: persists data
- Security service → Public events: publishes events
- Angular app → HTTP interceptor: configures interceptor
- HTTP interceptor → Security service: gets access token
- HTTP interceptor → Protected API: adds bearer token
- Logout and revoke → OIDC provider: ends session
- Logout and revoke → Persistence layer: clears auth data
