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
|
# httpforwarded
[](https://github.com/muhlemmer/httpforwarded/blob/master/LICENSE)
[](https://pkg.go.dev/github.com/muhlemmer/httpforwarded)
[](https://github.com/muhlemmer/httpforwarded/actions/workflows/go.yml)
[](https://codecov.io/gh/muhlemmer/httpforwarded)
The `httpforwarded` go package provides utility functions for working with the
`Forwarded` HTTP header as defined in [RFC-7239](https://tools.ietf.org/html/rfc7239).
This header is proposed to replace the `X-Forwarded-For` and `X-Forwarded-Proto`
headers, amongst others.
This package was heavily inspired by the `mime` package in the standard library,
more specifically the [ParseMediaType()](https://golang.org/pkg/mime/#ParseMediaType)
function.
This is a **fork** from https://github.com/theckman/httpforwarded,
which seems to have become idle for several years.
## License
This package copies some functions, without modification, from the Go standard
library. As such, the entirety of this package is released under the same
permissive BSD-style license as the Go language itself. Please see the contents
of the [LICENSE](https://github.com/muhlemmer/httpforwarded/blob/master/LICENSE)
file for the full details of the license.
## Installing
To install this package for consumption, you can run the following:
```
go get -u github.com/muhlemmer/httpforwarded
```
## Usage
Given a `*http.Request`:
```Go
// var req *http.Request
params, _ := httpforwarded.ParseFromRequest(req)
// you can then do something like this to get the first "for" param:
fmt.Printf("origin %s", params["for"][0])
```
Given a list of `Forwarded` header values:
```Go
// var req *http.Request
headerValues := req.Header[http.CanonicalHeaderKey("forwarded")]
params, _ := httpforwarded.Parse(headerValues)
// you can then do something like this to get the first "for" param:
fmt.Printf("origin %s", params["for"][0])
```
|
