OpenPrinter Agent Gateway
Server sends an authentication challenge
The server starts authentication by sending an unpredictable challenge
immediately after the WebSocket connection opens. The agent must sign
the decoded payload before expiresAt; normal application messages
are not accepted until authentication completes.
Address
/.well-known/openprinter/gatewayDescription
The authenticated, bidirectional OPPA gateway socket.
Messages
Sent by the server before any normal application traffic. The agent
signs the decoded payload bytes exactly as received and must answer
before expiresAt.
Payload
Message Example
{ "type": "auth.challenge", "challengeId": "challenge_01", "payload": "Y2hhbGxlbmdl", "expiresAt": "2026-08-21T00:00:30Z"}