AtlatestRepositorysigil-cloudflare
1;;; S3 Signature Version 4. Inputs are raw paths/query strings, never pre-escaped.
2(define-library (cloudflare r2 signing)
3 (import (sigil io)
4 (sigil math)
5 (sigil string)
6 (sigil list)
7 (sigil crypto))
8
9 (export r2-uri-encode
10 r2-canonical-query
11 r2-sign-request)
13 (begin
14 (define hex "0123456789ABCDEF")
16 (define (r2-uri-encode value (keys: (preserve-slashes? #f)))
17 (let ((bytes (string->utf8 value)))
18 (let loop ((i 0) (out '()))
19 (if (= i (bytevector-length bytes))
20 (string-join (reverse out) "")
21 (let ((b (bytevector-u8-ref bytes i)))
22 (loop (+ i 1)
23 (cons (if (or (<= 65 b 90)
24 (<= 97 b 122)
25 (<= 48 b 57)
26 (member b '(45 46 95 126))
27 (and preserve-slashes? (= b 47)))
28 (string (integer->char b))
29 (string #\%
30 (string-ref hex (quotient b 16))
31 (string-ref hex (modulo b 16))))
32 out)))))))
34 (define (r2-canonical-query query)
35 (string-join
36 (map (lambda (p)
37 (string-append (car p) "=" (cdr p)))
38 (list-sort
39 (lambda (a b)
40 (or (string<? (car a) (car b))
41 (and (string=? (car a) (car b))
42 (string<? (cdr a) (cdr b)))))
43 (map (lambda (p)
44 (cons (r2-uri-encode (car p))
45 (r2-uri-encode (cdr p))))
46 query)))
47 "&"))
49 (define (header-value value)
50 (unless (and (string? value)
51 (not (string-contains? value "\r"))
52 (not (string-contains? value "\n")))
53 (error "Invalid signing header value"))
54 (let loop ((chars (string->list value)) (out '()) (space? #f))
55 (cond
56 ((null? chars)
57 (list->string (reverse out)))
58 ((or (char=? (car chars) #\space)
59 (char=? (car chars) #\tab))
60 (loop (cdr chars) out (not (null? out))))
61 (else
62 (loop (cdr chars)
63 (cons (car chars) (if space? (cons #\space out) out))
64 #f)))))
66 (define (normalize-headers headers)
67 (let loop ((entries headers) (out '()))
68 (if (null? entries)
69 (list-sort (lambda (a b) (string<? (car a) (car b))) out)
70 (let* ((p (car entries))
71 (name (string-downcase (car p))))
72 (unless (and (> (string-length name) 0)
73 (every (lambda (c)
74 (or (and (char<=? #\a c) (char<=? c #\z))
75 (and (char<=? #\0 c) (char<=? c #\9))
76 (char=? c #\-)))
77 (string->list name)))
78 (error "Invalid signing header name"))
79 (when (assoc name out)
80 (error "Duplicate signing header"))
81 (loop (cdr entries)
82 (cons (cons name (header-value (cdr p))) out))))))
84 ;; Result contains signed headers and canonical details: it is sensitive and
85 ;; must never be logged. A region override supports official AWS test vectors.
86 (define (r2-sign-request method path query headers payload
87 access-key secret-key timestamp
88 (keys: (region "auto")))
89 (unless (and (= (string-length timestamp) 16)
90 (char=? (string-ref timestamp 8) #\T)
91 (char=? (string-ref timestamp 15) #\Z)
92 (every char-numeric?
93 (append (string->list (substring timestamp 0 8))
94 (string->list (substring timestamp 9 15)))))
95 (error "Invalid signing timestamp"))
96 (let* ((body-hash (sha256 payload))
97 (base (normalize-headers headers)))
98 (unless (assoc "host" base)
99 (error "Signing requires host header"))
100 (when (or (assoc "authorization" base)
101 (assoc "x-amz-date" base)
102 (assoc "x-amz-content-sha256" base))
103 (error "Reserved signing header"))
104 (let* ((signed (normalize-headers
105 (append base
106 (list (cons "x-amz-date" timestamp)
107 (cons "x-amz-content-sha256" body-hash)))))
108 (names (string-join (map car signed) ";"))
109 (uri (r2-uri-encode path preserve-slashes?: #t))
110 (qs (r2-canonical-query query))
111 (canonical (string-append
112 (symbol->string method) "\n" uri "\n" qs "\n"
113 (apply string-append
114 (map (lambda (p)
115 (string-append (car p) ":" (cdr p) "\n"))
116 signed))
117 "\n" names "\n" body-hash))
118 (date (substring timestamp 0 8))
119 (scope (string-append date "/" region "/s3/aws4_request"))
120 (to-sign (string-append "AWS4-HMAC-SHA256\n" timestamp "\n"
121 scope "\n" (sha256 canonical)))
122 (key (hmac-sha256-bytes
123 (hmac-sha256-bytes
124 (hmac-sha256-bytes
125 (hmac-sha256-bytes (string-append "AWS4" secret-key) date)
126 region)
127 "s3")
128 "aws4_request"))
129 (signature (hmac-sha256 key to-sign))
130 (authorization (string-append
131 "AWS4-HMAC-SHA256 Credential=" access-key "/" scope
132 ", SignedHeaders=" names ", Signature=" signature)))
133 #{ headers: (cons (cons "authorization" authorization) signed)
134 canonical-request: canonical
135 signature: signature
136 path: uri
137 query: qs })))))