You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
75 lines
2.1 KiB
Go
75 lines
2.1 KiB
Go
package networkobserve
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
)
|
|
|
|
const (
|
|
ReasonProbeUnavailable = "probe_unavailable"
|
|
ReasonPermissionDenied = "permission_denied"
|
|
ReasonNetlinkUnavailable = "netlink_unavailable"
|
|
ReasonConntrackUnavailable = "conntrack_unavailable"
|
|
ReasonAddressFamilyMissing = "address_family_unavailable"
|
|
ReasonProbeFailed = "probe_failed"
|
|
)
|
|
|
|
var (
|
|
ErrPermissionDenied = errors.New("network observation permission denied")
|
|
ErrNetlinkUnavailable = errors.New("netfilter netlink unavailable")
|
|
ErrConntrackUnavailable = errors.New("conntrack unavailable")
|
|
)
|
|
|
|
// ProbeBackend is deliberately read-only. Implementations may inspect kernel
|
|
// capabilities and open a NETLINK_NETFILTER socket, but must never load a
|
|
// module, change a sysctl, or add/replace/flush a firewall rule.
|
|
type ProbeBackend interface {
|
|
Probe(context.Context) (ProbeEvidence, error)
|
|
}
|
|
|
|
type ProbeEvidence struct {
|
|
Conntrack bool
|
|
IPv4 bool
|
|
IPv6 bool
|
|
PacketAccounting bool
|
|
}
|
|
|
|
func ProbeCapability(ctx context.Context, backend ProbeBackend) Capability {
|
|
capability := Capability{
|
|
Name: CapabilityName, ContractVersion: ContractVersion,
|
|
NoPayload: true, PolicyDecisions: false, BucketSeconds: BucketSeconds,
|
|
}
|
|
if backend == nil {
|
|
capability.Reason = ReasonProbeUnavailable
|
|
return capability
|
|
}
|
|
evidence, err := backend.Probe(ctx)
|
|
capability.Conntrack = evidence.Conntrack
|
|
capability.IPv4 = evidence.IPv4
|
|
capability.IPv6 = evidence.IPv6
|
|
capability.PacketAccounting = evidence.PacketAccounting
|
|
if err != nil {
|
|
switch {
|
|
case errors.Is(err, ErrPermissionDenied):
|
|
capability.Reason = ReasonPermissionDenied
|
|
case errors.Is(err, ErrNetlinkUnavailable):
|
|
capability.Reason = ReasonNetlinkUnavailable
|
|
case errors.Is(err, ErrConntrackUnavailable):
|
|
capability.Reason = ReasonConntrackUnavailable
|
|
default:
|
|
capability.Reason = ReasonProbeFailed
|
|
}
|
|
return capability
|
|
}
|
|
if !evidence.Conntrack {
|
|
capability.Reason = ReasonConntrackUnavailable
|
|
return capability
|
|
}
|
|
if !evidence.IPv4 && !evidence.IPv6 {
|
|
capability.Reason = ReasonAddressFamilyMissing
|
|
return capability
|
|
}
|
|
capability.Available = true
|
|
return capability
|
|
}
|