Network.Wai.Serve.Middleware

A collection of middleware useful for static websites.

Middleware Stacks

data MiddlewareStack

A middleware stack is a simple container of Wai middleware. The top of the stack is considered to be the outermost layer of middleware while the bottom of the stack is the innermost layer of middleware.

The stack is a Monoid, so it can be combined with other stacks using <>, and an empty one can be obtained using mempty.

Constructors

MiddlewareStack [Middleware]

The constructor takes a list of middleware, where the left-most item in the list will end up at the top of the stack, and the right-most at the bottom.

Instances

Monoid MiddlewareStack

Methods

mempty :: MiddlewareStack

mappend :: MiddlewareStack -> MiddlewareStack -> MiddlewareStack

mconcat :: [MiddlewareStack] -> MiddlewareStack

(<#>) :: MiddlewareStack -> Middleware -> MiddlewareStack infixl 5

A combinator for adding a middleware to the bottom of a stack.

flatten :: MiddlewareStack -> Middleware

Combines the entire stack into a single middleware.

wrap :: MiddlewareStack -> Application -> Application

Wraps a WAI application in the stack. (Alias of flatten)

Middleware

loggerMiddleware :: Middleware

Logger middleware.

forceSSLMiddleware :: Middleware

Middleware for forcing requests to be done through SSL.

gzipMiddleware :: Middleware

Gzip compression middleware.

domainMiddleware :: Domain -> Middleware

Domain redirection middleware.

When the site is live, we want to redirect users to the right domain name regarles of whether they arrive from a www. domain, the server's IP address or a spoof domain which is pointing to this server.

securityHeadersMiddleware :: Middleware

Common security headers middleware.

stsHeadersMiddleware :: Middleware

Strict Transport Security middleware.

cspHeadersMiddleware :: [Directive] -> Middleware

Content Security Policy middleware.

Here we add the CSP header which includes the policies for this blog.

deindexifyMiddleware :: Middleware

De-indexify middleware.

Redirects any path ending in `/index.html` to just /.