# mat-bano/oauth2-projekt architecture

> Architecture diagram of the GitHub repository mat-bano/oauth2-projekt, 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/mat-bano/oauth2-projekt
- Repository: https://github.com/mat-bano/oauth2-projekt

## Overview

This is a deliberately vulnerable OAuth2 Authorization Code Flow CTF lab, served as a single Node.js application. The main user workflow is to open one of four tasks, exploit a flaw in authorization or token exchange, obtain a flag, and submit it to update browser-specific progress. The app also provides login sessions and resource endpoints for userinfo and admin data. The source is a partial excerpt, so documented README behavior fills in some endpoint relationships; internal implementation details not shown are not inferred.

Main entry points: [`podatna_strona/app.js`](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js) (Authorization endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lab["CTF Lab"]
  node_task_ui["Task pages<br/>[app.js]"]
  node_flag_submit["Flag submission<br/>[app.js]"]
  node_progress_ui["Progress display<br/>[app.js]"]
  node_attacker["Code capture endpoint<br/>[app.js]"]
end

subgraph group_identity["OAuth Identity"]
  node_login["Login and logout<br/>[app.js]"]
  node_authorize["Authorization endpoint<br/>[app.js]"]
  node_callback["Client callback<br/>[app.js]"]
  node_token["Token endpoint<br/>[app.js]"]
end

subgraph group_resources["Resource Server"]
  node_userinfo["Userinfo endpoint<br/>[app.js]"]
  node_admin["Admin endpoint<br/>[app.js]"]
end

subgraph group_state["Application State"]
  node_sessions[("Login sessions<br/>[app.js]")]
  node_auth_codes[("Authorization codes<br/>[app.js]")]
  node_access_tokens[("Access tokens<br/>[app.js]")]
  node_progress[("Completion state<br/>[app.js]")]
end

node_browser(("Player browser"))
node_burp(("Burp Suite"))

node_browser -->|"opens tasks"| node_task_ui
node_burp -->|"modifies request"| node_authorize
node_burp -->|"modifies request"| node_token
node_task_ui -->|"starts login"| node_authorize
node_authorize -->|"requires login"| node_login
node_login -->|"stores session"| node_sessions
node_authorize -->|"issues code"| node_auth_codes
node_authorize -->|"redirects code"| node_callback
node_authorize -->|"redirects code"| node_attacker
node_callback -->|"exchanges code"| node_token
node_token -->|"reads code"| node_auth_codes
node_token -->|"issues token"| node_access_tokens
node_browser -->|"requests profile"| node_userinfo
node_userinfo -->|"checks token"| node_access_tokens
node_browser -->|"requests admin"| node_admin
node_admin -->|"checks scope"| node_access_tokens
node_browser -->|"submits flag"| node_flag_submit
node_flag_submit -->|"records completion"| node_progress
node_progress_ui -->|"reads progress"| node_progress
node_task_ui -->|"shows completion"| node_progress_ui

click node_task_ui "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_flag_submit "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_progress_ui "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_login "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_sessions "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_authorize "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_auth_codes "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_callback "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_token "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_access_tokens "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_attacker "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_userinfo "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_admin "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"
click node_progress "https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js"

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_task_ui,node_flag_submit,node_progress_ui,node_attacker,node_browser toneBlue
class node_login,node_authorize,node_callback,node_token toneAmber
class node_userinfo,node_admin toneMint
class node_sessions,node_auth_codes,node_access_tokens,node_progress toneRose
class node_burp toneIndigo
```

## Components

### CTF Lab

- [Task pages](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Flag submission](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Progress display](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Code capture endpoint](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`

### OAuth Identity

- [Login and logout](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Authorization endpoint](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Client callback](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Token endpoint](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`

### Resource Server

- [Userinfo endpoint](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Admin endpoint](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`

### Application State

- [Login sessions](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Authorization codes](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Access tokens](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`
- [Completion state](https://github.com/mat-bano/oauth2-projekt/blob/main/podatna_strona/app.js): `podatna_strona/app.js`

### Other components

- **Player browser**
- **Burp Suite**

## Connections

- Player browser → Task pages: opens tasks (evidence: `README.md`)
- Burp Suite → Authorization endpoint: modifies request (evidence: `README.md`)
- Burp Suite → Token endpoint: modifies request (evidence: `README.md`)
- Task pages → Authorization endpoint: starts login (evidence: `README.md`)
- Authorization endpoint → Login and logout: requires login (evidence: `podatna_strona/app.js`)
- Login and logout → Login sessions: stores session (evidence: `podatna_strona/app.js`)
- Authorization endpoint → Authorization codes: issues code (evidence: `README.md`)
- Authorization endpoint → Client callback: redirects code (evidence: `README.md`)
- Authorization endpoint → Code capture endpoint: redirects code (evidence: `README.md`)
- Client callback → Token endpoint: exchanges code (evidence: `podatna_strona/app.js`)
- Token endpoint → Authorization codes: reads code (evidence: `README.md`)
- Token endpoint → Access tokens: issues token (evidence: `README.md`)
- Player browser → Userinfo endpoint: requests profile (evidence: `README.md`)
- Userinfo endpoint → Access tokens: checks token (evidence: `podatna_strona/app.js`)
- Player browser → Admin endpoint: requests admin (evidence: `README.md`)
- Admin endpoint → Access tokens: checks scope (evidence: `README.md`)
- Player browser → Flag submission: submits flag (evidence: `README.md`)
- Flag submission → Completion state: records completion (evidence: `podatna_strona/app.js`)
- Progress display → Completion state: reads progress (evidence: `podatna_strona/app.js`)
- Task pages → Progress display: shows completion (evidence: `podatna_strona/app.js`)
