home

Documentation

Overview

Package home contains AdGuard Home's HTTP API methods.

Index

• Constants
• Variables
• func Main(clientBuildFS fs.FS)
• func RegisterAuthHandlers()
• type Auth
  • func InitAuth(dbFilename string, users []webUser, sessionTTL uint32, ...) (a *Auth)
  • func (a *Auth) Close()
• type BlockedClientChecker
• type Theme
  • func (t *Theme) UnmarshalText(b []byte) (err error)

Constants

const MaxFileSize = 1024 * 1024

MaxFileSize is a maximum file length in bytes.

const PasswordMinRunes = 8

PasswordMinRunes is the minimum length of user's password in runes.

Variables

var Context homeContext

Context - a global context object

TODO(a.garipov): Refactor.

var GLMode bool

GLMode - enable GL-Inet compatibility mode

Functions

func Main

func Main(clientBuildFS fs.FS)

Main is the entry point

func RegisterAuthHandlers

func RegisterAuthHandlers()

RegisterAuthHandlers - register handlers

Types

type Auth

type Auth struct {
	// contains filtered or unexported fields
}

Auth is the global authentication object.

func InitAuth

func InitAuth(
	dbFilename string,
	users []webUser,
	sessionTTL uint32,
	rateLimiter *authRateLimiter,
	trustedProxies netutil.SubnetSet,
) (a *Auth)

InitAuth initializes the global authentication object.

func (*Auth) Close

func (a *Auth) Close()

Close closes the authentication database.

type BlockedClientChecker

type BlockedClientChecker interface {
	IsBlockedClient(ip netip.Addr, clientID string) (blocked bool, rule string)
}

BlockedClientChecker checks if a client is blocked by the current access settings.

type Theme

type Theme string

Theme is an enum of all allowed UI themes.

const (
	ThemeAuto  Theme = "auto"
	ThemeLight Theme = "light"
	ThemeDark  Theme = "dark"
)

Allowed Theme values.

Keep in sync with client/src/helpers/constants.ts.

func (*Theme) UnmarshalText

func (t *Theme) UnmarshalText(b []byte) (err error)

UnmarshalText implements encoding.TextUnmarshaler interface for *Theme.