mirror of
https://github.com/tailscale/tailscale.git
synced 2024-12-01 14:05:39 +00:00
874db2173b
We add the ClientID() method to the ipnauth.Actor interface and updated ipnserver.actor to implement it. This method returns a unique ID of the connected client if the actor represents one. It helps link a series of interactions initiated by the client, such as when a notification needs to be sent back to a specific session, rather than all active sessions, in response to a certain request. We also add LocalBackend.WatchNotificationsAs and LocalBackend.StartLoginInteractiveAs methods, which are like WatchNotifications and StartLoginInteractive but accept an additional parameter specifying an ipnauth.Actor who initiates the operation. We store these actor identities in watchSession.owner and LocalBackend.authActor, respectively,and implement LocalBackend.sendTo and related helper methods to enable sending notifications to watchSessions associated with actors (or, more broadly, identifiable recipients). We then use the above to change who receives the BrowseToURL notifications: - For user-initiated, interactive logins, the notification is delivered only to the user who initiated the process. If the initiating actor represents a specific connected client, the URL notification is sent back to the same LocalAPI client that called StartLoginInteractive. Otherwise, the notification is sent to all clients connected as that user. Currently, we only differentiate between users on Windows, as it is inherently a multi-user OS. - In all other cases (e.g., node key expiration), we send the notification to all connected users. Updates tailscale/corp#18342 Signed-off-by: Nick Khyl <nickk@tailscale.com>
79 lines
2.8 KiB
Go
79 lines
2.8 KiB
Go
// Copyright (c) Tailscale Inc & AUTHORS
|
|
// SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
package ipnauth
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"tailscale.com/ipn"
|
|
)
|
|
|
|
// Actor is any actor using the [ipnlocal.LocalBackend].
|
|
//
|
|
// It typically represents a specific OS user, indicating that an operation
|
|
// is performed on behalf of this user, should be evaluated against their
|
|
// access rights, and performed in their security context when applicable.
|
|
type Actor interface {
|
|
// UserID returns an OS-specific UID of the user represented by the receiver,
|
|
// or "" if the actor does not represent a specific user on a multi-user system.
|
|
// As of 2024-08-27, it is only used on Windows.
|
|
UserID() ipn.WindowsUserID
|
|
// Username returns the user name associated with the receiver,
|
|
// or "" if the actor does not represent a specific user.
|
|
Username() (string, error)
|
|
// ClientID returns a non-zero ClientID and true if the actor represents
|
|
// a connected LocalAPI client. Otherwise, it returns a zero value and false.
|
|
ClientID() (_ ClientID, ok bool)
|
|
|
|
// IsLocalSystem reports whether the actor is the Windows' Local System account.
|
|
//
|
|
// Deprecated: this method exists for compatibility with the current (as of 2024-08-27)
|
|
// permission model and will be removed as we progress on tailscale/corp#18342.
|
|
IsLocalSystem() bool
|
|
|
|
// IsLocalAdmin reports whether the actor has administrative access to the
|
|
// local machine, for whatever that means with respect to the current OS.
|
|
//
|
|
// The operatorUID is only used on Unix-like platforms and specifies the ID
|
|
// of a local user (in the os/user.User.Uid string form) who is allowed to
|
|
// operate tailscaled without being root or using sudo.
|
|
//
|
|
// Deprecated: this method exists for compatibility with the current (as of 2024-08-27)
|
|
// permission model and will be removed as we progress on tailscale/corp#18342.
|
|
IsLocalAdmin(operatorUID string) bool
|
|
}
|
|
|
|
// ActorCloser is an optional interface that might be implemented by an [Actor]
|
|
// that must be closed when done to release the resources.
|
|
type ActorCloser interface {
|
|
// Close releases resources associated with the receiver.
|
|
Close() error
|
|
}
|
|
|
|
// ClientID is an opaque, comparable value used to identify a connected LocalAPI
|
|
// client, such as a connected Tailscale GUI or CLI. It does not necessarily
|
|
// correspond to the same [net.Conn] or any physical session.
|
|
//
|
|
// Its zero value is valid, but does not represent a specific connected client.
|
|
type ClientID struct {
|
|
v any
|
|
}
|
|
|
|
// NoClientID is the zero value of [ClientID].
|
|
var NoClientID ClientID
|
|
|
|
// ClientIDFrom returns a new [ClientID] derived from the specified value.
|
|
// ClientIDs derived from equal values are equal.
|
|
func ClientIDFrom[T comparable](v T) ClientID {
|
|
return ClientID{v}
|
|
}
|
|
|
|
// String implements [fmt.Stringer].
|
|
func (id ClientID) String() string {
|
|
if id.v == nil {
|
|
return "(none)"
|
|
}
|
|
return fmt.Sprint(id.v)
|
|
}
|