Skip to main content

Module scanner_retrieval

Module scanner_retrieval 

Source
Expand description

Private raw-pack retrieval for synchronous scanners (SPEC-SERVER §11.4). Capabilities authorize only open ticket-bound bytes; public serving is unrelated.

Structs§

Assignment
Repository and ticket bindings retained in an authenticated capability.
ConfigError
Invalid configuration. Never contains supplied keys or credentials.
PackGrant
Raw pack assignment from existing, verified upload-ticket metadata.
RetrievalConfig
Dedicated active/retained MAC keys and the incoming scanner allowlist.
RetrievalResponse
A bounded pack segment, fully checked before the adapter returns its bytes.

Constants§

MARGIN_MS
Small retrieval margin after the hook timeout.
MAX_CALLS
Shared bound for denial, ticket and blob operations; adapter work has headroom.
MAX_LIFETIME_MS
Longest capability validity; hook timeout is at most five minutes.
MAX_REQUEST_BYTES
Bound the complete signed request, including its capability.
MAX_RESPONSE_BYTES
Maximum returned range, or entire pack when no range is requested.
PATH
Exact private POST path; auth v2 signs this procedure and the request body.

Functions§

validate_config
Validate scanner prerequisites and key separation before serving requests.