2021-05-21 14:15:47 +01:00
|
|
|
package filtering
|
2018-08-30 15:25:33 +01:00
|
|
|
|
2023-03-09 12:39:35 +00:00
|
|
|
// SafeSearch interface describes a service for search engines hosts rewrites.
|
|
|
|
type SafeSearch interface {
|
2023-04-12 12:48:42 +01:00
|
|
|
// CheckHost checks host with safe search filter. CheckHost must be safe
|
|
|
|
// for concurrent use. qtype must be either [dns.TypeA] or [dns.TypeAAAA].
|
2023-03-09 12:39:35 +00:00
|
|
|
CheckHost(host string, qtype uint16) (res Result, err error)
|
2023-04-12 12:48:42 +01:00
|
|
|
|
|
|
|
// Update updates the configuration of the safe search filter. Update must
|
|
|
|
// be safe for concurrent use. An implementation of Update may ignore some
|
|
|
|
// fields, but it must document which.
|
|
|
|
Update(conf SafeSearchConfig) (err error)
|
2023-03-09 12:39:35 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// SafeSearchConfig is a struct with safe search related settings.
|
|
|
|
type SafeSearchConfig struct {
|
|
|
|
// Enabled indicates if safe search is enabled entirely.
|
|
|
|
Enabled bool `yaml:"enabled" json:"enabled"`
|
|
|
|
|
|
|
|
// Services flags. Each flag indicates if the corresponding service is
|
|
|
|
// enabled or disabled.
|
|
|
|
|
|
|
|
Bing bool `yaml:"bing" json:"bing"`
|
|
|
|
DuckDuckGo bool `yaml:"duckduckgo" json:"duckduckgo"`
|
|
|
|
Google bool `yaml:"google" json:"google"`
|
|
|
|
Pixabay bool `yaml:"pixabay" json:"pixabay"`
|
|
|
|
Yandex bool `yaml:"yandex" json:"yandex"`
|
|
|
|
YouTube bool `yaml:"youtube" json:"youtube"`
|
|
|
|
}
|
|
|
|
|
2023-04-12 12:48:42 +01:00
|
|
|
// checkSafeSearch checks host with safe search engine. Matches
|
|
|
|
// [hostChecker.check].
|
2021-03-25 17:30:30 +00:00
|
|
|
func (d *DNSFilter) checkSafeSearch(
|
|
|
|
host string,
|
2023-04-12 12:48:42 +01:00
|
|
|
qtype uint16,
|
2021-05-21 14:15:47 +01:00
|
|
|
setts *Settings,
|
2021-03-25 17:30:30 +00:00
|
|
|
) (res Result, err error) {
|
2024-05-15 11:34:12 +01:00
|
|
|
if d.safeSearch == nil || !setts.ProtectionEnabled || !setts.SafeSearchEnabled {
|
2020-12-07 12:38:05 +00:00
|
|
|
return Result{}, nil
|
|
|
|
}
|
|
|
|
|
2023-04-12 12:48:42 +01:00
|
|
|
clientSafeSearch := setts.ClientSafeSearch
|
|
|
|
if clientSafeSearch != nil {
|
|
|
|
return clientSafeSearch.CheckHost(host, qtype)
|
2020-12-17 10:32:46 +00:00
|
|
|
}
|
|
|
|
|
2023-04-12 12:48:42 +01:00
|
|
|
return d.safeSearch.CheckHost(host, qtype)
|
2018-08-30 15:25:33 +01:00
|
|
|
}
|