Fold init-only VNC and SSH setters into Config-struct constructors

This commit is contained in:
Viktor Liu
2026-05-22 13:32:25 +02:00
parent f00b34f3a7
commit 8ca5c2f4b4
7 changed files with 116 additions and 113 deletions
+6 -3
View File
@@ -54,9 +54,12 @@ var vncAgentCmd = &cobra.Command{
// The per-user agent listens only on loopback and is gated by an // The per-user agent listens only on loopback and is gated by an
// agent token shared with the daemon, so no X25519 identity key // agent token shared with the daemon, so no X25519 identity key
// is needed; auth is disabled at the RFB layer. // is needed; auth is disabled at the RFB layer.
srv := vncserver.New(capturer, injector, nil) srv := vncserver.New(vncserver.Config{
srv.SetDisableAuth(true) Capturer: capturer,
srv.SetAgentToken(token) Injector: injector,
DisableAuth: true,
AgentTokenHex: token,
})
addr := netip.AddrPortFrom(netip.AddrFrom4([4]byte{127, 0, 0, 1}), vncAgentPort) addr := netip.AddrPortFrom(netip.AddrFrom4([4]byte{127, 0, 0, 1}), vncAgentPort)
loopback := netip.PrefixFrom(netip.AddrFrom4([4]byte{127, 0, 0, 0}), 8) loopback := netip.PrefixFrom(netip.AddrFrom4([4]byte{127, 0, 0, 0}), 8)
+5 -9
View File
@@ -237,22 +237,18 @@ func (e *Engine) startSSHServer(jwtConfig *sshserver.JWTConfig) error {
return errors.New("wg interface not initialized") return errors.New("wg interface not initialized")
} }
wgAddr := e.wgInterface.Address()
serverConfig := &sshserver.Config{ serverConfig := &sshserver.Config{
HostKeyPEM: e.config.SSHKey, HostKeyPEM: e.config.SSHKey,
JWT: jwtConfig, JWT: jwtConfig,
NetstackNet: e.wgInterface.GetNet(),
NetworkValidation: wgAddr,
} }
server := sshserver.New(serverConfig) server := sshserver.New(serverConfig)
wgAddr := e.wgInterface.Address()
server.SetNetworkValidation(wgAddr)
netbirdIP := wgAddr.IP netbirdIP := wgAddr.IP
listenAddr := netip.AddrPortFrom(netbirdIP, sshserver.InternalSSHPort) listenAddr := netip.AddrPortFrom(netbirdIP, sshserver.InternalSSHPort)
if netstackNet := e.wgInterface.GetNet(); netstackNet != nil {
server.SetNetstackNet(netstackNet)
}
e.configureSSHServer(server) e.configureSSHServer(server)
if err := server.Start(e.ctx, listenAddr); err != nil { if err := server.Start(e.ctx, listenAddr); err != nil {
+13 -9
View File
@@ -99,9 +99,9 @@ func (e *Engine) startVNCServer() error {
netbirdIP := e.wgInterface.Address().IP netbirdIP := e.wgInterface.Address().IP
srv := vncserver.New(capturer, injector, e.config.WgPrivateKey[:]) var sessionRecorder func(vncserver.SessionTick)
if e.clientMetrics != nil { if e.clientMetrics != nil {
srv.SetSessionRecorder(func(t vncserver.SessionTick) { sessionRecorder = func(t vncserver.SessionTick) {
e.clientMetrics.RecordVNCSessionTick(e.ctx, metrics.VNCSessionTick{ e.clientMetrics.RecordVNCSessionTick(e.ctx, metrics.VNCSessionTick{
Period: t.Period, Period: t.Period,
BytesOut: t.BytesOut, BytesOut: t.BytesOut,
@@ -112,16 +112,20 @@ func (e *Engine) startVNCServer() error {
MaxWriteBytes: t.MaxWriteBytes, MaxWriteBytes: t.MaxWriteBytes,
WriteNanos: t.WriteNanos, WriteNanos: t.WriteNanos,
}) })
}) }
} }
if vncNeedsServiceMode() { serviceMode := vncNeedsServiceMode()
if serviceMode {
log.Info("VNC: running in Session 0, enabling service mode (agent proxy)") log.Info("VNC: running in Session 0, enabling service mode (agent proxy)")
srv.SetServiceMode(true)
}
if netstackNet := e.wgInterface.GetNet(); netstackNet != nil {
srv.SetNetstackNet(netstackNet)
} }
srv := vncserver.New(vncserver.Config{
Capturer: capturer,
Injector: injector,
IdentityKey: e.config.WgPrivateKey[:],
ServiceMode: serviceMode,
SessionRecorder: sessionRecorder,
NetstackNet: e.wgInterface.GetNet(),
})
listenAddr := netip.AddrPortFrom(netbirdIP, vncInternalPort) listenAddr := netip.AddrPortFrom(netbirdIP, vncInternalPort)
network := e.wgInterface.Address().Network network := e.wgInterface.Address().Network
+13 -16
View File
@@ -197,6 +197,14 @@ type Config struct {
// HostKey is the SSH server host key in PEM format // HostKey is the SSH server host key in PEM format
HostKeyPEM []byte HostKeyPEM []byte
// NetstackNet, when non-nil, makes the SSH server listen via the
// supplied userspace network stack instead of an OS socket.
NetstackNet *netstack.Net
// NetworkValidation, when non-zero, restricts inbound connections to
// peers inside the NetBird overlay defined by this WireGuard address.
NetworkValidation wgaddr.Address
} }
// SessionInfo contains information about an active SSH session // SessionInfo contains information about an active SSH session
@@ -208,12 +216,15 @@ type SessionInfo struct {
PortForwards []string PortForwards []string
} }
// New creates an SSH server instance with the provided host key and optional JWT configuration // New creates an SSH server instance from the supplied Config. Fields are
// If jwtConfig is nil, JWT authentication is disabled // read once at construction; mutating Config afterwards has no effect.
// JWT == nil disables JWT authentication.
func New(config *Config) *Server { func New(config *Config) *Server {
s := &Server{ s := &Server{
mu: sync.RWMutex{}, mu: sync.RWMutex{},
hostKeyPEM: config.HostKeyPEM, hostKeyPEM: config.HostKeyPEM,
netstackNet: config.NetstackNet,
wgAddress: config.NetworkValidation,
sessions: make(map[sessionKey]*sessionState), sessions: make(map[sessionKey]*sessionState),
pendingAuthJWT: make(map[authKey]string), pendingAuthJWT: make(map[authKey]string),
remoteForwardListeners: make(map[forwardKey]net.Listener), remoteForwardListeners: make(map[forwardKey]net.Listener),
@@ -434,20 +445,6 @@ func (s *Server) buildSessionInfo(state *sessionState) SessionInfo {
return info return info
} }
// SetNetstackNet sets the netstack network for userspace networking
func (s *Server) SetNetstackNet(net *netstack.Net) {
s.mu.Lock()
defer s.mu.Unlock()
s.netstackNet = net
}
// SetNetworkValidation configures network-based connection filtering
func (s *Server) SetNetworkValidation(addr wgaddr.Address) {
s.mu.Lock()
defer s.mu.Unlock()
s.wgAddress = addr
}
// UpdateSSHAuth updates the SSH fine-grained access control configuration // UpdateSSHAuth updates the SSH fine-grained access control configuration
// This should be called when network map updates include new SSH auth configuration // This should be called when network map updates include new SSH auth configuration
func (s *Server) UpdateSSHAuth(config *sshauth.Config) { func (s *Server) UpdateSSHAuth(config *sshauth.Config) {
+7 -5
View File
@@ -28,8 +28,11 @@ func noiseTestServer(t *testing.T) (net.Addr, *Server, []byte) {
kp, err := noise.DH25519.GenerateKeypair(nil) kp, err := noise.DH25519.GenerateKeypair(nil)
require.NoError(t, err) require.NoError(t, err)
srv := New(&testCapturer{}, &StubInputInjector{}, kp.Private) srv := New(Config{
srv.SetDisableAuth(false) Capturer: &testCapturer{},
Injector: &StubInputInjector{},
IdentityKey: kp.Private,
})
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
network := netip.MustParsePrefix("127.0.0.0/8") network := netip.MustParsePrefix("127.0.0.0/8")
@@ -338,8 +341,7 @@ func TestNoise_RevokedKey_RejectedAfterAuthUpdate(t *testing.T) {
// without a static private key still rejects authenticated connections // without a static private key still rejects authenticated connections
// fail-closed; it must not silently accept the client. // fail-closed; it must not silently accept the client.
func TestNoise_NoIdentityKey_FailsClosed(t *testing.T) { func TestNoise_NoIdentityKey_FailsClosed(t *testing.T) {
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{Capturer: &testCapturer{}, Injector: &StubInputInjector{}})
srv.SetDisableAuth(false)
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
network := netip.MustParsePrefix("127.0.0.0/8") network := netip.MustParsePrefix("127.0.0.0/8")
require.NoError(t, srv.Start(t.Context(), addr, network)) require.NoError(t, srv.Start(t.Context(), addr, network))
@@ -384,7 +386,7 @@ func TestNoise_DerivedIdentityPublicMatchesPrivate(t *testing.T) {
for i := range priv { for i := range priv {
priv[i] = byte(i + 1) priv[i] = byte(i + 1)
} }
srv := New(&testCapturer{}, &StubInputInjector{}, priv) srv := New(Config{Capturer: &testCapturer{}, Injector: &StubInputInjector{}, IdentityKey: priv})
expected, err := curve25519.X25519(priv, curve25519.Basepoint) expected, err := curve25519.X25519(priv, curve25519.Basepoint)
require.NoError(t, err) require.NoError(t, err)
+43 -57
View File
@@ -254,30 +254,57 @@ type virtualSessionManager interface {
StopAll() StopAll()
} }
// New creates a VNC server. identityKey is the 32-byte X25519 private // Config bundles the values the VNC server needs at construction time.
// key used by the daemon in the Noise_IK handshake; nil disables auth. // Fields are read once by New; mutating them afterwards has no effect.
// The protocol-level VNC password scheme is not supported. // Optional fields are nil/zero when unused. The hex-encoded AgentTokenHex
func New(capturer ScreenCapturer, injector InputInjector, identityKey []byte) *Server { // is decoded internally and an invalid value is logged and treated as
// empty, matching the legacy SetAgentToken behavior.
type Config struct {
Capturer ScreenCapturer
Injector InputInjector
IdentityKey []byte
ServiceMode bool
SessionRecorder func(SessionTick)
DisableAuth bool
AgentTokenHex string
NetstackNet *netstack.Net
}
// New creates a VNC server from the provided Config. IdentityKey is the
// 32-byte X25519 private key used in the Noise_IK handshake; nil disables
// auth. The protocol-level VNC password scheme is not supported.
func New(cfg Config) *Server {
s := &Server{ s := &Server{
capturer: capturer, capturer: cfg.Capturer,
injector: injector, injector: cfg.Injector,
identityKey: identityKey, identityKey: cfg.IdentityKey,
authorizer: sshauth.NewAuthorizer(), serviceMode: cfg.ServiceMode,
log: log.WithField("component", "vnc-server"), sessionRecorder: cfg.SessionRecorder,
sessions: make(map[uint64]ActiveSessionInfo), disableAuth: cfg.DisableAuth,
sessionConns: make(map[uint64]net.Conn), netstackNet: cfg.NetstackNet,
acceptedConns: make(map[net.Conn]struct{}), authorizer: sshauth.NewAuthorizer(),
connAuth: make(map[net.Conn]connAuthInfo), log: log.WithField("component", "vnc-server"),
connSem: make(chan struct{}, maxConcurrentVNCConns), sessions: make(map[uint64]ActiveSessionInfo),
sessionConns: make(map[uint64]net.Conn),
acceptedConns: make(map[net.Conn]struct{}),
connAuth: make(map[net.Conn]connAuthInfo),
connSem: make(chan struct{}, maxConcurrentVNCConns),
} }
if len(identityKey) == 32 { if len(cfg.IdentityKey) == 32 {
pub, err := curve25519.X25519(identityKey, curve25519.Basepoint) pub, err := curve25519.X25519(cfg.IdentityKey, curve25519.Basepoint)
if err == nil { if err == nil {
s.identityPublic = pub s.identityPublic = pub
} else { } else {
s.log.Warnf("derive identity public key: %v", err) s.log.Warnf("derive identity public key: %v", err)
} }
} }
if cfg.AgentTokenHex != "" {
if b, err := hex.DecodeString(cfg.AgentTokenHex); err == nil {
s.agentToken = b
} else {
s.log.Warnf("invalid agent token: %v", err)
}
}
return s return s
} }
@@ -407,47 +434,6 @@ func (s *Server) revokeUnauthorizedSessions() {
} }
} }
// SetServiceMode enables proxy-to-agent mode for Windows service operation.
func (s *Server) SetServiceMode(enabled bool) {
s.serviceMode = enabled
}
// SetSessionRecorder installs a callback that receives a SessionTick
// each sessionTickInterval during a VNC session and one final tick on
// session close. Pass nil to disable. Empty ticks (no wire activity)
// are skipped.
func (s *Server) SetSessionRecorder(recorder func(SessionTick)) {
s.sessionRecorder = recorder
}
// SetDisableAuth disables authentication entirely.
func (s *Server) SetDisableAuth(disable bool) {
s.disableAuth = disable
}
// SetAgentToken sets a hex-encoded token that must be presented by incoming
// connections before any VNC data. Used in agent mode to verify that only the
// trusted service process connects.
func (s *Server) SetAgentToken(hexToken string) {
if hexToken == "" {
return
}
b, err := hex.DecodeString(hexToken)
if err != nil {
s.log.Warnf("invalid agent token: %v", err)
return
}
s.agentToken = b
}
// SetNetstackNet sets the netstack network for userspace-only listening.
// When set, the VNC server listens via netstack instead of a real OS socket.
func (s *Server) SetNetstackNet(n *netstack.Net) {
s.mu.Lock()
defer s.mu.Unlock()
s.netstackNet = n
}
// UpdateVNCAuth updates the fine-grained authorization configuration and // UpdateVNCAuth updates the fine-grained authorization configuration and
// closes any live session whose identity no longer authenticates under // closes any live session whose identity no longer authenticates under
// the new policy. Revocation is event-driven: there is no periodic // the new policy. Revocation is event-driven: there is no periodic
+29 -14
View File
@@ -28,8 +28,11 @@ func (t *testCapturer) Capture() (*image.RGBA, error) {
func startTestServer(t *testing.T, disableAuth bool) (net.Addr, *Server) { func startTestServer(t *testing.T, disableAuth bool) (net.Addr, *Server) {
t.Helper() t.Helper()
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{
srv.SetDisableAuth(disableAuth) Capturer: &testCapturer{},
Injector: &StubInputInjector{},
DisableAuth: disableAuth,
})
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
network := netip.MustParsePrefix("127.0.0.0/8") network := netip.MustParsePrefix("127.0.0.0/8")
@@ -112,8 +115,11 @@ func TestAuthDisabled_AllowsConnection(t *testing.T) {
// server must close immediately and the client must see EOF before any RFB // server must close immediately and the client must see EOF before any RFB
// version greeting is written. // version greeting is written.
func TestAuth_NoUnauthBytesPastHeader(t *testing.T) { func TestAuth_NoUnauthBytesPastHeader(t *testing.T) {
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{
srv.SetDisableAuth(true) Capturer: &testCapturer{},
Injector: &StubInputInjector{},
DisableAuth: true,
})
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
// Tight overlay that excludes 127.0.0.0/8 and a non-loopback local IP, so // Tight overlay that excludes 127.0.0.0/8 and a non-loopback local IP, so
// the loopback short-circuit in isAllowedSource doesn't apply. // the loopback short-circuit in isAllowedSource doesn't apply.
@@ -193,7 +199,7 @@ func TestIsAllowedSource(t *testing.T) {
} }
for _, tc := range tests { for _, tc := range tests {
t.Run(tc.name, func(t *testing.T) { t.Run(tc.name, func(t *testing.T) {
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{Capturer: &testCapturer{}, Injector: &StubInputInjector{}})
srv.localAddr = tc.localAddr srv.localAddr = tc.localAddr
srv.network = tc.network srv.network = tc.network
assert.Equal(t, tc.want, srv.isAllowedSource(tc.remote)) assert.Equal(t, tc.want, srv.isAllowedSource(tc.remote))
@@ -202,7 +208,7 @@ func TestIsAllowedSource(t *testing.T) {
} }
func TestStart_InvalidNetworkRejected(t *testing.T) { func TestStart_InvalidNetworkRejected(t *testing.T) {
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{Capturer: &testCapturer{}, Injector: &StubInputInjector{}})
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
err := srv.Start(t.Context(), addr, netip.Prefix{}) err := srv.Start(t.Context(), addr, netip.Prefix{})
require.Error(t, err, "Start must refuse an invalid overlay prefix") require.Error(t, err, "Start must refuse an invalid overlay prefix")
@@ -210,9 +216,12 @@ func TestStart_InvalidNetworkRejected(t *testing.T) {
} }
func TestAgentToken_MismatchClosesConnection(t *testing.T) { func TestAgentToken_MismatchClosesConnection(t *testing.T) {
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{
srv.SetDisableAuth(true) Capturer: &testCapturer{},
srv.SetAgentToken("deadbeefcafebabe") Injector: &StubInputInjector{},
DisableAuth: true,
AgentTokenHex: "deadbeefcafebabe",
})
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
network := netip.MustParsePrefix("127.0.0.0/8") network := netip.MustParsePrefix("127.0.0.0/8")
@@ -238,10 +247,13 @@ func TestAgentToken_MismatchClosesConnection(t *testing.T) {
} }
func TestAgentToken_MatchAllowsHandshake(t *testing.T) { func TestAgentToken_MatchAllowsHandshake(t *testing.T) {
srv := New(&testCapturer{}, &StubInputInjector{}, nil)
srv.SetDisableAuth(true)
const tokenHex = "deadbeefcafebabe" const tokenHex = "deadbeefcafebabe"
srv.SetAgentToken(tokenHex) srv := New(Config{
Capturer: &testCapturer{},
Injector: &StubInputInjector{},
DisableAuth: true,
AgentTokenHex: tokenHex,
})
token, err := hex.DecodeString(tokenHex) token, err := hex.DecodeString(tokenHex)
require.NoError(t, err) require.NoError(t, err)
@@ -275,8 +287,11 @@ func TestAgentToken_MatchAllowsHandshake(t *testing.T) {
func TestSessionMode_RejectedWhenNoVMGR(t *testing.T) { func TestSessionMode_RejectedWhenNoVMGR(t *testing.T) {
// Default platformSessionManager() on non-Linux returns nil, so ModeSession // Default platformSessionManager() on non-Linux returns nil, so ModeSession
// must be rejected with the UNSUPPORTED reason rather than crashing. // must be rejected with the UNSUPPORTED reason rather than crashing.
srv := New(&testCapturer{}, &StubInputInjector{}, nil) srv := New(Config{
srv.SetDisableAuth(true) Capturer: &testCapturer{},
Injector: &StubInputInjector{},
DisableAuth: true,
})
addr := netip.MustParseAddrPort("127.0.0.1:0") addr := netip.MustParseAddrPort("127.0.0.1:0")
network := netip.MustParsePrefix("127.0.0.0/8") network := netip.MustParsePrefix("127.0.0.0/8")