From 7ebac6546ad53e33927fab57ae226d13ecc2737b Mon Sep 17 00:00:00 2001 From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> Date: Thu, 12 Nov 2026 23:46:54 +0000 Subject: [PATCH] docs(n8n): record signed single-run v15 end-to-end QA evidence Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> --- examples/n8n/README.md | 66 +++++++++++++++----- examples/n8n/evidence-2026-11-12.json | 89 +++++++++++++++++++++++++++ 2 files changed, 141 insertions(+), 14 deletions(-) create mode 100644 examples/n8n/evidence-2026-11-12.json diff --git a/examples/n8n/README.md b/examples/n8n/README.md index ffd54fa8..5d5dac9e 100644 --- a/examples/n8n/README.md +++ b/examples/n8n/README.md @@ -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), diff --git a/examples/n8n/evidence-2026-11-12.json b/examples/n8n/evidence-2026-11-12.json new file mode 100644 index 00000000..ed5e6d4f --- /dev/null +++ b/examples/n8n/evidence-2026-11-12.json @@ -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" + ] +}