heimdall icon indicating copy to clipboard operation
heimdall copied to clipboard

Error handler complementing HTTP Message Signatures authenticator

Open dadrus opened this issue 6 months ago • 0 comments

Preflight checklist

  • [x] I agree to follow this project's Code of Conduct.
  • [x] I have read and am following this repository's Contribution Guidelines."
  • [ ] I have discussed this feature request with the community.

Describe the background of your feature request

FR #2677 proposes adding an authenticator to support HTTP Message Signatures. When implemented, incorrect signatures — for example, missing required components, unsupported algorithms, or unknown keys — would lead to authentication failures that currently can only be handled in a generic way.

Describe your idea

To complement this, a dedicated error handler, named e.g. http_message_signature_negotiation, could be introduced to provide clients with clear feedback on how to successfully authenticate with HTTP Message Signatures.

The error handler would:

  • Inspect the cause of the failure (e.g., missing or invalid components, unsupported algorithms, unknown keys, expired/nonces).
  • Return a structured response to the client indicating:
    • Required components for a valid signature (e.g., @method, @path, @authority, content-digest).
    • Accepted signature algorithms.
    • Recognized keys or key identifiers.
    • Optional hints for timestamps, nonces, or other constraints.

Are there any workarounds or alternatives?

No

Version

0.17.0

Additional Context

No response

dadrus avatar Aug 18 '25 06:08 dadrus