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.

Go to file

Nick Khyl 961ee321e8 ipn/{ipnauth,ipnlocal,ipnserver,localapi}: start baby step toward moving access checks from the localapi.Handler to the LocalBackend Currently, we use PermitRead/PermitWrite/PermitCert permission flags to determine which operations are allowed for a LocalAPI client. These checks are performed when localapi.Handler handles a request. Additionally, certain operations (e.g., changing the serve config) requires the connected user to be a local admin. This approach is inherently racey and is subject to TOCTOU issues. We consider it to be more critical on Windows environments, which are inherently multi-user, and therefore we prevent more than one OS user from connecting and utilizing the LocalBackend at the same time. However, the same type of issues is also applicable to other platforms when switching between profiles that have different OperatorUser values in ipn.Prefs. We'd like to allow more than one Windows user to connect, but limit what they can see and do based on their access rights on the device (e.g., an local admin or not) and to the currently active LoginProfile (e.g., owner/operator or not), while preventing TOCTOU issues on Windows and other platforms. Therefore, we'd like to pass an actor from the LocalAPI to the LocalBackend to represent the user performing the operation. The LocalBackend, or the profileManager down the line, will then check the actor's access rights to perform a given operation on the device and against the current (and/or the target) profile. This PR does not change the current permission model in any way, but it introduces the concept of an actor and includes some preparatory work to pass it around. Temporarily, the ipnauth.Actor interface has methods like IsLocalSystem and IsLocalAdmin, which are only relevant to the current permission model. It also lacks methods that will actually be used in the new model. We'll be adding these gradually in the next PRs and removing the deprecated methods and the Permit* flags at the end of the transition. Updates tailscale/corp#18342 Signed-off-by: Nick Khyl <nickk@tailscale.com>		1 year ago
.bencher	bencher: add config to suppress failures on benchmark regressions.	4 years ago
.github	all: switch to and require Go 1.23	1 year ago
appc	appc: track metrics for route info storing	1 year ago
atomicfile	various: add golangci-lint, fix issues (#7905 )	3 years ago
chirp	all: update copyright and license headers	3 years ago
client	usermetric: add initial user-facing metrics	1 year ago
clientupdate	clientupdate: return true for CanAutoUpdate for macsys (#12746 )	1 year ago
cmd	ipn/{ipnauth,ipnlocal,ipnserver,localapi}: start baby step toward moving access checks from the localapi.Handler to the LocalBackend	1 year ago
control	go.{mod,sum}: migrate from nhooyr.io/websocket to github.com/coder/websocket	1 year ago
derp	go.{mod,sum}: migrate from nhooyr.io/websocket to github.com/coder/websocket	1 year ago
disco	disco: correct noun for nacl box type in disco docs	2 years ago
docs	docs/k8s: fix subnet router manifests (#12305 )	2 years ago
doctor	net/{interfaces,netmon}, all: merge net/interfaces package into net/netmon	2 years ago
drive	safesocket: add ConnectContext	2 years ago
envknob	ci: enable checklocks workflow for specific packages	2 years ago
gokrazy	cmd/tta, tstest/natlab/vnet: remove unneeded port 124 log hack, add log buffer	1 year ago
health	usermetric: add initial user-facing metrics	1 year ago
hostinfo	hostinfo: add hostinfo.IsNATLabGuestVM	1 year ago
internal	all: add test for package comments, fix, add comments as needed	1 year ago
ipn	ipn/{ipnauth,ipnlocal,ipnserver,localapi}: start baby step toward moving access checks from the localapi.Handler to the LocalBackend	1 year ago
jsondb	all: update copyright and license headers	3 years ago
k8s-operator	cmd/k8s-operator,k8s-operator/sessionrecording: support recording kubectl exec sessions over WebSockets (#12947 )	1 year ago
kube	all: add test for package comments, fix, add comments as needed	1 year ago
licenses	licenses: update license notices	1 year ago
log	log/sockstatlog: don't block for more than 5s on shutdown	1 year ago
logpolicy	logpolicy: extend the gokrazy/natlab wait-for-network delay for IPv6	1 year ago
logtail	logtail: close idle HTTP connections on shutdown	1 year ago
metrics	usermetric: add initial user-facing metrics	1 year ago
net	net/tstun: fix gvisor inbound GSO packet injection (#13283 )	1 year ago
omit	cmd/tailscaled, ipn/conffile: support ec2 user-data config file	2 years ago
packages/deb	go.mod: upgrade nfpm to v2 (#8786 )	2 years ago
paths	all: use Go 1.22 range-over-int	2 years ago
portlist	all: use Go 1.22 range-over-int	2 years ago
posture	posture: deduplicate MAC addresses before returning them	1 year ago
prober	prober: make status page more clear	1 year ago
proxymap	ci: enable checklocks workflow for specific packages	2 years ago
publicapi	publicapi: add note that API docs have moved to existing docs files (#12770 )	1 year ago
release	release/dist/qnap: omit .qpkg.codesigning files	2 years ago
safesocket	all: fix new lint warnings from bumping staticcheck	1 year ago
safeweb	safeweb: add Server.Close method (#13160 )	1 year ago
scripts	scripts: don't refresh the pacman repository on Arch (#12194 )	2 years ago
sessionrecording	cmd/k8s-operator,k8s-operator/sessionrecording,sessionrecording,ssh/tailssh: refactor session recording functionality (#12945 )	1 year ago
smallzstd	all: use Go 1.22 range-over-int	2 years ago
ssh/tailssh	all: fix new lint warnings from bumping staticcheck	1 year ago
syncs	syncs: add Map.WithLock to allow mutations to the underlying map (#8101 )	1 year ago
tailcfg	ssh/tailssh: fix SSH on busybox systems	1 year ago
taildrop	all: use new AppendEncode methods available in Go 1.22 (#11079 )	2 years ago
tempfork	cmd/tailscale: add shell tab-completion	2 years ago
tka	cmd/tl-longchain: tool to re-sign nodes with long rotation signatures	1 year ago
tool	{tool,client}: bump node version (#12840 )	1 year ago
tsconst	cmd/tailscale/cli: support passing network lock keys via files	1 year ago
tsd	health, all: remove health.Global, finish plumbing health.Tracker	2 years ago
tsnet	usermetric: add initial user-facing metrics	1 year ago
tstest	tstest/natlab/vnet: add qemu + Virtualization.framework protocol tests	1 year ago
tstime	all: use math/rand/v2 more	2 years ago
tsweb	usermetric: add initial user-facing metrics	1 year ago
types	types/opt: add BoolFlag for setting Bool value as a flag	1 year ago
util	usermetric: add initial user-facing metrics	1 year ago
version	version/mkversion: allow env config of oss git cache dir	2 years ago
wf	all: add test for package comments, fix, add comments as needed	1 year ago
wgengine	net/tstun: fix gvisor inbound GSO packet injection (#13283 )	1 year ago
words	words: raccoon dog, dog with the raccoon in 'im	1 year ago
.gitattributes	.: add .gitattributes entry to use Go hunk-header driver	4 years ago
.gitignore	tstest/tailmac: add customized macOS virtualization tooling (#13146 )	1 year ago
.golangci.yml	ci: run 'go vet' in golangci-lint; fix errors in tests	2 years ago
ALPINE.txt	ALPINE.txt,Dockerfile{.base},build_docker.sh: bump alpine (#10543 )	2 years ago
AUTHORS	Move Linux client & common packages into a public repo.	6 years ago
CODEOWNERS	CODEOWNERS: add the start of an owners file	2 years ago
CODE_OF_CONDUCT.md	Add a code of conduct.	6 years ago
Dockerfile	all: switch to and require Go 1.23	1 year ago
Dockerfile.base	ALPINE.txt,Dockerfile{.base},build_docker.sh: bump alpine (#10543 )	2 years ago
LICENSE	all: update tools that manage copyright headers	3 years ago
Makefile	ssh/tailssh: fix SSH on busybox systems	1 year ago
PATENTS	Move Linux client & common packages into a public repo.	6 years ago
README.md	all: switch to and require Go 1.23	1 year ago
SECURITY.md	Add a SECURITY.md for vulnerability reports.	6 years ago
VERSION.txt	VERSION.txt: this is v1.73.0 (#13181 )	1 year ago
api.md	publicapi: add note that API docs have moved to existing docs files (#12770 )	1 year ago
build_dist.sh	cmd/tailscale: add shell tab-completion	2 years ago
build_docker.sh	build_docker.sh: update script comment (#12970 )	1 year ago
flake.lock	flake.nix: build tailscale with go 1.22	2 years ago
flake.nix	go.mod.sri: update SRI hash for go.mod changes	1 year ago
go.mod	cmd/systray: add a basic linux systray app	1 year ago
go.mod.sri	go.mod.sri: update SRI hash for go.mod changes	1 year ago
go.sum	cmd/systray: add a basic linux systray app	1 year ago
go.toolchain.branch	all: switch to and require Go 1.23	1 year ago
go.toolchain.rev	all: switch to and require Go 1.23	1 year ago
gomod_test.go	go.mod: add test that replace directives aren't added in oss	2 years ago
header.txt	cmd/k8s-operator: operator can create subnetrouter (#9505 )	2 years ago
pkgdoc_test.go	all: add test for package comments, fix, add comments as needed	1 year ago
pull-toolchain.sh	pull-toolchain.sh: don't run update-flake.sh	3 years ago
shell.nix	go.mod.sri: update SRI hash for go.mod changes	1 year ago
staticcheck.conf	all: cleanup unused code, part 2 (#10670 )	2 years ago
update-flake.sh	Code Improvements (#11311 )	2 years ago
version-embed.go	version: return correct Meta.MajorMinorPatch in non-dev builds	3 years ago
version_test.go	go.mod,wgengine/netstack: bump gvisor	2 years ago

README.md

Tailscale

https://tailscale.com

Private WireGuard® networks made easy

Overview

This repository contains the majority of Tailscale's open source code. Notably, it includes the tailscaled daemon and the tailscale CLI tool. The tailscaled daemon runs on Linux, Windows, macOS, and to varying degrees on FreeBSD and OpenBSD. The Tailscale iOS and Android apps use this repo's code, but this repo doesn't contain the mobile GUI code.

Other Tailscale repos of note:

the Android app is at https://github.com/tailscale/tailscale-android
the Synology package is at https://github.com/tailscale/tailscale-synology
the QNAP package is at https://github.com/tailscale/tailscale-qpkg
the Chocolatey packaging is at https://github.com/tailscale/tailscale-chocolatey

For background on which parts of Tailscale are open source and why, see https://tailscale.com/opensource/.

Using

We serve packages for a variety of distros and platforms at https://pkgs.tailscale.com.

Other clients

The macOS, iOS, and Windows clients use the code in this repository but additionally include small GUI wrappers. The GUI wrappers on non-open source platforms are themselves not open source.

Building

We always require the latest Go release, currently Go 1.23. (While we build releases with our Go fork, its use is not required.)

go install tailscale.com/cmd/tailscale{,d}

If you're packaging Tailscale for distribution, use build_dist.sh instead, to burn commit IDs and version info into the binaries:

./build_dist.sh tailscale.com/cmd/tailscale
./build_dist.sh tailscale.com/cmd/tailscaled

If your distro has conventions that preclude the use of build_dist.sh, please do the equivalent of what it does in your distro's way, so that bug reports contain useful version information.

Bugs

Please file any issues about this code or the hosted service on the issue tracker.

Contributing

PRs welcome! But please file bugs. Commit messages should reference bugs.

We require Developer Certificate of Origin Signed-off-by lines in commits.

See git log for our commit message style. It's basically the same as Go's style.

About Us

Tailscale is primarily developed by the people at https://github.com/orgs/tailscale/people. For other contributors, see:

Legal

WireGuard is a registered trademark of Jason A. Donenfeld.