1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
// SPDX-FileCopyrightText: © 2021 Grégoire Duchêne <gduchene@awhk.org>
// SPDX-License-Identifier: ISC
package twilio
import (
"crypto/hmac"
"crypto/sha1"
"encoding/base64"
"errors"
"fmt"
"log"
"net/http"
"sort"
"strings"
)
var (
ErrBase64 = errors.New("failed to decode X-Twilio-Signature header")
ErrMissingHeader = errors.New("missing X-Twilio-Signature header")
ErrSignatureMismatch = errors.New("signature mismatch")
)
type Filter struct {
AuthToken []byte
Handler http.Handler
}
var _ http.Handler = &Filter{}
func (th *Filter) CheckRequestSignature(r *http.Request) error {
hdr := r.Header.Get("X-Twilio-Signature")
if len(hdr) == 0 {
return ErrMissingHeader
}
reqSig, err := base64.StdEncoding.DecodeString(hdr)
if err != nil {
return errors.Join(ErrBase64, err)
}
// See https://www.twilio.com/docs/usage/security#validating-requests
// for more details.
parts := []string{}
if r.Method == http.MethodPost {
if err := r.ParseForm(); err != nil {
return err
}
for k := range r.PostForm {
parts = append(parts, k)
}
sort.Strings(parts)
for i, k := range parts {
parts[i] += r.PostForm[k][0]
}
}
s := r.URL.String() + strings.Join(parts, "")
h := hmac.New(sha1.New, th.AuthToken)
if _, err := h.Write([]byte(s)); err != nil {
return fmt.Errorf("failed to write bytes to calculate signature: %w", err)
}
ourSig := h.Sum(nil)
if !hmac.Equal(reqSig, ourSig) {
return ErrSignatureMismatch
}
return nil
}
func (th *Filter) ServeHTTP(w http.ResponseWriter, r *http.Request) {
if err := th.CheckRequestSignature(r); err != nil {
log.Printf("Failed to check Twilio signature: %s.", err)
switch err {
case ErrBase64, ErrMissingHeader:
w.WriteHeader(http.StatusBadRequest)
case ErrSignatureMismatch:
w.WriteHeader(http.StatusForbidden)
default:
w.WriteHeader(http.StatusInternalServerError)
}
return
}
th.Handler.ServeHTTP(w, r)
}
|