Skip to content

Commit 2d356a5

Browse files
Add request signing diagram to docs
1 parent ce1e9ea commit 2d356a5

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

docs/guide/request-signing.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,38 @@ Keys are stored in two separate Fastly stores:
5252
└─────────────────────┘
5353
```
5454

55+
### Signing Flow (Prebid)
56+
57+
The following diagram shows how request signing works for Prebid auction requests, from the Trusted Server through to DSP verification:
58+
59+
```mermaid
60+
sequenceDiagram
61+
participant TS as Trusted Server<br/>(Publisher Domain)
62+
participant PBS as Prebid Server
63+
participant DSP as DSP
64+
65+
Note over TS: Signs request using<br/>Ed25519 private key
66+
67+
TS->>PBS: POST /openrtb2/auction
68+
Note right of TS: OpenRTB body includes<br/>ext.trusted_server {<br/> signature,<br/> kid,<br/> request_host,<br/> request_scheme<br/>}
69+
70+
PBS->>DSP: POST /openrtb2/auction
71+
Note right of PBS: Forwards full OpenRTB body<br/>including ext.trusted_server
72+
73+
Note over DSP: Extracts signature, kid,<br/>and site.domain from request
74+
75+
opt JWKS not cached (10 min TTL)
76+
DSP->>TS: GET /.well-known/trusted-server.json
77+
TS-->>DSP: JWKS response
78+
Note left of DSP: {keys: [{<br/> kid,<br/> kty: "OKP",<br/> crv: "Ed25519",<br/> x: "public_key"<br/>}]}
79+
end
80+
81+
Note over DSP: Looks up public key by kid<br/>Verifies Ed25519 signature<br/>over request
82+
83+
DSP-->>PBS: Bid Response
84+
PBS-->>TS: Bid Response
85+
```
86+
5587
## Signing Requests
5688

5789
### Basic Usage

0 commit comments

Comments
 (0)