Documentation
¶
Overview ¶
Package http provides HTTP authentication utilities and interfaces.
Index ¶
- func HandlerFunc(cfg *ServerConfig, origHandler http.HandlerFunc) (http.HandlerFunc, error)
- func MultiAuthnHandlerFunc(cfg *ServerConfig, origHandler http.HandlerFunc) http.HandlerFunc
- func NewRequestModifier(cfg ClientConfig) func(*http.Request) error
- func NullHandler(next http.HandlerFunc) http.HandlerFunc
- type Authenticator
- type ClientAuth
- type ClientConfig
- type GenericAuthConfig
- type Handler
- type Middleware
- type ServerConfig
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func HandlerFunc ¶
func HandlerFunc(cfg *ServerConfig, origHandler http.HandlerFunc) (http.HandlerFunc, error)
HandlerFunc creates an authentication-wrapped HTTP handler function from the provided configuration.
func MultiAuthnHandlerFunc ¶
func MultiAuthnHandlerFunc(cfg *ServerConfig, origHandler http.HandlerFunc) http.HandlerFunc
MultiAuthnHandlerFunc creates a handler function that supports multiple authentication providers.
func NewRequestModifier ¶ added in v0.6.0
func NewRequestModifier(cfg ClientConfig) func(*http.Request) error
NewRequestModifier returns a request modifier function that applies auth credentials and netrc credentials to outgoing requests. It is designed for use with github.com/dioad/net/http.ClientConfig.RequestModifier.
func NullHandler ¶
func NullHandler(next http.HandlerFunc) http.HandlerFunc
NullHandler is a handler that passes through to the next handler without authentication.
Types ¶
type Authenticator ¶
Authenticator is an interface for authenticating an HTTP request.
type ClientAuth ¶
ClientAuth is an interface for adding authentication to an HTTP request.
func NewClientAuth ¶
func NewClientAuth(authConfig ClientConfig) ClientAuth
NewClientAuth returns a ClientAuth implementation based on the provided configuration.
type ClientConfig ¶
type ClientConfig struct {
BasicAuthConfig basic.ClientConfig `mapstructure:"basic"`
GitHubAuthConfig github.ClientConfig `mapstructure:"github"`
HMACAuthConfig hmac.ClientConfig `mapstructure:"hmac"`
}
ClientConfig represents the authentication configuration for an HTTP client.
type GenericAuthConfig ¶
type GenericAuthConfig struct {
Name string `mapstructure:"name"`
Config map[string]any `mapstructure:"config"`
}
GenericAuthConfig represents a generic authentication configuration.
type Handler ¶
type Handler struct {
Config ServerConfig
// contains filtered or unexported fields
}
Handler describes an HTTP authentication handler.
func NewHandler ¶
func NewHandler(cfg *ServerConfig) (*Handler, error)
NewHandler creates a new authentication handler from the provided configuration.
type Middleware ¶
type Middleware interface {
// AuthRequest(r *http.Request) (stdctx.Context, error)
Wrap(http.Handler) http.Handler
}
Middleware is an interface for wrapping an HTTP handler with authentication.
type ServerConfig ¶
type ServerConfig struct {
// Type selects the auth handler explicitly: "github", "basic", "hmac", "jwt", "oidc".
// When set it takes precedence over zero-value detection. An unrecognised Type
// returns an error from NewHandler.
Type string `mapstructure:"type"`
BasicAuthConfig basic.ServerConfig `mapstructure:"basic"`
GitHubAuthConfig github.ServerConfig `mapstructure:"github"`
HMACAuthConfig hmac.ServerConfig `mapstructure:"hmac"`
JWTAuthConfig jwt.ValidatorConfig `mapstructure:"jwt"`
OIDCAuthConfig oidc.ClientConfig `mapstructure:"oidc"`
Providers []string `mapstructure:"providers"`
}
ServerConfig represents the authentication configuration for an HTTP server.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
authz
|
|
|
principal
Package principal provides principal-based authorization middleware.
|
Package principal provides principal-based authorization middleware. |
|
Package basic provides HTTP Basic authentication middleware and utilities.
|
Package basic provides HTTP Basic authentication middleware and utilities. |
|
Package github provides GitHub-based authentication middleware.
|
Package github provides GitHub-based authentication middleware. |
|
Package hmac provides HMAC-based authentication middleware.
|
Package hmac provides HMAC-based authentication middleware. |
|
Package oidc provides HTTP authentication using OpenID Connect via goth.
|
Package oidc provides HTTP authentication using OpenID Connect via goth. |
|
Package server provides auth-specific ServerOption factories for github.com/dioad/net/http servers.
|
Package server provides auth-specific ServerOption factories for github.com/dioad/net/http servers. |