AtlatestRepositorysigil-quic
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
(begin13
(define domain (string->utf8 "sigil quic Retry token v1"))15
(define-struct retry-token-manager16
(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-wind35
(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) value73
(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 domain80
(bytevector (bytevector-length address)) address81
(bytevector (bytevector-length retry-id)) retry-id82
(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 errors98
;; 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)))))))))))))