/paranoidhttp

Paranoidhttp provides a pre-configured http.Client that protects you from harm.

Primary LanguageGoMIT LicenseMIT

Paranoidhttp

Build Status

Paranoidhttp provides a pre-configured http.Client that protects you from harm.

Description

Paranoidhttp is a factory of http.Client that is paranoid againt attackers. This is useful when you craete a HTTP request using inputs from possibly malicious users.

The created http.Client protects you from connecting to internal IP ranges even though redirects or DNS tricks are used.

Synopsis

// use the default client for ease
res, err := paranoidhttp.DefaultClient.Get("http://www.hatena.ne.jp")

// or customize the client for yourself
config := paranoidhttp.BasicConfig()
client, transport, dialer := paranoidhttp.NewClient(config)
client.Timeout = 10 * time.Second
transport.DisableCompression = true
dialer.KeepAlive = 60 * time.Second

// Add an exception
cidr, err := net.ParseCIDR("127.0.0.1/32")
config.Exceptions = append(config.Exceptions, cidr)

Known Issues

  • Supports only IPv4 (blocks IPv6).

Acknowledgement

I want to thank LWPx::ParanoidAgent.

License

MIT

Author

hakobe