Files
tailscale/ssh/tailssh/connmonitor_windows.go
Brad Fitzpatrick a59ea059c3 ssh/tailssh: forward TCP as the connecting user on Windows
Dial TCP -L/-D forwards and bind TCP -R forwards while impersonating the
connection's user through an S4U session, instead of as LocalSystem. The
socket, connect, and bind run under the user's token, so Windows Filtering
Platform rules and any per-user bind restrictions apply to the user, as
the unix monitor's user-credential children arrange. The socket's owning
process is still tailscaled, so a connection-to-PID lookup names
tailscaled; impersonation changes the authorized identity, not process
ownership. A non-LocalSystem tailscaled already runs as the user, so it
dials and binds directly.

This replaces the earlier use of gliderssh's default handlers, which dial
and bind as the daemon. Windows now installs its own direct-tcpip and
tcpip-forward handlers, mirroring the unix ones without the monitor.

Move the identity-independent forwarding helpers (the loopback bind
policy, the gateway-ports knob, the RFC 4254 payload structs, and the
copy loop) into fwdshared.go, built on the unix and Windows platforms
that dial and bind themselves, so the Windows handlers do not copy the
loopback policy. plan9 keeps gliderssh's handlers and does not build it.

Unix socket forwarding and agent forwarding stay unsupported on Windows;
fwd_windows.go documents why and what agent forwarding would take.

Updates #4697

Signed-off-by: Brad Fitzpatrick <[email protected]>
Change-Id: Ib7d9f1e3a5c7206e4b8d0f2a6c8e1b3d5f7a9c2e
2026-11-13 05:53:45 +00:00

90 lines
2.7 KiB
Go

// Copyright (c) Tailscale Inc & contributors
// SPDX-License-Identifier: BSD-3-Clause
package tailssh
import (
"errors"
"fmt"
"sync"
"tailscale.com/util/winutil"
"tailscale.com/util/winutil/s4u"
)
// connMonitorState holds the Windows per-connection forwarding state.
//
// Windows has no monitor process like the unix platforms: session
// processes run under the target user's token directly (see
// process_windows.go), and forwarded sockets are dialed and bound by
// this tailscaled while impersonating the connection's user. The only
// per-connection resource is the S4U session used for that impersonation,
// created lazily on the first forward and closed at connection teardown.
//
// When tailscaled is not LocalSystem it already runs as the target user,
// so no impersonation session is needed and sess stays nil.
type connMonitorState struct {
mu sync.Mutex
closed bool
sess *s4u.Session // nil until the first forward as LocalSystem
}
// close closes the impersonation session, if any, and refuses later
// forwards. It is called once at connection teardown.
func (s *connMonitorState) close() {
s.mu.Lock()
defer s.mu.Unlock()
s.closed = true
if s.sess != nil {
s.sess.Close()
s.sess = nil
}
}
func (c *conn) closeConnMonitor() { c.monitor.close() }
// fwdImpersonate runs fn with the connection user's Windows identity in
// effect, so that a forwarded socket's dial or bind is attributed to that
// user rather than to LocalSystem. As LocalSystem it impersonates the user
// through a lazily-created S4U session; otherwise this tailscaled already
// runs as the user and fn runs directly.
//
// Only the socket creation, connect, and bind inside fn need to run under
// the user. Later reads and writes on the returned connection may run
// unimpersonated, as they do with the unix monitor's children.
func (c *conn) fwdImpersonate(fn func()) error {
sess, err := c.fwdSession()
if err != nil {
return err
}
if sess == nil {
fn()
return nil
}
return sess.Do(fn)
}
// fwdSession returns the connection's impersonation session, creating it on
// first use, or nil when tailscaled already runs as the target user.
func (c *conn) fwdSession() (*s4u.Session, error) {
if !winutil.IsCurrentProcessLocalSystem() {
// tailscaled is already the target user; see canSwitchToLocalUser.
return nil, nil
}
c.monitor.mu.Lock()
defer c.monitor.mu.Unlock()
if c.monitor.closed {
return nil, errors.New("ssh: connection is closing")
}
if c.monitor.sess != nil {
return c.monitor.sess, nil
}
lu := c.localUser
sess, err := s4u.Login(c.logf, s4uSourceName, &lu.User, s4u.CapImpersonateOnly)
if err != nil {
return nil, fmt.Errorf("ssh: S4U login to forward as %q: %w", lu.Username, err)
}
c.monitor.sess = sess
return sess, nil
}