diff --git a/developer_manual/api/_external-email-signers-release.inc b/developer_manual/api/_external-email-signers-release.inc index d9f7503e..467106d8 100644 --- a/developer_manual/api/_external-email-signers-release.inc +++ b/developer_manual/api/_external-email-signers-release.inc @@ -45,6 +45,3 @@ the exact source commit used in this build is in the linked provenance: * `Guest signing and visible signature `_ * `Unauthenticated email-token signing `_ * `Sequential signing `_ - -**Evidence limit:** source tests are present; their existence does not -prove that SMTP, browser behavior or PDF signing passed in this deployment. diff --git a/developer_manual/api/external-email-signers.rst b/developer_manual/api/external-email-signers.rst index 1acfb5e7..29164e39 100644 --- a/developer_manual/api/external-email-signers.rst +++ b/developer_manual/api/external-email-signers.rst @@ -68,9 +68,9 @@ from the default LibreSign folder. Select this LibreSign release in the workflow configuration: versions 13/14 use ``mandatory: 1``; versions 15/development use ``requirement: "required"``. Native completion events belong to the development documentation and are not required by polling. -Automated discovery was exercised only on LibreSign 15.0.12; versions 13, -14 and development still require runtime verification. The link pins the -README and its relative 21-node JSON workflow to one immutable revision. +Confirm that this release meets the OCS and WebDAV prerequisites before +using the shared workflow. The pinned link keeps its README and relative +JSON workflow at the same immutable revision. Do not replace release-specific cURL/PHP fixtures with development payloads. .. include:: _external-email-signers-release.inc @@ -220,9 +220,8 @@ Protect invitation links, App Passwords, signer metadata and PDFs. Poll with backoff; native webhooks require a separately verified LibreSign event contract for the deployed Nextcloud version. -The release-specific section links to browser-test sources from that -application branch. Their presence is source evidence; running them -against the installed release is still necessary to establish E2E behavior. -Contract checks cannot prove SMTP, browser signing or certificate trust. +Validate browser signing, SMTP delivery and certificate trust on the target +installation before relying on the integration. Contract checks alone do +not establish operational compatibility. Consult the OpenAPI reference beside this page for exact schemas. diff --git a/developer_manual/integration/index.rst b/developer_manual/integration/index.rst index e1a1e347..027dbb5e 100644 --- a/developer_manual/integration/index.rst +++ b/developer_manual/integration/index.rst @@ -88,8 +88,8 @@ Read the relevant guide WebDAV discovery and authenticated download in the default LibreSign folder. The shared example selects the request schema for LibreSign 13/14 (``mandatory``) or 15/development (``requirement``). The discovery - step was exercised only on LibreSign 15.0.12; versions 13, 14 and - development still require runtime verification. Native completion + step requires default LibreSign storage and requester WebDAV access. + Verify these prerequisites on the target installation. Native completion events are documented only for development; the workflow uses OCS polling. Contract and ownership boundaries diff --git a/examples/n8n/README.md b/examples/n8n/README.md index ffd54fa8..7e86b801 100644 --- a/examples/n8n/README.md +++ b/examples/n8n/README.md @@ -1,7 +1,7 @@ -# LibreSign + n8n: external signer (C2) +# LibreSign + n8n: external signer This is an **importable n8n workflow** using public LibreSign OCS v1 requests and authenticated Nextcloud WebDAV discovery and download. It creates a @@ -184,33 +184,9 @@ release, including `main`, and does not require a proprietary callback. Event delivery and receiver authentication require separate integration verification; they are not represented as already tested here. -## Verification and evidence - -`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. - 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), [n8n HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/), [n8n Wait](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.wait/), [n8n Webhook](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/), [Nextcloud WebDAV](https://docs.nextcloud.com/server/stable/developer_manual/client_apis/WebDAV/basic.html). - -**Navigation follow-up, not part of this PR:** once front C finishes editing -its versioned integration landing pages, add a link to this example from the -relevant architecture and external-email-signers guides on `main`, -`stable13`, `stable14`, and `stable15`, using independently reviewed version -links. Do not backport an event receiver to stable branches. diff --git a/style_guide.rst b/style_guide.rst index 3f324e6f..30ef3a5d 100644 --- a/style_guide.rst +++ b/style_guide.rst @@ -2,8 +2,6 @@ LibreSign manuals style guide ============================= -*This is a work in progress* - See the `Documentation README `_ for information on setting up your documentation build environment See `reStructuredText Primer `_ for a complete @@ -135,10 +133,7 @@ or add a caption. Captions must follow a blank line and be italicized, like this *Figure 1: The file listing and administration page.* Images must go into a sub-directory of the directory containing your manual -page. Currently the manuals have both a single master images directory, and -image directories local to each chapter. A single master images directory is -difficult to maintain and inevitably becomes cluttered with obsolete images. Eventually -the single master directories will be gone. +page. Example URL -----------