2023-03-01 10:27:24 +00:00
|
|
|
package home
|
|
|
|
|
|
|
|
import (
|
|
|
|
"encoding"
|
|
|
|
"fmt"
|
2023-04-06 12:12:50 +01:00
|
|
|
"time"
|
2023-03-01 10:27:24 +00:00
|
|
|
|
2023-03-15 11:31:07 +00:00
|
|
|
"github.com/AdguardTeam/AdGuardHome/internal/filtering"
|
2023-04-06 12:12:50 +01:00
|
|
|
"github.com/AdguardTeam/AdGuardHome/internal/filtering/safesearch"
|
2023-06-21 10:53:53 +01:00
|
|
|
"github.com/AdguardTeam/AdGuardHome/internal/whois"
|
2023-03-01 10:27:24 +00:00
|
|
|
"github.com/AdguardTeam/dnsproxy/proxy"
|
2023-05-25 15:45:55 +01:00
|
|
|
"github.com/AdguardTeam/golibs/stringutil"
|
2023-03-01 10:27:24 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
// Client contains information about persistent clients.
|
|
|
|
type Client struct {
|
|
|
|
// upstreamConfig is the custom upstream config for this client. If
|
|
|
|
// it's nil, it has not been initialized yet. If it's non-nil and
|
|
|
|
// empty, there are no valid upstreams. If it's non-nil and non-empty,
|
|
|
|
// these upstream must be used.
|
|
|
|
upstreamConfig *proxy.UpstreamConfig
|
|
|
|
|
2023-03-15 11:31:07 +00:00
|
|
|
safeSearchConf filtering.SafeSearchConfig
|
|
|
|
SafeSearch filtering.SafeSearch
|
|
|
|
|
2023-06-27 16:03:07 +01:00
|
|
|
// BlockedServices is the configuration of blocked services of a client.
|
|
|
|
BlockedServices *filtering.BlockedServices
|
|
|
|
|
2023-03-01 10:27:24 +00:00
|
|
|
Name string
|
|
|
|
|
2023-06-27 16:03:07 +01:00
|
|
|
IDs []string
|
|
|
|
Tags []string
|
|
|
|
Upstreams []string
|
2023-03-01 10:27:24 +00:00
|
|
|
|
|
|
|
UseOwnSettings bool
|
|
|
|
FilteringEnabled bool
|
|
|
|
SafeBrowsingEnabled bool
|
|
|
|
ParentalEnabled bool
|
|
|
|
UseOwnBlockedServices bool
|
2023-04-07 11:17:40 +01:00
|
|
|
IgnoreQueryLog bool
|
|
|
|
IgnoreStatistics bool
|
2023-03-01 10:27:24 +00:00
|
|
|
}
|
|
|
|
|
2023-05-25 15:45:55 +01:00
|
|
|
// ShallowClone returns a deep copy of the client, except upstreamConfig,
|
|
|
|
// safeSearchConf, SafeSearch fields, because it's difficult to copy them.
|
|
|
|
func (c *Client) ShallowClone() (sh *Client) {
|
|
|
|
clone := *c
|
|
|
|
|
2023-06-27 16:03:07 +01:00
|
|
|
clone.BlockedServices = c.BlockedServices.Clone()
|
2023-05-25 15:45:55 +01:00
|
|
|
clone.IDs = stringutil.CloneSlice(c.IDs)
|
|
|
|
clone.Tags = stringutil.CloneSlice(c.Tags)
|
|
|
|
clone.Upstreams = stringutil.CloneSlice(c.Upstreams)
|
|
|
|
|
|
|
|
return &clone
|
|
|
|
}
|
|
|
|
|
2023-03-01 10:27:24 +00:00
|
|
|
// closeUpstreams closes the client-specific upstream config of c if any.
|
|
|
|
func (c *Client) closeUpstreams() (err error) {
|
|
|
|
if c.upstreamConfig != nil {
|
|
|
|
err = c.upstreamConfig.Close()
|
|
|
|
if err != nil {
|
|
|
|
return fmt.Errorf("closing upstreams of client %q: %w", c.Name, err)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
2023-04-06 12:12:50 +01:00
|
|
|
// setSafeSearch initializes and sets the safe search filter for this client.
|
|
|
|
func (c *Client) setSafeSearch(
|
|
|
|
conf filtering.SafeSearchConfig,
|
|
|
|
cacheSize uint,
|
|
|
|
cacheTTL time.Duration,
|
|
|
|
) (err error) {
|
|
|
|
ss, err := safesearch.NewDefault(conf, fmt.Sprintf("client %q", c.Name), cacheSize, cacheTTL)
|
|
|
|
if err != nil {
|
|
|
|
// Don't wrap the error, because it's informative enough as is.
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
c.SafeSearch = ss
|
|
|
|
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
2023-03-01 10:27:24 +00:00
|
|
|
// clientSource represents the source from which the information about the
|
|
|
|
// client has been obtained.
|
|
|
|
type clientSource uint
|
|
|
|
|
|
|
|
// Clients information sources. The order determines the priority.
|
|
|
|
const (
|
|
|
|
ClientSourceNone clientSource = iota
|
|
|
|
ClientSourceWHOIS
|
|
|
|
ClientSourceARP
|
|
|
|
ClientSourceRDNS
|
|
|
|
ClientSourceDHCP
|
|
|
|
ClientSourceHostsFile
|
|
|
|
ClientSourcePersistent
|
|
|
|
)
|
|
|
|
|
|
|
|
// type check
|
|
|
|
var _ fmt.Stringer = clientSource(0)
|
|
|
|
|
|
|
|
// String returns a human-readable name of cs.
|
|
|
|
func (cs clientSource) String() (s string) {
|
|
|
|
switch cs {
|
|
|
|
case ClientSourceWHOIS:
|
|
|
|
return "WHOIS"
|
|
|
|
case ClientSourceARP:
|
|
|
|
return "ARP"
|
|
|
|
case ClientSourceRDNS:
|
|
|
|
return "rDNS"
|
|
|
|
case ClientSourceDHCP:
|
|
|
|
return "DHCP"
|
|
|
|
case ClientSourceHostsFile:
|
|
|
|
return "etc/hosts"
|
|
|
|
default:
|
|
|
|
return ""
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// type check
|
|
|
|
var _ encoding.TextMarshaler = clientSource(0)
|
|
|
|
|
|
|
|
// MarshalText implements encoding.TextMarshaler for the clientSource.
|
|
|
|
func (cs clientSource) MarshalText() (text []byte, err error) {
|
|
|
|
return []byte(cs.String()), nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// RuntimeClient is a client information about which has been obtained using the
|
|
|
|
// source described in the Source field.
|
|
|
|
type RuntimeClient struct {
|
2023-06-21 10:53:53 +01:00
|
|
|
// WHOIS is the filtered WHOIS data of a client.
|
|
|
|
WHOIS *whois.Info
|
|
|
|
|
|
|
|
// Host is the host name of a client.
|
|
|
|
Host string
|
2023-03-01 10:27:24 +00:00
|
|
|
|
2023-06-21 10:53:53 +01:00
|
|
|
// Source is the source from which the information about the client has
|
|
|
|
// been obtained.
|
|
|
|
Source clientSource
|
2023-03-01 10:27:24 +00:00
|
|
|
}
|