mirror of
https://github.com/tailscale/tailscale.git
synced 2026-11-21 01:01:18 -08:00
Package tailcfg defines the types and constants used by the Tailscale protocol, but since everything is all in one package, it’s difficult to sift through the docs: https://pkg.go.dev/tailscale.com/tailcfg We define and enumerate capabilities as string constants for tailcfg.NodeCapability and tailcfg.PeerCapability. This PR extracts them into their own packages: - tailcfg.CapabilityFileSharing becomes nodecap.FileSharing - tailcfg.NodeAttrOnlyTCP443 becomes nodecap.OnlyTCP443 - tailcfg.PeerCapabilityTaildrive becomes peercap.Taildrive We originally intended for CapabilityFoo to grant an entitlement or permission for Foo, and for NodeAttrBar to configure Bar in the nodeAttrs section of the policy file. However, there was no technical enforcement of this convention, so new capabilities have used the NodeAttr prefix regardless of meaning. Therefore, this PR unifies tailcfg.CapabilityFoo and tailcfg.NodeAttrBar into a single package as nodecap.Foo and nodecap.Bar. Ran `go fix -inline ./...` and committed the changes that replaced uses of the tailcfg aliases with the authoritative ones. Updates #20259 Change-Id: Ieb7e7e6c8247c39faf42fdf15c68cdc7c621c730 Signed-off-by: Simon Law <[email protected]>
108 lines
2.4 KiB
Go
108 lines
2.4 KiB
Go
// Copyright (c) Tailscale Inc & contributors
|
|
// SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
package filter
|
|
|
|
import (
|
|
"net/netip"
|
|
|
|
"tailscale.com/net/packet"
|
|
"tailscale.com/tailcfg/nodecap"
|
|
"tailscale.com/types/views"
|
|
"tailscale.com/wgengine/filter/filtertype"
|
|
)
|
|
|
|
type matches []filtertype.Match
|
|
|
|
func (ms matches) match(q *packet.Parsed, hasCap CapTestFunc) bool {
|
|
for i := range ms {
|
|
m := &ms[i]
|
|
if !views.SliceContains(m.IPProto, q.IPProto) {
|
|
continue
|
|
}
|
|
if !srcMatches(m, q.Src.Addr(), hasCap) {
|
|
continue
|
|
}
|
|
for _, dst := range m.Dsts {
|
|
if !dst.Net.Contains(q.Dst.Addr()) {
|
|
continue
|
|
}
|
|
if !dst.Ports.Contains(q.Dst.Port()) {
|
|
continue
|
|
}
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
// srcMatches reports whether srcAddr matche the src requirements in m, either
|
|
// by Srcs (using SrcsContains), or by the node having a capability listed
|
|
// in SrcCaps using the provided hasCap function.
|
|
func srcMatches(m *filtertype.Match, srcAddr netip.Addr, hasCap CapTestFunc) bool {
|
|
if m.SrcsContains(srcAddr) {
|
|
return true
|
|
}
|
|
if hasCap != nil {
|
|
for _, c := range m.SrcCaps {
|
|
if hasCap(srcAddr, c) {
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
// CapTestFunc is the function signature of a function that tests whether srcIP
|
|
// has a given capability.
|
|
//
|
|
// It is used in the fast path of evaluating filter rules so should be fast.
|
|
type CapTestFunc = func(srcIP netip.Addr, cap nodecap.Cap) bool
|
|
|
|
func (ms matches) matchIPsOnly(q *packet.Parsed, hasCap CapTestFunc) bool {
|
|
srcAddr := q.Src.Addr()
|
|
for _, m := range ms {
|
|
if !m.SrcsContains(srcAddr) {
|
|
continue
|
|
}
|
|
for _, dst := range m.Dsts {
|
|
if dst.Net.Contains(q.Dst.Addr()) {
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
if hasCap != nil {
|
|
for _, m := range ms {
|
|
for _, c := range m.SrcCaps {
|
|
if hasCap(srcAddr, c) {
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
// matchProtoAndIPsOnlyIfAllPorts reports q matches any Match in ms where the
|
|
// Match if for the right IP Protocol and IP address, but ports are
|
|
// ignored, as long as the match is for the entire uint16 port range.
|
|
func (ms matches) matchProtoAndIPsOnlyIfAllPorts(q *packet.Parsed) bool {
|
|
for _, m := range ms {
|
|
if !views.SliceContains(m.IPProto, q.IPProto) {
|
|
continue
|
|
}
|
|
if !m.SrcsContains(q.Src.Addr()) {
|
|
continue
|
|
}
|
|
for _, dst := range m.Dsts {
|
|
if dst.Ports != filtertype.AllPorts {
|
|
continue
|
|
}
|
|
if dst.Net.Contains(q.Dst.Addr()) {
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
return false
|
|
}
|