Documentation
¶
Index ¶
- Variables
- func SetReverseResolver(...)
- type Entity
- func (e *Entity) CNAMECheckEnabled() bool
- func (e *Entity) DstPort() uint16
- func (e *Entity) EnableCNAMECheck(ctx context.Context, enabled bool)
- func (e *Entity) EnableReverseResolving()
- func (e *Entity) FetchData(ctx context.Context)
- func (e *Entity) GetASN(ctx context.Context) (uint, bool)
- func (e *Entity) GetCountry(ctx context.Context) (string, bool)
- func (e *Entity) GetDomain(ctx context.Context, mayUseReverseDomain bool) (string, bool)
- func (e *Entity) GetIP() (net.IP, bool)
- func (e *Entity) GetLocation(ctx context.Context) (*geoip.Location, bool)
- func (e *Entity) Init() *Entity
- func (e *Entity) ListBlockReason() ListBlockReason
- func (e *Entity) LoadLists(ctx context.Context) bool
- func (e *Entity) MatchLists(lists []string) bool
- func (e *Entity) ResetLists()
- func (e *Entity) ResolveSubDomainLists(ctx context.Context, enabled bool)
- func (e *Entity) SetDstPort(dstPort uint16)
- type ListBlockReason
- type ListMatch
Constants ¶
This section is empty.
Variables ¶
var ( // Module of this package. Export needed for testing of the endpoints package. Module *modules.Module )
Functions ¶
Types ¶
type Entity ¶ added in v0.4.0
type Entity struct {
sync.Mutex
// Protocol is the protcol number used by the connection.
Protocol uint8
// Port is the remote port of the connection
Port uint16
// Domain is the target domain of the connection.
Domain string
// ReverseDomain is the domain the IP address points to. This is only
// resolved and populated when needed.
ReverseDomain string
// CNAME is a list of domain names that have been
// resolved for Domain.
CNAME []string
// IP is the IP address of the connection. If domain is
// set, IP has been resolved by following all CNAMEs.
IP net.IP
// Country holds the country the IP address (ASN) is
// located in.
Country string
// ASN holds the autonomous system number of the IP.
ASN uint
// BlockedByLists holds list source IDs that
// are used to block the entity.
BlockedByLists []string
// BlockedEntities holds a list of entities that
// have been blocked. Values can be used as a key
// for the ListOccurences map.
BlockedEntities []string
// ListOccurences is a map that matches an entity (Domain, IPs, ASN, Country, Sub-domain)
// to a list of sources where the entity has been observed in.
ListOccurences map[string][]string
// contains filtered or unexported fields
}
Entity describes a remote endpoint in many different ways. It embeddes a sync.Mutex but none of the endpoints own functions performs locking. The caller MUST ENSURE proper locking and synchronization when accessing any properties of Entity.
func (*Entity) CNAMECheckEnabled ¶ added in v0.4.1
CNAMECheckEnabled returns true if the entities CNAMEs should also be checked.
func (*Entity) EnableCNAMECheck ¶ added in v0.4.1
EnableCNAMECheck enalbes or disables list lookups for entity CNAMEs.
func (*Entity) EnableReverseResolving ¶ added in v0.4.0
func (e *Entity) EnableReverseResolving()
EnableReverseResolving enables reverse resolving the domain from the IP on demand.
func (*Entity) FetchData ¶ added in v0.4.0
FetchData fetches additional information, meant to be called before persisting an entity record.
func (*Entity) GetCountry ¶ added in v0.4.0
GetCountry returns the two letter ISO country code and whether it is set.
func (*Entity) GetLocation ¶ added in v0.4.0
GetLocation returns the raw location data and whether it is set.
func (*Entity) ListBlockReason ¶ added in v0.4.1
func (e *Entity) ListBlockReason() ListBlockReason
ListBlockReason returns the block reason for this entity.
func (*Entity) LoadLists ¶ added in v0.4.1
LoadLists searches all filterlists for all occurrences of this entity.
func (*Entity) MatchLists ¶ added in v0.4.1
MatchLists matches the entities lists against a slice of source IDs and updates various entity properties like BlockedByLists, ListOccurences and BlockedEntitites.
func (*Entity) ResetLists ¶ added in v0.4.0
func (e *Entity) ResetLists()
ResetLists resets the current list data and forces all list sources to be re-acquired when calling GetLists().
func (*Entity) ResolveSubDomainLists ¶ added in v0.4.0
ResolveSubDomainLists enables or disables list lookups for sub-domains.
func (*Entity) SetDstPort ¶ added in v0.6.0
SetDstPort sets the destination port.
type ListBlockReason ¶ added in v0.4.1
type ListBlockReason []ListMatch
ListBlockReason is a list of list matches.
func (ListBlockReason) Context ¶ added in v0.4.1
func (br ListBlockReason) Context() interface{}
Context returns br wrapped into a map. It implements the endpoints.Reason interface.
func (ListBlockReason) GetExtraRRs ¶ added in v0.5.5
GetExtraRRs implements the nsutil.RRProvider interface and adds additional TXT records justifying the reason the request was blocked.
func (ListBlockReason) MarshalJSON ¶ added in v0.4.1
func (br ListBlockReason) MarshalJSON() ([]byte, error)
MarshalJSON marshals the list block reason into a map prefixed with filterlists.
func (ListBlockReason) String ¶ added in v0.4.1
func (br ListBlockReason) String() string
Source Files
Directories