Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 52 additions & 14 deletions examples/n8n/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,21 +186,59 @@ verification; they are not represented as already tested here.

## Verification and evidence

`node --test examples/n8n/test-workflow.mjs` runs dependency-free, synthetic
`node --test examples/n8n/test-workflow.mjs` runs dependency-free synthetic
contract tests for the export, Code-node success/failure cases, WebDAV
folder and file-ID correlation, ambiguity rejection, status transitions and
authorization boundaries. This tests **the export and its logic**, not n8n
runtime import, a live Nextcloud, SMTP delivery, legal identity, or
cryptographic signing. The discovery and final GET were also executed on a
**disposable Nextcloud 35 / LibreSign 15.0.12 / n8n 2.47.3 installation** with
one already signed synthetic PDF: the 21-node graph successfully retrieved
47,799 PDF bytes through authenticated WebDAV; `pdfsig` independently
confirmed a cryptographically valid signature from the test-only CA. The
creation, invitation, SMTP, external signing and polling were verified on
that installation in a separate earlier run. This is **not** an uninterrupted
end-to-end n8n run nor evidence of runtime compatibility with releases 13, 14,
or development. Revalidate in the target disposable release before using it
for live documents.
correlation, ambiguity rejection, status transitions and authorization
boundaries. All **12/12** passed again on 2026-11-12. These tests alone do
not prove live signing, SMTP delivery or certificate trust.

### One uninterrupted disposable run: LibreSign 15.0.12

On **2026-11-12**, one CLI execution in **n8n 2.47.3** (**execution ID 19**,
temporary workflow ID `n8n-homolog-20261112-real`) ran from
`14:53:25.963Z` to `14:54:44.615Z` with status **success** on
**Nextcloud 35.0.2 + LibreSign 15.0.12 + Mailpit 1.31.4**. The published
21-node graph and all processing Code nodes were unchanged; only the
test-only `Configure` values and credential bindings differed. The test
used `maxAttempts=80` and `waitSeconds=5`, not the default polling budget.

In that **single execution**, one authenticated OCS creation and one invite
POST succeeded; the controlled Mailpit inbox received the invitation at
`14:53:27.798Z` and the signed-document notice at `14:54:41.434Z`.
The external email signer had **no Nextcloud account** in the isolated
installation. Polling observed status `1` for attempts 1-15 and status
`3` at attempt 16 (`fileId=3`, source `nodeId=118`). Both authenticated
WebDAV `PROPFIND` nodes and the final authorized GET succeeded **without
a manually entered `signedPdfPath`**. The downloaded PDF was **47,797
bytes**, SHA-256
`d82577ce17455205f83ff28e1fb46165aafd72c2f95a3cd0d63b3ab859f7ba2a`.
An **independent `pdfsig` check** reported `Signature is Valid` and
`Total document signed`; the **private QA certificate issuer is not
trusted** by the verification host. n8n itself still reports
`cryptographicSignatureVerified: false` until a separate verifier runs.

All 21 distinct nodes happened to execute because signing followed 15
polling waits; **executing every conditional node is not an acceptance
criterion**. Creation and invitation each ran once. Additional, separate
negative checks covered invalid App Password (stops before invitation),
permission denied, SMTP unavailability (notification acceptance is not
delivery), and an HTTP timeout without automatic POST retry. The 12
synthetic contract tests cover missing/wrong source IDs, ambiguous PDF
siblings, unsafe WebDAV paths and bounded polling.

The [sanitized execution summary](evidence-2026-11-12.json) includes the
ephemeral execution ID, node counts and hash. Raw execution logs, invitation
URLs, credentials and binary data remain **outside the repository**.

**Limits:** runtime evidence applies only to LibreSign **15.0.12** with
default storage, one document, one email signer and this signing policy.
LibreSign 13, 14, development, custom folders and multi-signer/envelope
flows remain unverified. Mailpit proves receipt by the local sink, not
internet email delivery or signer identity assurance. A successful single
run and disabled automatic POST retries **do not provide durable
idempotency** across manual restarts or ambiguous POST failures: reconcile
the existing request ID/UUID before manually retrying. Test CA trust and
legal signature validity are outside this QA claim.

References: [LibreSign stable API guide](https://docs.libresign.coop/stable/developer_manual/api/external-email-signers.html),
[stable integration lifecycle](https://docs.libresign.coop/stable/developer_manual/integration/lifecycle.html),
Expand Down
89 changes: 89 additions & 0 deletions examples/n8n/evidence-2026-11-12.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
{
"scope": "Disposable single uninterrupted test; no production services",
"date": "2026-11-12",
"versions": {
"n8n": "2.47.3",
"nextcloud": "35.0.2",
"libresign": "15.0.12",
"smtp_sink": "Mailpit 1.31.4"
},
"workflow": {
"id": "n8n-homolog-20261112-real",
"execution_id": "19",
"mode": "cli",
"status": "success",
"started_at_utc": "2026-11-12T14:53:25.963Z",
"stopped_at_utc": "2026-11-12T14:54:44.615Z",
"published_graph_nodes": 21,
"only_configure_values_and_credential_bindings_differed": true
},
"node_execution_counts": {
"Manual trigger": 1,
"Configure": 1,
"Prepare request": 1,
"Create request": 1,
"Verify created": 1,
"Invite signer once": 1,
"Verify invite accepted": 1,
"Prepare bounded attempts": 1,
"Poll attempts": 16,
"Get file state": 16,
"Reconcile file state": 16,
"Signed?": 16,
"Wait before polling": 15,
"List LibreSign folders": 1,
"Parse folder XML": 1,
"Choose folders": 1,
"Inspect folder files": 1,
"Parse file XML": 1,
"Resolve signed PDF": 1,
"Download signed PDF": 1,
"Verify PDF bytes": 1
},
"completed_request": {
"file_id": 3,
"source_node_id": 118,
"poll_attempts": 16,
"pending_status": 1,
"completed_status": 3,
"create_post_count": 1,
"invite_post_count": 1,
"manual_signed_pdf_path_used": false,
"webdav_propfind_nodes_succeeded": 2,
"authorized_pdf_get_succeeded": true
},
"mailpit": {
"invitation_received_at_utc": "2026-11-12T14:53:27.798Z",
"signed_notice_received_at_utc": "2026-11-12T14:54:41.434Z",
"recipient": "controlled synthetic test mailbox"
},
"external_signer": {
"method": "email invitation; click-to-sign",
"nextcloud_account_present": false
},
"pdf": {
"bytes": 47797,
"sha256": "d82577ce17455205f83ff28e1fb46165aafd72c2f95a3cd0d63b3ab859f7ba2a",
"pdfsig_signature_valid": true,
"pdfsig_entire_document_signed": true,
"pdfsig_hash_algorithm": "SHA-256",
"pdfsig_type": "adbe.pkcs7.detached",
"private_test_ca_trusted_by_host": false,
"n8n_native_cryptographic_verification": false
},
"separate_negative_checks": [
"invalid App Password stops before invite",
"authorization refusal prevents creation",
"SMTP offline does not prove delivery",
"isolated HTTP timeout does not auto-retry POST",
"12 contract tests cover ambiguous/missing/wrong PDF matches, unsafe DAV paths and polling exhaustion"
],
"limits": [
"release 15.0.12 only",
"one document and one email signer",
"default storage only",
"manual reruns are not idempotent",
"not real SMTP deliverability or legal certificate-chain trust",
"raw logs and invitation URLs not published"
]
}
Loading