# paulveillard/cybersecurity-pam architecture

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

- Interactive diagram: https://gitdiagram.com/paulveillard/cybersecurity-pam
- Repository: https://github.com/paulveillard/cybersecurity-pam

## Overview

This repository is primarily a curated PAM security-resource collection, organized across Linux, Windows, cross-platform, Docker, and cloud topics. It also bundles a runnable PAM authentication script: PAM supplies request data and a compressed, base64 SAML assertion; the script parses and validates it, then matches the assertion’s user attribute before returning success. The resource categories come from the README; the script’s internal stages are visible in its source. The README excerpt and sampled files do not establish further runtime wiring.

Main entry points: [`pam-script-saml/pam-script-saml.php`](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php) (PAM SAML script), [`README.md`](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md) (Curated resources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Resource collection"]
  node_curated_resources["Curated resources<br/>[README.md]"]
  node_linux_resources["Linux resources<br/>[README.md]"]
  node_windows_resources["Windows resources<br/>[README.md]"]
  node_cross_platform_resources["Linux and Windows<br/>[README.md]"]
  node_docker_resources["Docker resources<br/>[README.md]"]
  node_cloud_resources["Cloud resources<br/>[README.md]"]
end

subgraph group_auth["PAM authentication"]
  node_pam_client(("PAM request"))
  node_pam_script["PAM SAML script"]
  node_auth_result["Authentication result"]
end

subgraph group_validation["Assertion checks"]
  node_assertion_decode["Decode assertion"]
  node_assertion_parse["Parse assertion"]
  node_idp_signature["IdP signature check"]
  node_assertion_rules["Assertion validation"]
  node_audience_check["Audience match"]
  node_user_match["PAM user match"]
end

node_lightsaml["LightSAML library"]

node_curated_resources -->|"organizes"| node_linux_resources
node_curated_resources -->|"organizes"| node_windows_resources
node_curated_resources -->|"organizes"| node_cross_platform_resources
node_curated_resources -->|"organizes"| node_docker_resources
node_curated_resources -->|"organizes"| node_cloud_resources
node_pam_client -->|"provides request"| node_pam_script
node_pam_script -->|"decodes input"| node_assertion_decode
node_pam_script -->|"parses XML"| node_assertion_parse
node_pam_script -->|"checks signature"| node_idp_signature
node_pam_script -->|"validates rules"| node_assertion_rules
node_pam_script -->|"checks audience"| node_audience_check
node_pam_script -->|"matches username"| node_user_match
node_pam_script -->|"uses"| node_lightsaml
node_pam_script -->|"returns status"| node_auth_result

click node_curated_resources "https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md"
click node_linux_resources "https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md"
click node_windows_resources "https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md"
click node_cross_platform_resources "https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md"
click node_docker_resources "https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md"
click node_cloud_resources "https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md"
click node_pam_script "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"
click node_assertion_decode "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"
click node_assertion_parse "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"
click node_idp_signature "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"
click node_assertion_rules "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"
click node_audience_check "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"
click node_user_match "https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php"

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_curated_resources,node_linux_resources,node_windows_resources,node_cross_platform_resources,node_docker_resources,node_cloud_resources toneBlue
class node_pam_client,node_pam_script,node_auth_result toneAmber
class node_assertion_decode,node_assertion_parse,node_idp_signature,node_assertion_rules,node_audience_check,node_user_match toneMint
class node_lightsaml toneIndigo
```

## Components

### Resource collection

- [Curated resources](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md): `README.md`
- [Linux resources](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md): `README.md`
- [Windows resources](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md): `README.md`
- [Linux and Windows](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md): `README.md`
- [Docker resources](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md): `README.md`
- [Cloud resources](https://github.com/paulveillard/cybersecurity-pam/blob/main/README.md): `README.md`

### PAM authentication

- **PAM request**
- [PAM SAML script](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`
- **Authentication result**

### Assertion checks

- [Decode assertion](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`
- [Parse assertion](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`
- [IdP signature check](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`
- [Assertion validation](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`
- [Audience match](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`
- [PAM user match](https://github.com/paulveillard/cybersecurity-pam/blob/main/pam-script-saml/pam-script-saml.php): `pam-script-saml/pam-script-saml.php`

### Other components

- **LightSAML library**

## Connections

- Curated resources → Linux resources: organizes (evidence: `README.md`)
- Curated resources → Windows resources: organizes (evidence: `README.md`)
- Curated resources → Linux and Windows: organizes (evidence: `README.md`)
- Curated resources → Docker resources: organizes (evidence: `README.md`)
- Curated resources → Cloud resources: organizes (evidence: `README.md`)
- PAM request → PAM SAML script: provides request (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → Decode assertion: decodes input (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → Parse assertion: parses XML (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → IdP signature check: checks signature (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → Assertion validation: validates rules (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → Audience match: checks audience (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → PAM user match: matches username (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → LightSAML library: uses (evidence: `pam-script-saml/pam-script-saml.php`)
- PAM SAML script → Authentication result: returns status (evidence: `pam-script-saml/pam-script-saml.php`)
