How sunet/eduseal works
eduSeal is a PDF-sealing and signature-validation service: clients submit PDFs through the API gateway, sealing is dispatched asynchronously, and completed documents can be retrieved or validated. Separate Python services perform PKCS#11-backed signing and gRPC validation; the gateway also uses persistent storage and NATS. The excerpts show gateway construction and the sealer’s queue handling, but do not expose all HTTP routing, cache-stream persistence, or validation-call details, so those connections are omitted where they cannot be evidenced.
Main entry points: main.go Gateway Startup · sealer/run.py Sealer Worker · validator/run.py Validator Worker · handlers_eduseal.go PDF API
Components 19
API Gateway
- Gateway Startup
cmd/apigw/main.go - HTTP Server
internal/apigw/httpserver - PDF API
internal/apigw/apiv1/handlers_eduseal.go - API gRPC Client
pkg/grpcclient/client.go
Async Sealing
- Stream Service
internal/apigw/stream/service.go - Seal Stream
internal/apigw/stream/seal_stream.go - Cache Stream
internal/apigw/stream/cache_stream.go - Sealer Worker
src/eduseal/sealer/run.py - Sealer Config
src/eduseal/sealer/config.py
Signature Validation
- Validator Worker
src/eduseal/validator/run.py - Validator Config
src/eduseal/validator/config.py
Shared Infrastructure
- KV Client
pkg/kvclient/client.go - Python Cert Reloader
src/eduseal/cert_reloader.py - Validator gRPC Client
pkg/grpcclient/validator.go - Telemetry
pkg/trace/otel.go
Other components
- API Client
- NATS
- PKCS#11 Signer
- Trust Certificates
Connections 20
- Gateway Startup → HTTP Server: creates
cmd/apigw/main.go - Gateway Startup → PDF API: creates
cmd/apigw/main.go - Gateway Startup → Stream Service: creates
cmd/apigw/main.go - Gateway Startup → API gRPC Client: creates
cmd/apigw/main.go - Gateway Startup → KV Client: creates
cmd/apigw/main.go - API Client → HTTP Server: sends requests
- HTTP Server → PDF API: dispatches
- PDF API → Stream Service: publishes seal
internal/apigw/apiv1/handlers_eduseal.go - PDF API → KV Client: reads signed PDF
internal/apigw/apiv1/handlers_eduseal.go - Stream Service → NATS: connects
internal/apigw/stream/service.go - Sealer Worker → Sealer Config: loads config
src/eduseal/sealer/run.py - Sealer Worker → NATS: consumes seal jobs
src/eduseal/sealer/run.py - Sealer Worker → NATS: publishes sealed result
src/eduseal/sealer/run.py - Sealer Worker → PKCS#11 Signer: signs PDF
src/eduseal/sealer/run.py - Sealer Worker → Python Cert Reloader: uses
src/eduseal/sealer/run.py - Validator Worker → Validator Config: loads config
src/eduseal/validator/run.py - Validator Worker → Trust Certificates: loads trust roots
src/eduseal/validator/run.py - Validator Worker → Python Cert Reloader: uses
src/eduseal/validator/run.py - Validator gRPC Client → Validator Worker: calls gRPC
- Gateway Startup → Telemetry: initializes
cmd/apigw/main.go