encore_reqauth/lib.rs
1//! The wire protocol of Encore's service-to-service request auth: the
2//! `x-encore-meta-*` headers a call carries ([`meta`]), Request Context
3//! among them ([`reqctx`]), and the `ENCORE1-HMAC-SHA3-256` signature over
4//! them ([`svcauth`]).
5//!
6//! The gateway links it to sign calls on its services' behalf, which hold no
7//! keys, and to verify the calls it receives, and so does the signing
8//! service (`encore_call_signing`), which signs and verifies them for gateway
9//! programs, which hold none either. The signature is also produced
10//! and checked by the old Encore.go runtime (`runtimes/go`), so a call either
11//! can make must sign the same. `x-encore-service`, which only the gateway
12//! sends, is hashed only when present.
13//!
14//! It also holds the MAC the Encore platform signs its requests with
15//! ([`platform`]), which the gateway, or the signing service for a gateway
16//! program, verifies.
17//!
18//! What a call's headers *mean* to the service receiving it — who the caller
19//! is, its trace context — is for the service's own code to read.
20
21mod encoreauth;
22pub mod meta;
23pub mod platform;
24pub mod reqctx;
25pub mod svcauth;