Choose the signing secret
Identity verification uses a separate secret and identity recipe.
Read the signature
X-Tars-Signature contains t, v1 and, during rotation, v2. t is milliseconds since the epoch. The HMAC-SHA256 input joins these values with newline characters, in this order:- The timestamp t.
- The uppercase HTTP method.
- The exact request path and query string.
- The raw request body.
Verification recipe
Reject timestamps more than five minutes from your clock. Compare signatures using constant-time equality.Rotation
v1 uses the current secret. During the 24-hour overlap, v2 uses the previous secret. Accept a valid signature from either secret while replacing your stored secret. Another rotation is refused until the overlap ends.Other request headers
Only headers applicable to the request are included. These headers do not replace signature verification.
