# kokinf/miniminpki architecture

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

- Interactive diagram: https://gitdiagram.com/kokinf/miniminpki
- Repository: https://github.com/kokinf/miniminpki

## Overview

MiniminPKI is a Go PKI tool whose CLI manages a certificate lifecycle: establish root and intermediate CAs, issue certificates, publish them through an HTTP repository, and support revocation and status checks. Client commands generate and submit CSRs, validate chains, check revocation, and perform code signing. Supporting capabilities include policy enforcement, audit integrity, rate limiting, and simulated Certificate Transparency. The README documents several integrations and workflows; where source excerpts do not show wiring, links are included only when the README explicitly describes them.

Main entry points: [`internal/cli/root.go`](https://github.com/kokinf/miniminpki/blob/main/internal/cli/root.go) (Command interface), [`internal/ca/ca.go`](https://github.com/kokinf/miniminpki/blob/main/internal/ca/ca.go) (Certificate issuance), [`internal/client`](https://github.com/kokinf/miniminpki/tree/main/internal/client) (Client tools), [`internal/repository/server.go`](https://github.com/kokinf/miniminpki/blob/main/internal/repository/server.go) (HTTP repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and clients"]
  node_cli["Command interface<br/>[root.go]"]
  node_clienttools["Client tools"]
  node_csr["CSR generation<br/>[csr.go]"]
  node_revocationcheck["Status checking<br/>[revocation.go]"]
  node_codesigning["Code signing<br/>[sign.go]"]
  node_chainvalidation["Chain validation<br/>[validate.go]"]
  node_validation["Certificate checks<br/>[validator.go]"]
end

subgraph group_issuance["CA and issuance"]
  node_rootca["Root CA<br/>[ca.go]"]
  node_certificateissue["Certificate issuance<br/>[ca.go]"]
  node_certificates["Certificate generation<br/>[generate.go]"]
  node_templates["Certificate templates<br/>[templates.go]"]
  node_san["SAN parsing<br/>[parser.go]"]
  node_policy["CA policies<br/>[generator.go]"]
end

subgraph group_status["Repository and status"]
  node_repository["HTTP repository<br/>[server.go]"]
  node_database[("Certificate database<br/>[database.go]")]
  node_crl["CRL generation<br/>[generator.go]"]
  node_ocsp["OCSP responder<br/>[responder.go]"]
end

subgraph group_security["Security and records"]
  node_audit[("Audit log<br/>[logger.go]")]
  node_ratelimit["Rate limiter<br/>[limiter.go]"]
  node_transparency["CT simulation<br/>[ct.go]"]
  node_keysecurity["Compromised keys<br/>[database.go]"]
end

node_operator(("PKI operator"))

node_operator -->|"runs commands"| node_cli
node_cli -->|"manages CA"| node_rootca
node_cli -->|"issues certificates"| node_certificateissue
node_cli -->|"starts server"| node_repository
node_cli -->|"starts responder"| node_ocsp
node_cli -->|"runs client commands"| node_clienttools
node_clienttools -->|"generates CSR"| node_csr
node_clienttools -->|"checks status"| node_revocationcheck
node_clienttools -->|"validates chain"| node_chainvalidation
node_clienttools -->|"signs files"| node_codesigning
node_rootca -->|"generates certificates"| node_certificates
node_certificateissue -->|"uses templates"| node_templates
node_certificateissue -->|"formats SANs"| node_san
node_certificateissue -->|"documents policy"| node_policy
node_certificateissue -->|"stores issued certs"| node_database
node_repository -->|"reads records"| node_database
node_repository -->|"limits requests"| node_ratelimit
node_repository -->|"signs submitted CSR"| node_certificateissue
node_repository -->|"serves CRL"| node_crl
node_ocsp -->|"checks status"| node_database
node_revocationcheck -->|"queries OCSP"| node_ocsp
node_revocationcheck -->|"falls back to CRL"| node_crl
node_chainvalidation -.->|"checks constraints"| node_validation
node_cli -->|"queries audit"| node_audit
node_cli -->|"verifies CT"| node_transparency
node_database -->|"tracks compromise"| node_keysecurity

click node_cli "https://github.com/kokinf/miniminpki/blob/main/internal/cli/root.go"
click node_clienttools "https://github.com/kokinf/miniminpki/tree/main/internal/client"
click node_csr "https://github.com/kokinf/miniminpki/blob/main/internal/client/csr.go"
click node_revocationcheck "https://github.com/kokinf/miniminpki/blob/main/internal/client/revocation.go"
click node_codesigning "https://github.com/kokinf/miniminpki/blob/main/internal/client/sign.go"
click node_rootca "https://github.com/kokinf/miniminpki/blob/main/internal/ca/ca.go"
click node_certificateissue "https://github.com/kokinf/miniminpki/blob/main/internal/ca/ca.go"
click node_certificates "https://github.com/kokinf/miniminpki/blob/main/internal/certs/generate.go"
click node_templates "https://github.com/kokinf/miniminpki/blob/main/internal/templates/templates.go"
click node_san "https://github.com/kokinf/miniminpki/blob/main/internal/san/parser.go"
click node_policy "https://github.com/kokinf/miniminpki/blob/main/internal/policy/generator.go"
click node_repository "https://github.com/kokinf/miniminpki/blob/main/internal/repository/server.go"
click node_database "https://github.com/kokinf/miniminpki/blob/main/internal/database/database.go"
click node_crl "https://github.com/kokinf/miniminpki/blob/main/internal/crl/generator.go"
click node_ocsp "https://github.com/kokinf/miniminpki/blob/main/internal/ocsp/responder.go"
click node_chainvalidation "https://github.com/kokinf/miniminpki/blob/main/internal/chain/validate.go"
click node_validation "https://github.com/kokinf/miniminpki/blob/main/internal/validation/validator.go"
click node_audit "https://github.com/kokinf/miniminpki/blob/main/internal/audit/logger.go"
click node_ratelimit "https://github.com/kokinf/miniminpki/blob/main/internal/ratelimit/limiter.go"
click node_transparency "https://github.com/kokinf/miniminpki/blob/main/internal/transparency/ct.go"
click node_keysecurity "https://github.com/kokinf/miniminpki/blob/main/internal/database/database.go"

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_cli,node_clienttools,node_csr,node_revocationcheck,node_codesigning,node_chainvalidation,node_validation toneBlue
class node_rootca,node_certificateissue,node_certificates,node_templates,node_san,node_policy toneAmber
class node_repository,node_database,node_crl,node_ocsp toneMint
class node_audit,node_ratelimit,node_transparency,node_keysecurity toneRose
class node_operator toneIndigo
```

## Components

### CLI and clients

- [Command interface](https://github.com/kokinf/miniminpki/blob/main/internal/cli/root.go): `internal/cli/root.go`
- [Client tools](https://github.com/kokinf/miniminpki/tree/main/internal/client): `internal/client`
- [CSR generation](https://github.com/kokinf/miniminpki/blob/main/internal/client/csr.go): `internal/client/csr.go`
- [Status checking](https://github.com/kokinf/miniminpki/blob/main/internal/client/revocation.go): `internal/client/revocation.go`
- [Code signing](https://github.com/kokinf/miniminpki/blob/main/internal/client/sign.go): `internal/client/sign.go`
- [Chain validation](https://github.com/kokinf/miniminpki/blob/main/internal/chain/validate.go): `internal/chain/validate.go`
- [Certificate checks](https://github.com/kokinf/miniminpki/blob/main/internal/validation/validator.go): `internal/validation/validator.go`

### CA and issuance

- [Root CA](https://github.com/kokinf/miniminpki/blob/main/internal/ca/ca.go): `internal/ca/ca.go`
- [Certificate issuance](https://github.com/kokinf/miniminpki/blob/main/internal/ca/ca.go): `internal/ca/ca.go`
- [Certificate generation](https://github.com/kokinf/miniminpki/blob/main/internal/certs/generate.go): `internal/certs/generate.go`
- [Certificate templates](https://github.com/kokinf/miniminpki/blob/main/internal/templates/templates.go): `internal/templates/templates.go`
- [SAN parsing](https://github.com/kokinf/miniminpki/blob/main/internal/san/parser.go): `internal/san/parser.go`
- [CA policies](https://github.com/kokinf/miniminpki/blob/main/internal/policy/generator.go): `internal/policy/generator.go`

### Repository and status

- [HTTP repository](https://github.com/kokinf/miniminpki/blob/main/internal/repository/server.go): `internal/repository/server.go`
- [Certificate database](https://github.com/kokinf/miniminpki/blob/main/internal/database/database.go): `internal/database/database.go`
- [CRL generation](https://github.com/kokinf/miniminpki/blob/main/internal/crl/generator.go): `internal/crl/generator.go`
- [OCSP responder](https://github.com/kokinf/miniminpki/blob/main/internal/ocsp/responder.go): `internal/ocsp/responder.go`

### Security and records

- [Audit log](https://github.com/kokinf/miniminpki/blob/main/internal/audit/logger.go): `internal/audit/logger.go`
- [Rate limiter](https://github.com/kokinf/miniminpki/blob/main/internal/ratelimit/limiter.go): `internal/ratelimit/limiter.go`
- [CT simulation](https://github.com/kokinf/miniminpki/blob/main/internal/transparency/ct.go): `internal/transparency/ct.go`
- [Compromised keys](https://github.com/kokinf/miniminpki/blob/main/internal/database/database.go): `internal/database/database.go`

### Other components

- **PKI operator**

## Connections

- PKI operator → Command interface: runs commands (evidence: `README.md`)
- Command interface → Root CA: manages CA (evidence: `README.md`)
- Command interface → Certificate issuance: issues certificates (evidence: `README.md`)
- Command interface → HTTP repository: starts server (evidence: `internal/cli/root.go`)
- Command interface → OCSP responder: starts responder (evidence: `internal/cli/root.go`)
- Command interface → Client tools: runs client commands (evidence: `README.md`)
- Client tools → CSR generation: generates CSR
- Client tools → Status checking: checks status (evidence: `README.md`)
- Client tools → Chain validation: validates chain (evidence: `README.md`)
- Client tools → Code signing: signs files (evidence: `README.md`)
- Root CA → Certificate generation: generates certificates (evidence: `internal/ca/ca.go`)
- Certificate issuance → Certificate templates: uses templates (evidence: `internal/ca/ca.go`)
- Certificate issuance → SAN parsing: formats SANs (evidence: `internal/ca/ca.go`)
- Certificate issuance → CA policies: documents policy (evidence: `README.md`)
- Certificate issuance → Certificate database: stores issued certs (evidence: `README.md`)
- HTTP repository → Certificate database: reads records (evidence: `README.md`)
- HTTP repository → Rate limiter: limits requests (evidence: `internal/repository/server.go`)
- HTTP repository → Certificate issuance: signs submitted CSR (evidence: `internal/repository/server.go`)
- HTTP repository → CRL generation: serves CRL (evidence: `README.md`)
- OCSP responder → Certificate database: checks status (evidence: `internal/ocsp/responder.go`)
- Status checking → OCSP responder: queries OCSP (evidence: `internal/client/revocation.go`)
- Status checking → CRL generation: falls back to CRL (evidence: `internal/client/revocation.go`)
- Chain validation → Certificate checks: checks constraints
- Command interface → Audit log: queries audit (evidence: `internal/cli/root.go`)
- Command interface → CT simulation: verifies CT (evidence: `README.md`)
- Certificate database → Compromised keys: tracks compromise (evidence: `internal/database/database.go`)
