AtlatestRepositorysigil-quic

sigil-quic / tree / src / sigil / quic / retrytoken.sgl

1;;; Private server Retry tokens. This local format is not NEW_TOKEN.
2;;; The caller supplies canonical IP-and-port bytes and monotonic milliseconds.
3(define-library (sigil quic retry token)
4 (import (sigil crypto)
5 (sigil io)
6 (sigil math)
7 (sigil struct)
8 (sigil quic bytes)
9 (sigil quic wire))
10 (export make-retry-token-manager retry-token-manager? close-retry-token-manager!
11 make-retry-token validate-retry-token)
12 (begin
13 (define domain (string->utf8 "sigil quic Retry token v1"))
15 (define-struct retry-token-manager
16 (key mutable: #t)
17 (lifetime))
19 (define (wipe! bytes)
20 (when (bytevector? bytes)
21 (do ((index 0 (+ index 1))) ((= index (bytevector-length bytes)))
22 (bytevector-u8-set! bytes index 0))))
24 (define (uint? value maximum)
25 (and (integer? value) (exact? value) (<= 0 value maximum)))
27 ;; Supplied keys are copied for explicit shared-server key management.
28 ;; A fresh private key is the default; no getter exposes the owned copy.
29 (define (make-retry-token-manager (keys: (lifetime 10000) (key #f)))
30 (unless (and (uint? lifetime 60000) (> lifetime 0)
31 (or (not key) (and (bytevector? key) (= 32 (bytevector-length key)))))
32 (error "QUIC Retry token: invalid lifetime or key"))
33 (let ((owned #f) (transferred? #f))
34 (dynamic-wind
35 (lambda () #t)
36 (lambda ()
37 (set! owned (if key (bytevector-copy key) (random-bytes 32)))
38 (let ((manager (retry-token-manager key: owned lifetime: lifetime)))
39 (set! transferred? #t)
40 manager))
41 (lambda () (unless transferred? (wipe! owned))))))
43 (define (close-retry-token-manager! manager)
44 (unless (retry-token-manager? manager) (error "QUIC Retry token: expected manager"))
45 (let ((key (retry-token-manager-key manager)))
46 (set-retry-token-manager-key! manager #f)
47 (wipe! key)))
49 (define (require-open! manager)
50 (unless (and (retry-token-manager? manager) (retry-token-manager-key manager))
51 (error "QUIC Retry token: manager is invalid or closed")))
53 (define (require-id! id minimum)
54 (unless (and (bytevector? id) (<= minimum (bytevector-length id) 20))
55 (error "QUIC Retry token: invalid connection ID")))
57 (define (require-context! manager address retry-id client-id now)
58 (require-open! manager)
59 (unless (and (bytevector? address) (<= 1 (bytevector-length address) 64)
60 (uint? now quic-varint-maximum))
61 (error "QUIC Retry token: invalid canonical address or time"))
62 (require-id! retry-id 0)
63 (require-id! client-id 0))
65 (define (timestamp-bytes now)
66 (let ((out (make-bytevector 8 0)))
67 (do ((index 7 (- index 1)) (value now (quotient value 256))) ((< index 0) out)
68 (bytevector-u8-set! out index (modulo value 256)))))
70 (define (timestamp-value token)
71 (let loop ((index 2) (value 0))
72 (if (= index 10) value
73 (loop (+ index 1) (+ (* value 256) (bytevector-u8-ref token index))))))
75 ;; Length prefixes bind field boundaries, not just concatenated bytes.
76 ;; Address bytes are authenticated input and are never put in the token.
77 (define (token-mac manager address retry-id client-id body)
78 (let ((mac (hmac-sha256-bytes (retry-token-manager-key manager)
79 (bytes-append domain
80 (bytevector (bytevector-length address)) address
81 (bytevector (bytevector-length retry-id)) retry-id
82 (bytevector (bytevector-length client-id)) client-id body))))
83 (unless (and (bytevector? mac) (= 32 (bytevector-length mac)))
84 (error "QUIC Retry token: HMAC computation failed"))
85 mac))
87 (define (make-retry-token manager address original-id retry-id client-id now)
88 (require-context! manager address retry-id client-id now)
89 (require-id! original-id 8)
90 (when (bytes=? original-id retry-id)
91 (error "QUIC Retry token: Retry source must differ from original destination"))
92 (guard (exn (else (close-retry-token-manager! manager) (raise exn)))
93 (let ((body (bytes-append #u8(82 1) (timestamp-bytes now) (random-bytes 16)
94 (bytevector (bytevector-length original-id)) original-id)))
95 (bytes-append body (token-mac manager address retry-id client-id body)))))
97 ;; Peer bytes are bounded before copying/MAC work. Local context errors
98 ;; raise; malformed, forged, future or expired tokens return #f.
99 ;; Native crypto failures retire the owned key and remain exceptions.
100 (define (validate-retry-token manager address retry-id client-id token now)
101 (require-context! manager address retry-id client-id now)
102 (and (bytevector? token) (<= 67 (bytevector-length token) 79)
103 (= 82 (bytevector-u8-ref token 0)) (= 1 (bytevector-u8-ref token 1))
104 (let ((length (bytevector-u8-ref token 26)))
105 (and (<= 8 length 20) (= (+ 59 length) (bytevector-length token))
106 (guard (exn (else (close-retry-token-manager! manager) (raise exn)))
107 (let* ((end (- (bytevector-length token) 32))
108 (body (bytevector-copy token 0 end))
109 (tag (bytevector-copy token end))
110 (mac (token-mac manager address retry-id client-id body)))
111 (and (bytes-timing-safe=? tag mac)
112 (let ((issued (timestamp-value token)))
113 (and (<= issued now quic-varint-maximum)
114 (< (- now issued) (retry-token-manager-lifetime manager))
115 (let ((original (bytevector-copy token 27 end)))
116 (and (not (bytes=? original retry-id)) original)))))))))))))