README
¶
HTTP over SCION
This package contains glue code to use the standard net/http libraries for HTTP over SCION.
This uses a QUIC session with a single stream as a transport, instead of the standard TCP (for which we do not have an implementation on top of SCION). As TLS is always enabled in QUIC, we use an insecure TLS session with self signed certificates to get something similar to TCP for insecure HTTP. For HTTPS, we'll have two TLS sessions; the insecure TLS for the basic transport and on top of that, the "normal" TLS for the actual web content. This may seem silly, and the net/http library provides enough hooks that would allow using the "normal" TLS session directly. However, only this setup allows to implement CONNECT, e.g. to proxy HTTPS traffic over HTTP.
Client
We use the standard net/http Client/Transport with a customized Dial function:
// Create a client with our Transport/Dialer:
client := &http.Client{
Transport: shttp.DefaultTransport,
}
// Make requests as usual
resp, err := client.Get("http://server:8080/download")
Hostnames are resolved by parsing the /etc/hosts file or by a RAINS lookup
(see Hostnames).
URLs potentially containing raw SCION addresses must be mangled before
passing into the client (or any other place where they might be parsed as URL).
resp, err := client.Get(shttp.MangleSCIONURL("http://1-ff00:0:110,127.0.0.1:8080/download"))
Server
The server is used just like the standard net/http server; the handlers work all the same, only a custom listener is used for serving.
Example:
handler := http.FileServer(http.Dir("/usr/share/doc"))))
log.Fatal(shttp.ListenAndServe(":80", handler))
Documentation
¶
Overview ¶
package shttp provides glue to use net/http libraries for HTTP over SCION.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var DefaultTransport = &http.Transport{ Proxy: http.ProxyFromEnvironment, DialContext: (&Dialer{ QuicConfig: nil, }).DialContext, ForceAttemptHTTP2: true, MaxIdleConns: 100, IdleConnTimeout: 90 * time.Second, TLSHandshakeTimeout: 10 * time.Second, ExpectContinueTimeout: 1 * time.Second, }
DefaultTransport is the default RoundTripper that can be used for HTTP over SCION/QUIC. This is equivalent to net/http.DefaultTransport with DialContext overridden to use shttp.Dialer, which dials connections over SCION/QUIC.
Functions ¶
func ListenAndServe ¶
ListenAndServe listens for HTTP connections on the SCION address addr and calls Serve with handler to handle requests
func ListenAndServeTLS ¶ added in v0.4.0
ListenAndServe listens for HTTPS connections on the SCION address addr and calls Serve with handler to handle requests
func MangleSCIONAddrURL ¶
MangleSCIONAddrURL mangles a SCION address in the host part of a URL-ish string so that it can be safely used as a URL, i.e. it can be parsed by net/url.Parse
Types ¶
type Dialer ¶ added in v0.4.0
Dialer dials an insecure, single-stream QUIC connection over SCION (just pretend it's TCP). This is the Dialer used for shttp.DefaultTransport.
type Server ¶
Server wraps a http.Server making it work with SCION
func (*Server) ListenAndServe ¶
ListenAndServe listens for QUIC connections on srv.Addr and calls Serve to handle incoming requests
Source Files