Skip to main content

Crate foctet_http

Crate foctet_http 

Source
Expand description

High-level HTTP integration for application/foctet body envelopes.

foctet-http adapts HTTP requests and responses onto the body-complete envelope format.

Foctet HTTP integration encrypts and authenticates the body bytes only. The outer HTTP method, URI, status code, and headers remain visible to the surrounding transport and should be protected by an authenticated outer channel such as HTTPS, authenticated WebTransport, or an authenticated Foctet transport session.

§Layers

  • Recommended high-level API: HttpSealer and HttpOpener
  • Framework adapters: axum and workers
  • Lower-level helpers: raw

Sealed requests and responses also carry an advisory x-foctet-scope: body-only header so downstream systems can distinguish Foctet body envelopes from full-message protection.

Re-exports§

pub use http;

Modules§

raw
Lower-level HTTP helpers for application/foctet envelopes.

Structs§

HttpConfig
Shared HTTP behavior configuration for high-level opener/sealer helpers.
HttpOpenOptions
High-level options used to construct an crate::HttpOpener.
HttpOpener
High-level helper for opening HTTP bodies, requests, and responses.
HttpSealOptions
High-level options used to construct an crate::HttpSealer.
HttpSealer
High-level helper for sealing HTTP bodies, requests, and responses.

Enums§

HttpError
Error type for HTTP integration over foctet-core body envelopes.

Constants§

BODY_ONLY_SCOPE
Advisory header value indicating that only the HTTP body is protected.
CONTENT_TYPE
Foctet HTTP media type.
SCOPE_HEADER
Advisory header name describing the Foctet protection scope.