Skip to main content

Docuseal — e-Signature Platform

Self-hosted electronic signature platform for the ktayl-solution IS. Every insurance contract, claims settlement, broker mandate, and SEPA mandate requires a legally traceable signature — Docuseal provides eIDAS-compatible e-signature without SaaS dependency.

Access

URLAudience
https://sign.devandre.sbsPublic (Cloudflare Tunnel)
https://sign.10.0.0.200.nip.ioInternal (Tailscale only)

Login: Authentik OIDC SSO (kanmegnea + TOTP).

Deployment

ParameterValue
Namespacesign
Imagedocuseal/docuseal:1.8.3
Managed byArgoCD
StorageLonghorn PVC
AuthAuthentik OIDC
kubectl --context minicloud get pods -n sign
kubectl --context minicloud get ingress -n sign

Document Templates

Four insurance templates configured:

TemplateUse case
Contrat de policePolicy binding signature at underwriting
Règlement de sinistreClaims settlement agreement
Mandat courtierBroker mandate / letter of authority
Mandat SEPASEPA direct debit authorisation for premium collection

Integration Points

ERPNext CRM (devis → accept)
↓ send-for-signature API call
Docuseal (signature request created)
↓ signed PDF webhook
ktayl-claims-service (settlement confirmation)
↓ audit trail
Paperless-ngx DMS (#76) — long-term compliant archive

API Usage

Docuseal exposes a REST API for programmatic signature requests:

# Create a signature request from a template
curl -X POST https://sign.devandre.sbs/api/v1/submissions \
-H "X-Auth-Token: $DOCUSEAL_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"template_id": 1,
"send_email": true,
"submitters": [
{"role": "Souscripteur", "email": "client@example.com"},
{"role": "Courtier", "email": "broker@example.com"}
]
}'

The API token is stored in Vault at secret/platform/docuseal key api-token.

Why self-hosted

  • ACPR compliance: audit trail under French jurisdiction, not a US SaaS provider
  • Cost: zero per-signature fee (DocuSign: €0.80–2.00/envelope)
  • Integration: direct API access from ktayl microservices without webhook relay
  • Data sovereignty: signed PDFs never leave the on-premises cluster

Regulatory context

Docuseal produces signatures compliant with eIDAS Regulation (EU 910/2014) at the Simple Electronic Signature level. For ACPR-regulated operations requiring Advanced or Qualified signatures, a qualified Trust Service Provider (TSP) integration would be required — not in scope for this IS.