DOKU
Verification available
Non-SNAP notifications only. Configure exact public notification path without query or fragment. Forwarding can change that path and does not re-sign the webhook; a receiver validating against its own path cannot assume the original signature will pass.
Signature scheme
- Algorithm
- Non-SNAP HMAC-SHA256
- Signature
- Signature; Client-Id; Request-Id; Request-Timestamp
- Signed data
- named lines Client-Id, Request-Id, Request-Timestamp, configured Request-Target, Digest(base64 SHA256 body), separated by LF without trailing LF
- Encoding
- HMACSHA256=base64
- Timestamp
- RFC3339, signed; no age check
Configure verification
Create or edit a source, enable Verify signature and search for DOKU. The source remains active independently of this switch. Save the provider and its configuration together.
Copy the exact ingress URL from your source when configuring the sender. Save every required field together; saved configuration is encrypted and never returned in source reads.
- notification path (
notification_path) (required). - secret key (
secret_key) (required).
For API clients, encode these fields as one JSON object inside the signing_secret string. The dashboard assembles it from the fields above.
Inspect the recorded valid, invalid or not-checked signature result after sending a new event. Changing configuration does not change historical results; replay preserves the original bytes and does not re-sign the webhook.
Capture, delivery and acknowledgement
Verification availability describes the inbound validator. The original incoming query string is not retained or forwarded, and the destination URL or path can differ from the signed request. Acklane does not re-sign deliveries; schemes using that original context may not be verifiable again at the destination.
With async enabled, a failed signature may still be captured and retained, but does not become eligible for signature-on delivery. Replay requires current source eligibility, preserves the event ID and original content, and creates a separate delivery history.
Async capture returns 202 after durable acceptance. A provider that requires HTTP 200 or a special acknowledgement may retry; an implemented validator does not establish compatibility with its acknowledgement rules. No real provider sandbox delivery is certified by this catalog.