# susom/apache-proxy architecture

> Architecture diagram of the GitHub repository susom/apache-proxy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/susom/apache-proxy
- Repository: https://github.com/susom/apache-proxy

## Overview

This repository is a Docker-based Apache reverse proxy that adds OpenID Connect authentication in front of an application. The documented request path is a user reaching the proxy, which performs OIDC authentication and proxies to the protected application. The test directory supplies example configuration and instructions. Source excerpts were not available, so the graph relies on the README and does not infer how individual sample files configure the runtime.

Main entry points: [`apache-oidc/Dockerfile`](https://github.com/susom/apache-proxy/blob/master/apache-oidc/Dockerfile) (Apache proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Proxy runtime"]
  node_proxy["Apache proxy"]
  node_oidc["OIDC authentication"]
end

subgraph group_examples["Example setup"]
  node_samples["Sample configuration"]
end

node_user(("User"))
node_application["Protected application"]

node_user -->|"sends requests"| node_proxy
node_proxy -->|"authenticates with"| node_oidc
node_proxy -->|"proxies requests"| node_application

click node_proxy "https://github.com/susom/apache-proxy/blob/master/apache-oidc/Dockerfile"
click node_oidc "https://github.com/susom/apache-proxy/blob/master/apache-oidc/Dockerfile"
click node_samples "https://github.com/susom/apache-proxy/tree/master/apache-oidc-test"

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_proxy,node_oidc,node_user toneBlue
class node_samples toneAmber
class node_application toneIndigo
```

## Components

### Proxy runtime

- [Apache proxy](https://github.com/susom/apache-proxy/blob/master/apache-oidc/Dockerfile): `apache-oidc/Dockerfile`
- [OIDC authentication](https://github.com/susom/apache-proxy/blob/master/apache-oidc/Dockerfile): `apache-oidc/Dockerfile`

### Example setup

- [Sample configuration](https://github.com/susom/apache-proxy/tree/master/apache-oidc-test): `apache-oidc-test`

### Other components

- **User**
- **Protected application**

## Connections

- User → Apache proxy: sends requests (evidence: `README.md`)
- Apache proxy → OIDC authentication: authenticates with (evidence: `README.md`)
- Apache proxy → Protected application: proxies requests (evidence: `README.md`)
