Basic Authentication Middleware

Basic Authentication is an authentication method where the client sends its credentials unencrypted to the server for validation. This middleware implements this process. A detailed description can also be found here.

The credentials can be stored in different forms. This module has an interface for authenticators, that provide the final verification, and concentrates on the protocol between the client and the server. Further a simple example authenticator is provided that is to be configured with the allowed credentials.

Example

finalHandler := midgard.StackMiddlewareHandler(
    []midgard.Middleware{
        util.Must(basic_auth.New(
            basic_auth.WithRealm("example realm"),
            basic_auth.WithAuthenticator(util.Must(
                map_auth.New(
                    map_auth.WithAuths(map[string]string{
                        "user0": "pass0",
                        "user1": "pass1",
                    }),
                ),
            )),
        )),
    },
    http.HandlerFunc(HelloHandler),
)

If no realm is specified using WithRealm the default Restricted is used. Not providing an authenticator is an error condition.