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.
virt/agent/networkobserve/capability.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
}