# sathish27438/appsec architecture

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

- Interactive diagram: https://gitdiagram.com/sathish27438/appsec
- Repository: https://github.com/sathish27438/appsec

## Overview

This repository is a small collection of vulnerable authentication examples, not a shared application. Its principal workflow is submitting credentials to a login routine and observing the result; the examples illustrate timing-based username disclosure and IP-based attempt blocking. The standalone brute-force example is incomplete, so the graph reflects only its visible login stub and database reference. The README is empty, and no claims are made about the uninspected YAML or test file.

Main entry points: [`Flask_bF_vuln.py`](https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py) (Credential check), [`ip_block_vuln.py`](https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py) (Flask login route), [`brute_vuln.py`](https://github.com/sathish27438/appsec/blob/main/brute_vuln.py) (Login stub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_timing["Timing examples"]
  node_flask_route["Flask login route<br/>[Flask_bF_vuln.py]"]
  node_flask_check["Credential check<br/>[Flask_bF_vuln.py]"]
  node_flask_users[("Credential map<br/>[Flask_bF_vuln.py]")]
  node_delay["Sleep delay<br/>[Flask_bF_vuln.py]"]
  node_brute_runner["Demo runner<br/>[brute_vuln.py]"]
  node_brute_login["Login stub<br/>[brute_vuln.py]"]
  node_brute_db[("Credential map<br/>[brute_vuln.py]")]
end

subgraph group_blocking["Attempt blocking"]
  node_ip_route["Flask login route<br/>[ip_block_vuln.py]"]
  node_ip_check["Credential check<br/>[ip_block_vuln.py]"]
  node_ip_users[("Credential map<br/>[ip_block_vuln.py]")]
  node_attempt_state[("Failed attempts<br/>[ip_block_vuln.py]")]
end

node_user(("Requester"))

node_user -->|"submits credentials"| node_flask_route
node_flask_route -->|"checks credentials"| node_flask_check
node_flask_check -->|"looks up account"| node_flask_users
node_flask_check -->|"sleeps for known users"| node_delay
node_brute_runner -->|"calls login"| node_brute_login
node_brute_login -->|"checks account"| node_brute_db
node_user -->|"submits credentials"| node_ip_route
node_ip_route -->|"checks and updates"| node_attempt_state
node_ip_route -->|"checks credentials"| node_ip_check
node_ip_check -->|"looks up account"| node_ip_users

click node_flask_route "https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py"
click node_flask_check "https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py"
click node_flask_users "https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py"
click node_delay "https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py"
click node_brute_runner "https://github.com/sathish27438/appsec/blob/main/brute_vuln.py"
click node_brute_login "https://github.com/sathish27438/appsec/blob/main/brute_vuln.py"
click node_brute_db "https://github.com/sathish27438/appsec/blob/main/brute_vuln.py"
click node_ip_route "https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py"
click node_ip_check "https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py"
click node_ip_users "https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py"
click node_attempt_state "https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py"

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_flask_route,node_flask_check,node_flask_users,node_delay,node_brute_runner,node_brute_login,node_brute_db toneBlue
class node_ip_route,node_ip_check,node_ip_users,node_attempt_state toneAmber
class node_user toneMint
```

## Components

### Timing examples

- [Flask login route](https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py): `Flask_bF_vuln.py`
- [Credential check](https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py): `Flask_bF_vuln.py`
- [Credential map](https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py): `Flask_bF_vuln.py`
- [Sleep delay](https://github.com/sathish27438/appsec/blob/main/Flask_bF_vuln.py): `Flask_bF_vuln.py`
- [Demo runner](https://github.com/sathish27438/appsec/blob/main/brute_vuln.py): `brute_vuln.py`
- [Login stub](https://github.com/sathish27438/appsec/blob/main/brute_vuln.py): `brute_vuln.py`
- [Credential map](https://github.com/sathish27438/appsec/blob/main/brute_vuln.py): `brute_vuln.py`

### Attempt blocking

- [Flask login route](https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py): `ip_block_vuln.py`
- [Credential check](https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py): `ip_block_vuln.py`
- [Credential map](https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py): `ip_block_vuln.py`
- [Failed attempts](https://github.com/sathish27438/appsec/blob/main/ip_block_vuln.py): `ip_block_vuln.py`

### Other components

- **Requester**

## Connections

- Requester → Flask login route: submits credentials (evidence: `Flask_bF_vuln.py`)
- Flask login route → Credential check: checks credentials (evidence: `Flask_bF_vuln.py`)
- Credential check → Credential map: looks up account (evidence: `Flask_bF_vuln.py`)
- Credential check → Sleep delay: sleeps for known users (evidence: `Flask_bF_vuln.py`)
- Demo runner → Login stub: calls login (evidence: `brute_vuln.py`)
- Login stub → Credential map: checks account (evidence: `brute_vuln.py`)
- Requester → Flask login route: submits credentials (evidence: `ip_block_vuln.py`)
- Flask login route → Failed attempts: checks and updates (evidence: `ip_block_vuln.py`)
- Flask login route → Credential check: checks credentials (evidence: `ip_block_vuln.py`)
- Credential check → Credential map: looks up account (evidence: `ip_block_vuln.py`)
