Files
teleport/lib/services/server.go
T
rosstimothy 2cced62805 Fix violations of non-constant format strings linter (#51812)
Depends on https://github.com/gravitational/teleport.e/pull/6006.
Now that we are compliant, the ignore rule was removed from the
golangci-lint config to prevent future regressions.
2025-02-04 16:43:35 +00:00

449 lines
12 KiB
Go

/*
* Teleport
* Copyright (C) 2023 Gravitational, Inc.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package services
import (
"encoding/json"
"fmt"
"maps"
"slices"
"time"
"github.com/google/go-cmp/cmp"
"github.com/gravitational/trace"
apidefaults "github.com/gravitational/teleport/api/defaults"
"github.com/gravitational/teleport/api/types"
"github.com/gravitational/teleport/api/types/wrappers"
apiutils "github.com/gravitational/teleport/api/utils"
"github.com/gravitational/teleport/lib/defaults"
"github.com/gravitational/teleport/lib/utils"
)
const (
// Equal means two objects are equal
Equal = iota
// OnlyTimestampsDifferent is true when only timestamps are different
OnlyTimestampsDifferent = iota
// Different means that some fields are different
Different = iota
)
// CompareServers compares two provided servers.
func CompareServers(a, b types.Resource) int {
if serverA, ok := a.(types.Server); ok {
if serverB, ok := b.(types.Server); ok {
return compareServers(serverA, serverB)
}
}
if appA, ok := a.(types.AppServer); ok {
if appB, ok := b.(types.AppServer); ok {
return compareApplicationServers(appA, appB)
}
}
if kubeA, ok := a.(types.KubeServer); ok {
if kubeB, ok := b.(types.KubeServer); ok {
return compareKubernetesServers(kubeA, kubeB)
}
}
if dbA, ok := a.(types.DatabaseServer); ok {
if dbB, ok := b.(types.DatabaseServer); ok {
return compareDatabaseServers(dbA, dbB)
}
}
if dbServiceA, ok := a.(types.DatabaseService); ok {
if dbServiceB, ok := b.(types.DatabaseService); ok {
return compareDatabaseServices(dbServiceA, dbServiceB)
}
}
if winA, ok := a.(types.WindowsDesktopService); ok {
if winB, ok := b.(types.WindowsDesktopService); ok {
return compareWindowsDesktopServices(winA, winB)
}
}
return Different
}
func compareServers(a, b types.Server) int {
if a.GetKind() != b.GetKind() {
return Different
}
if a.GetName() != b.GetName() {
return Different
}
if a.GetAddr() != b.GetAddr() {
return Different
}
if a.GetHostname() != b.GetHostname() {
return Different
}
if a.GetNamespace() != b.GetNamespace() {
return Different
}
if len(a.GetPublicAddrs()) != len(b.GetPublicAddrs()) {
return Different
}
if !slices.Equal(a.GetPublicAddrs(), b.GetPublicAddrs()) {
return Different
}
r := a.GetRotation()
if !r.Matches(b.GetRotation()) {
return Different
}
if a.GetUseTunnel() != b.GetUseTunnel() {
return Different
}
if !maps.Equal(a.GetStaticLabels(), b.GetStaticLabels()) {
return Different
}
if !maps.EqualFunc(a.GetCmdLabels(), b.GetCmdLabels(), func(label types.CommandLabel, label2 types.CommandLabel) bool {
return slices.Equal(label.GetCommand(), label2.GetCommand()) &&
label.GetPeriod() == label2.GetPeriod() &&
label.GetResult() == label2.GetResult()
}) {
return Different
}
if a.GetTeleportVersion() != b.GetTeleportVersion() {
return Different
}
if !slices.Equal(a.GetProxyIDs(), b.GetProxyIDs()) {
return Different
}
if !cmp.Equal(a.GetGitHub(), b.GetGitHub()) {
return Different
}
// OnlyTimestampsDifferent check must be after all Different checks.
if !a.Expiry().Equal(b.Expiry()) {
return OnlyTimestampsDifferent
}
return Equal
}
func compareApplicationServers(a, b types.AppServer) int {
if a.GetKind() != b.GetKind() {
return Different
}
if a.GetName() != b.GetName() {
return Different
}
if a.GetNamespace() != b.GetNamespace() {
return Different
}
if a.GetTeleportVersion() != b.GetTeleportVersion() {
return Different
}
r := a.GetRotation()
if !r.Matches(b.GetRotation()) {
return Different
}
if !cmp.Equal(a.GetApp(), b.GetApp()) {
return Different
}
if !slices.Equal(a.GetProxyIDs(), b.GetProxyIDs()) {
return Different
}
// OnlyTimestampsDifferent check must be after all Different checks.
if !a.Expiry().Equal(b.Expiry()) {
return OnlyTimestampsDifferent
}
return Equal
}
func compareDatabaseServices(a, b types.DatabaseService) int {
if a.GetKind() != b.GetKind() {
return Different
}
if a.GetName() != b.GetName() {
return Different
}
if a.GetNamespace() != b.GetNamespace() {
return Different
}
if !slices.EqualFunc(a.GetResourceMatchers(), b.GetResourceMatchers(),
func(matcher *types.DatabaseResourceMatcher, matcher2 *types.DatabaseResourceMatcher) bool {
return matcher.AWS.AssumeRoleARN == matcher2.AWS.AssumeRoleARN &&
maps.EqualFunc(matcher.Labels.ToProto().Values, matcher2.Labels.ToProto().Values,
func(values wrappers.StringValues, values2 wrappers.StringValues) bool {
return slices.Equal(values.Values, values2.Values)
})
}) {
return Different
}
if !a.Expiry().Equal(b.Expiry()) {
return OnlyTimestampsDifferent
}
return Equal
}
func compareKubernetesServers(a, b types.KubeServer) int {
if a.GetKind() != b.GetKind() {
return Different
}
if a.GetName() != b.GetName() {
return Different
}
if a.GetNamespace() != b.GetNamespace() {
return Different
}
if a.GetTeleportVersion() != b.GetTeleportVersion() {
return Different
}
r := a.GetRotation()
if !r.Matches(b.GetRotation()) {
return Different
}
if !cmp.Equal(a.GetCluster(), b.GetCluster()) {
return Different
}
if !slices.Equal(a.GetProxyIDs(), b.GetProxyIDs()) {
return Different
}
// OnlyTimestampsDifferent check must be after all Different checks.
if !a.Expiry().Equal(b.Expiry()) {
return OnlyTimestampsDifferent
}
return Equal
}
func compareDatabaseServers(a, b types.DatabaseServer) int {
if a.GetKind() != b.GetKind() {
return Different
}
if a.GetName() != b.GetName() {
return Different
}
if a.GetNamespace() != b.GetNamespace() {
return Different
}
if a.GetTeleportVersion() != b.GetTeleportVersion() {
return Different
}
r := a.GetRotation()
if !r.Matches(b.GetRotation()) {
return Different
}
if !cmp.Equal(a.GetDatabase(), b.GetDatabase()) {
return Different
}
if !slices.Equal(a.GetProxyIDs(), b.GetProxyIDs()) {
return Different
}
// OnlyTimestampsDifferent check must be after all Different checks.
if !a.Expiry().Equal(b.Expiry()) {
return OnlyTimestampsDifferent
}
return Equal
}
func compareWindowsDesktopServices(a, b types.WindowsDesktopService) int {
if a.GetKind() != b.GetKind() {
return Different
}
if a.GetName() != b.GetName() {
return Different
}
if a.GetAddr() != b.GetAddr() {
return Different
}
if a.GetTeleportVersion() != b.GetTeleportVersion() {
return Different
}
if !slices.Equal(a.GetProxyIDs(), b.GetProxyIDs()) {
return Different
}
// OnlyTimestampsDifferent check must be after all Different checks.
if !a.Expiry().Equal(b.Expiry()) {
return OnlyTimestampsDifferent
}
return Equal
}
// CommandLabels is a set of command labels
type CommandLabels map[string]types.CommandLabel
// Clone returns copy of the set
func (c *CommandLabels) Clone() CommandLabels {
out := make(CommandLabels, len(*c))
for name, label := range *c {
out[name] = label.Clone()
}
return out
}
// SetEnv sets the value of the label from environment variable
func (c *CommandLabels) SetEnv(v string) error {
if err := json.Unmarshal([]byte(v), c); err != nil {
return trace.Wrap(err, "can not parse Command Labels")
}
return nil
}
// SortedServers is a sort wrapper that sorts servers by name
type SortedServers []types.Server
func (s SortedServers) Len() int {
return len(s)
}
func (s SortedServers) Less(i, j int) bool {
return s[i].GetName() < s[j].GetName()
}
func (s SortedServers) Swap(i, j int) {
s[i], s[j] = s[j], s[i]
}
// SortedReverseTunnels sorts reverse tunnels by cluster name
type SortedReverseTunnels []types.ReverseTunnel
func (s SortedReverseTunnels) Len() int {
return len(s)
}
func (s SortedReverseTunnels) Less(i, j int) bool {
return s[i].GetClusterName() < s[j].GetClusterName()
}
func (s SortedReverseTunnels) Swap(i, j int) {
s[i], s[j] = s[j], s[i]
}
// GuessProxyHostAndVersion tries to find the first proxy with a public
// address configured and return that public addr and version.
// If no proxies are configured, it will return a guessed value by concatenating
// the first proxy's hostname with default port number, and the first proxy's
// version will also be returned.
//
// Returns empty value if there are no proxies.
func GuessProxyHostAndVersion(proxies []types.Server) (string, string, error) {
if len(proxies) == 0 {
return "", "", trace.NotFound("list of proxies empty")
}
// Find the first proxy with a public address set and return it.
for _, proxy := range proxies {
proxyHost := proxy.GetPublicAddr()
if proxyHost != "" {
return proxyHost, proxy.GetTeleportVersion(), nil
}
}
// No proxies have a public address set, return guessed value.
guessProxyHost := fmt.Sprintf("%v:%v", proxies[0].GetHostname(), defaults.HTTPListenPort)
return guessProxyHost, proxies[0].GetTeleportVersion(), nil
}
// UnmarshalServer unmarshals the Server resource from JSON.
func UnmarshalServer(bytes []byte, kind string, opts ...MarshalOption) (types.Server, error) {
cfg, err := CollectOptions(opts)
if err != nil {
return nil, trace.Wrap(err)
}
if len(bytes) == 0 {
return nil, trace.BadParameter("missing server data")
}
var s types.ServerV2
if err := utils.FastUnmarshal(bytes, &s); err != nil {
return nil, trace.BadParameter("%s", err)
}
s.Kind = kind
if err := s.CheckAndSetDefaults(); err != nil {
return nil, trace.Wrap(err)
}
if cfg.Revision != "" {
s.SetRevision(cfg.Revision)
}
if !cfg.Expires.IsZero() {
s.SetExpiry(cfg.Expires)
}
if s.Metadata.Expires != nil {
apiutils.UTC(s.Metadata.Expires)
}
// Force the timestamps to UTC for consistency.
// See https://github.com/gogo/protobuf/issues/519 for details on issues this causes for proto.Clone
apiutils.UTC(&s.Spec.Rotation.Started)
apiutils.UTC(&s.Spec.Rotation.LastRotated)
return &s, nil
}
// MarshalServer marshals the Server resource to JSON.
func MarshalServer(server types.Server, opts ...MarshalOption) ([]byte, error) {
cfg, err := CollectOptions(opts)
if err != nil {
return nil, trace.Wrap(err)
}
switch server := server.(type) {
case *types.ServerV2:
if err := server.CheckAndSetDefaults(); err != nil {
return nil, trace.Wrap(err)
}
return utils.FastMarshal(maybeResetProtoRevision(cfg.PreserveRevision, server))
default:
return nil, trace.BadParameter("unrecognized server version %T", server)
}
}
// UnmarshalServers unmarshals a list of Server resources.
func UnmarshalServers(bytes []byte) ([]types.Server, error) {
var servers []types.ServerV2
err := utils.FastUnmarshal(bytes, &servers)
if err != nil {
return nil, trace.Wrap(err)
}
out := make([]types.Server, len(servers))
for i := range servers {
out[i] = types.Server(&servers[i])
}
return out, nil
}
// MarshalServers marshals a list of Server resources.
func MarshalServers(s []types.Server) ([]byte, error) {
bytes, err := utils.FastMarshal(s)
if err != nil {
return nil, trace.Wrap(err)
}
return bytes, nil
}
// NodeHasMissedKeepAlives checks if node has missed its keep alive
func NodeHasMissedKeepAlives(s types.Server) bool {
serverExpiry := s.Expiry()
return serverExpiry.Before(time.Now().Add(apidefaults.ServerAnnounceTTL - (apidefaults.ServerKeepAliveTTL() * 2)))
}
// EqualFromBool is a helper function that converts a boolean value to an integer
// value that represents the equality status.
func EqualFromBool(b bool) int {
if !b {
return Different
}
return Equal
}