OpenPrinterOpenPrinter
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/gateway

Description

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"}