# eupassarin/simplesign architecture

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

- Interactive diagram: https://gitdiagram.com/eupassarin/simplesign
- Repository: https://github.com/eupassarin/simplesign

## Overview

SimpleSign is a .NET digital-signature suite for creating, validating, and inspecting PAdES, CAdES, and XAdES documents. The principal workflow is a caller selecting a format and signing profile, producing a signature with a certificate or external signer, then validating it against policy, trust, and revocation information. The repository also includes CLI and desktop-agent entry points, regional trust-framework extensions, a signing/validation TestBench with a PKI sandbox, and an independent HTML-to-PDF utility. Relationships are limited to those explicit in the README or sampled source; unsampled subsystem links are omitted.

Main entry points: [`src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs`](https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs) (PAdES), [`src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs`](https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs) (Conversion pipeline), [`src/Core/SimpleSign.Core/Validation/ValidationOptions.cs`](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Validation/ValidationOptions.cs) (Validation options), [`src/Apps/SimpleSign.Agent/Services/AgentController.cs`](https://github.com/eupassarin/simplesign/blob/main/src/Apps/SimpleSign.Agent/Services/AgentController.cs) (Signing agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_formats["Signature formats"]
  node_pades["PAdES"]
  node_cades["CAdES"]
  node_xades["XAdES"]
end

subgraph group_core["Crypto and trust"]
  node_cms["CMS parsing"]
  node_certs["Certificate loading"]
  node_validation["Validation options"]
  node_chain["Certificate chains"]
  node_ocsp["OCSP checks<br/>[OcspClient.cs]"]
  node_policies["Signature policies<br/>[PolicyNode.cs]"]
end

subgraph group_integrations["Signing integrations"]
  node_pkcs11["PKCS&#35;11 signer<br/>[Pkcs11Signer.cs]"]
  node_cloud["Cloud signing<br/>[CscClient.cs]"]
  node_eidas["eIDAS trust"]
  node_brazil["Brazil extensions"]
  node_iofe["Peru IOFE"]
end

subgraph group_apps["User applications"]
  node_cli["Command line<br/>[Program.cs]"]
  node_agent["Signing agent<br/>[AgentController.cs]"]
  node_testbench["TestBench<br/>[Program.cs]"]
  node_sandbox["Test PKI sandbox<br/>[SandboxApp.cs]"]
end

subgraph group_htmlpdf["HTML to PDF"]
  node_htmlpipeline["Conversion pipeline"]
  node_htmlparser["HTML and CSS<br/>[HtmlNode.cs]"]
  node_style["Style resolution<br/>[ComputedStyle.cs]"]
  node_layout["Page layout<br/>[LayoutEngine.cs]"]
end

node_caller(("Application caller"))

node_caller -->|"sign or validate"| node_pades
node_caller -->|"sign or validate"| node_cades
node_caller -->|"sign or validate"| node_xades
node_pades -->|"configures validation"| node_validation
node_pades -->|"registers checks"| node_ocsp
node_pades -->|"registers chains"| node_chain
node_validation -->|"selects policy"| node_policies
node_caller -->|"sign with token"| node_pkcs11
node_caller -->|"sign remotely"| node_cloud
node_caller -->|"enable trust profile"| node_eidas
node_caller -->|"enable trust profile"| node_brazil
node_caller -->|"enable trust profile"| node_iofe
node_caller -->|"run commands"| node_cli
node_caller -->|"request local signing"| node_agent
node_agent -.->|"serves local API"| node_cli
node_caller -->|"explore options"| node_testbench
node_testbench -.->|"use test PKI"| node_sandbox
node_htmlpipeline -->|"parses documents"| node_htmlparser
node_htmlpipeline -->|"resolves styles"| node_style
node_htmlpipeline -->|"builds page layout"| node_layout
node_caller -->|"convert HTML"| node_htmlpipeline
node_cms -.->|"loads certificates"| node_certs

click node_pades "https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs"
click node_cades "https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.CAdES/CadesServiceCollectionExtensions.cs"
click node_xades "https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.XAdES/XadesServiceCollectionExtensions.cs"
click node_cms "https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Crypto/CmsParserService.cs"
click node_certs "https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Crypto/CertificateLoader.cs"
click node_validation "https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Validation/ValidationOptions.cs"
click node_chain "https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Validation/CertificateChainService.cs"
click node_ocsp "https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Revocation/OcspClient.cs"
click node_policies "https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Policies/PolicyNode.cs"
click node_pkcs11 "https://github.com/eupassarin/simplesign/blob/main/src/Signers/SimpleSign.Signers.Pkcs11/Pkcs11Signer.cs"
click node_cloud "https://github.com/eupassarin/simplesign/blob/main/src/Signers/SimpleSign.Signers.Cloud/Csc/CscClient.cs"
click node_eidas "https://github.com/eupassarin/simplesign/blob/main/src/Extensions/Europe/Eidas/SimpleSign.Europe.Eidas/EidasServiceCollectionExtensions.cs"
click node_brazil "https://github.com/eupassarin/simplesign/blob/main/src/Extensions/Brazil/IcpBrasil/SimpleSign.Brazil.IcpBrasil/IcpBrasilServiceCollectionExtensions.cs"
click node_iofe "https://github.com/eupassarin/simplesign/blob/main/src/Extensions/Peru/Iofe/SimpleSign.Peru.Iofe/IofeServiceCollectionExtensions.cs"
click node_cli "https://github.com/eupassarin/simplesign/blob/main/src/Apps/SimpleSign.Cli/Program.cs"
click node_agent "https://github.com/eupassarin/simplesign/blob/main/src/Apps/SimpleSign.Agent/Services/AgentController.cs"
click node_testbench "https://github.com/eupassarin/simplesign/blob/main/src/Apps/Development/SimpleSign.TestBench/Program.cs"
click node_sandbox "https://github.com/eupassarin/simplesign/blob/main/src/Apps/Development/SimpleSign.Sandbox/SandboxApp.cs"
click node_htmlpipeline "https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs"
click node_htmlparser "https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/Parsing/HtmlNode.cs"
click node_style "https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/Parsing/ComputedStyle.cs"
click node_layout "https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/Layout/LayoutEngine.cs"

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_pades,node_cades,node_xades toneBlue
class node_cms,node_certs,node_validation,node_chain,node_ocsp,node_policies toneAmber
class node_pkcs11,node_cloud,node_eidas,node_brazil,node_iofe toneMint
class node_cli,node_agent,node_testbench,node_sandbox toneRose
class node_htmlpipeline,node_htmlparser,node_style,node_layout,node_caller toneIndigo
```

## Components

### Signature formats

- [PAdES](https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs): `src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs`
- [CAdES](https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.CAdES/CadesServiceCollectionExtensions.cs): `src/Formats/SimpleSign.CAdES/CadesServiceCollectionExtensions.cs`
- [XAdES](https://github.com/eupassarin/simplesign/blob/main/src/Formats/SimpleSign.XAdES/XadesServiceCollectionExtensions.cs): `src/Formats/SimpleSign.XAdES/XadesServiceCollectionExtensions.cs`

### Crypto and trust

- [CMS parsing](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Crypto/CmsParserService.cs): `src/Core/SimpleSign.Core/Crypto/CmsParserService.cs`
- [Certificate loading](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Crypto/CertificateLoader.cs): `src/Core/SimpleSign.Core/Crypto/CertificateLoader.cs`
- [Validation options](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Validation/ValidationOptions.cs): `src/Core/SimpleSign.Core/Validation/ValidationOptions.cs`
- [Certificate chains](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Validation/CertificateChainService.cs): `src/Core/SimpleSign.Core/Validation/CertificateChainService.cs`
- [OCSP checks](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Revocation/OcspClient.cs): `src/Core/SimpleSign.Core/Revocation/OcspClient.cs`
- [Signature policies](https://github.com/eupassarin/simplesign/blob/main/src/Core/SimpleSign.Core/Policies/PolicyNode.cs): `src/Core/SimpleSign.Core/Policies/PolicyNode.cs`

### Signing integrations

- [PKCS#11 signer](https://github.com/eupassarin/simplesign/blob/main/src/Signers/SimpleSign.Signers.Pkcs11/Pkcs11Signer.cs): `src/Signers/SimpleSign.Signers.Pkcs11/Pkcs11Signer.cs`
- [Cloud signing](https://github.com/eupassarin/simplesign/blob/main/src/Signers/SimpleSign.Signers.Cloud/Csc/CscClient.cs): `src/Signers/SimpleSign.Signers.Cloud/Csc/CscClient.cs`
- [eIDAS trust](https://github.com/eupassarin/simplesign/blob/main/src/Extensions/Europe/Eidas/SimpleSign.Europe.Eidas/EidasServiceCollectionExtensions.cs): `src/Extensions/Europe/Eidas/SimpleSign.Europe.Eidas/EidasServiceCollectionExtensions.cs`
- [Brazil extensions](https://github.com/eupassarin/simplesign/blob/main/src/Extensions/Brazil/IcpBrasil/SimpleSign.Brazil.IcpBrasil/IcpBrasilServiceCollectionExtensions.cs): `src/Extensions/Brazil/IcpBrasil/SimpleSign.Brazil.IcpBrasil/IcpBrasilServiceCollectionExtensions.cs`
- [Peru IOFE](https://github.com/eupassarin/simplesign/blob/main/src/Extensions/Peru/Iofe/SimpleSign.Peru.Iofe/IofeServiceCollectionExtensions.cs): `src/Extensions/Peru/Iofe/SimpleSign.Peru.Iofe/IofeServiceCollectionExtensions.cs`

### User applications

- [Command line](https://github.com/eupassarin/simplesign/blob/main/src/Apps/SimpleSign.Cli/Program.cs): `src/Apps/SimpleSign.Cli/Program.cs`
- [Signing agent](https://github.com/eupassarin/simplesign/blob/main/src/Apps/SimpleSign.Agent/Services/AgentController.cs): `src/Apps/SimpleSign.Agent/Services/AgentController.cs`
- [TestBench](https://github.com/eupassarin/simplesign/blob/main/src/Apps/Development/SimpleSign.TestBench/Program.cs): `src/Apps/Development/SimpleSign.TestBench/Program.cs`
- [Test PKI sandbox](https://github.com/eupassarin/simplesign/blob/main/src/Apps/Development/SimpleSign.Sandbox/SandboxApp.cs): `src/Apps/Development/SimpleSign.Sandbox/SandboxApp.cs`

### HTML to PDF

- [Conversion pipeline](https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs): `src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs`
- [HTML and CSS](https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/Parsing/HtmlNode.cs): `src/Extras/SimpleSign.HtmlToPdf/Parsing/HtmlNode.cs`
- [Style resolution](https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/Parsing/ComputedStyle.cs): `src/Extras/SimpleSign.HtmlToPdf/Parsing/ComputedStyle.cs`
- [Page layout](https://github.com/eupassarin/simplesign/blob/main/src/Extras/SimpleSign.HtmlToPdf/Layout/LayoutEngine.cs): `src/Extras/SimpleSign.HtmlToPdf/Layout/LayoutEngine.cs`

### Other components

- **Application caller**

## Connections

- Application caller → PAdES: sign or validate (evidence: `README.md`)
- Application caller → CAdES: sign or validate (evidence: `README.md`)
- Application caller → XAdES: sign or validate (evidence: `README.md`)
- PAdES → Validation options: configures validation (evidence: `src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs`)
- PAdES → OCSP checks: registers checks (evidence: `src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs`)
- PAdES → Certificate chains: registers chains (evidence: `src/Formats/SimpleSign.PAdES/DependencyInjection/SimpleSignServiceCollectionExtensions.cs`)
- Validation options → Signature policies: selects policy (evidence: `src/Core/SimpleSign.Core/Validation/ValidationOptions.cs`)
- Application caller → PKCS#11 signer: sign with token (evidence: `README.md`)
- Application caller → Cloud signing: sign remotely (evidence: `README.md`)
- Application caller → eIDAS trust: enable trust profile (evidence: `README.md`)
- Application caller → Brazil extensions: enable trust profile (evidence: `README.md`)
- Application caller → Peru IOFE: enable trust profile (evidence: `README.md`)
- Application caller → Command line: run commands (evidence: `README.md`)
- Application caller → Signing agent: request local signing (evidence: `README.md`)
- Signing agent → Command line: serves local API
- Application caller → TestBench: explore options (evidence: `README.md`)
- TestBench → Test PKI sandbox: use test PKI
- Conversion pipeline → HTML and CSS: parses documents (evidence: `src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs`)
- Conversion pipeline → Style resolution: resolves styles (evidence: `src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs`)
- Conversion pipeline → Page layout: builds page layout (evidence: `src/Extras/SimpleSign.HtmlToPdf/ConversionPipeline.cs`)
- Application caller → Conversion pipeline: convert HTML (evidence: `README.md`)
- CMS parsing → Certificate loading: loads certificates
