/* Copyright 2017 Gravitational, Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package services import ( "encoding/json" "fmt" "time" "github.com/gravitational/teleport/lib/defaults" "github.com/gravitational/teleport/lib/utils" log "github.com/Sirupsen/logrus" "github.com/gravitational/trace" "github.com/jonboulle/clockwork" ) // TrustedCluster holds information needed for a cluster that can not be directly // accessed (maybe be behind firewall without any open ports) to join a parent cluster. type TrustedCluster interface { // Resource provides common resource properties Resource // GetEnabled returns the state of the TrustedCluster. GetEnabled() bool // SetEnabled enables (handshake and add ca+reverse tunnel) or disables TrustedCluster. SetEnabled(bool) // CombinedMapping is used to specify combined mapping from legacy property Roles // and new property RoleMap CombinedMapping() RoleMap // GetRoleMap returns role map property GetRoleMap() RoleMap // SetRoleMap sets role map SetRoleMap(m RoleMap) // GetRoles returns the roles for the certificate authority. GetRoles() []string // SetRoles sets the roles for the certificate authority. SetRoles([]string) // GetToken returns the authorization and authentication token. GetToken() string // SetToken sets the authorization and authentication. SetToken(string) // GetProxyAddress returns the address of the proxy server. GetProxyAddress() string // SetProxyAddress sets the address of the proxy server. SetProxyAddress(string) // GetReverseTunnelAddress returns the address of the reverse tunnel. GetReverseTunnelAddress() string // SetReverseTunnelAddress sets the address of the reverse tunnel. SetReverseTunnelAddress(string) // CheckAndSetDefaults checks and set default values for missing fields. CheckAndSetDefaults() error } // NewTrustedCluster is a convenience wa to create a TrustedCluster resource. func NewTrustedCluster(name string, spec TrustedClusterSpecV2) (TrustedCluster, error) { return &TrustedClusterV2{ Kind: KindTrustedCluster, Version: V2, Metadata: Metadata{ Name: name, Namespace: defaults.Namespace, }, Spec: spec, }, nil } // TrustedClusterV2 implements TrustedCluster. type TrustedClusterV2 struct { // Kind is a resource kind - always resource. Kind string `json:"kind"` // Version is a resource version. Version string `json:"version"` // Metadata is metadata about the resource. Metadata Metadata `json:"metadata"` // Spec is the specification of the resource. Spec TrustedClusterSpecV2 `json:"spec"` } // TrustedClusterSpecV2 is the actual data we care about for TrustedClusterSpecV2. type TrustedClusterSpecV2 struct { // Enabled is a bool that indicates if the TrustedCluster is enabled or disabled. // Setting Enabled to false has a side effect of deleting the user and host // certificate authority (CA). Enabled bool `json:"enabled"` // Roles is a list of roles that users will be assuming when connecting to this cluster. Roles []string `json:"roles,omitempty"` // Token is the authorization token provided by another cluster needed by // this cluster to join. Token string `json:"token"` // ProxyAddress is the address of the web proxy server of the cluster to join. If not set, // it is derived from :. ProxyAddress string `json:"web_proxy_addr"` // ReverseTunnelAddress is the address of the SSH proxy server of the cluster to join. If // not set, it is derived from :. ReverseTunnelAddress string `json:"tunnel_addr"` // RoleMap specifies role mappings to remote roles RoleMap RoleMap `json:"role_map,omitempty"` } // RoleMap is a list of mappings type RoleMap []RoleMapping // String prints user friendly representation of role mapping func (r RoleMap) String() string { directMatch, wildcardMatch, err := r.parse() if err != nil { return fmt.Sprintf("" } func (r RoleMap) parse() (map[string][]string, []string, error) { var wildcardMatch []string directMatch := make(map[string][]string) for i := range r { roleMap := r[i] if roleMap.Remote == "" { return nil, nil, trace.BadParameter("missing 'remote' parameter for role_map") } if len(roleMap.Local) == 0 { return nil, nil, trace.BadParameter("missing 'local' paramter for 'role_map'") } for _, local := range roleMap.Local { if local == "" { return nil, nil, trace.BadParameter("missing 'local' property of 'role_map' entry") } if local == Wildcard { return nil, nil, trace.BadParameter("wilcard value is not supported for 'local' property of 'role_map' entry") } } if roleMap.Remote == Wildcard { if wildcardMatch != nil { return nil, nil, trace.BadParameter("only one wildcard local role matcher is allowed") } wildcardMatch = roleMap.Local } else { _, ok := directMatch[roleMap.Remote] if ok { return nil, nil, trace.BadParameter("remote role '%v' match is already specified", roleMap.Remote) } directMatch[roleMap.Remote] = roleMap.Local } } return directMatch, wildcardMatch, nil } // Map maps local roles to remote roles func (r RoleMap) Map(remoteRoles []string) ([]string, error) { directMatch, wildcardMatch, err := r.parse() if err != nil { return nil, trace.Wrap(err) } var outRoles []string if len(remoteRoles) == 0 && len(wildcardMatch) != 0 { outRoles = append(outRoles, wildcardMatch...) return outRoles, nil } log.Debugf("%v: direct match: %v wildcard match: %v", r, directMatch, wildcardMatch) for _, remoteRole := range remoteRoles { match, ok := directMatch[remoteRole] if ok { outRoles = append(outRoles, match...) } if wildcardMatch != nil { outRoles = append(outRoles, wildcardMatch...) } } return outRoles, nil } // Check checks RoleMap for errors func (r RoleMap) Check() error { _, _, err := r.parse() return trace.Wrap(err) } // RoleMappping provides mapping of remote roles to local roles // for trusted clusters type RoleMapping struct { // Remote specifies remote role name to map from Remote string `json:"remote"` // Local specifies local roles to map to Local []string `json:"local"` } // Check checks validity of all parameters and sets defaults func (c *TrustedClusterV2) CheckAndSetDefaults() error { // make sure we have defaults for all fields if err := c.Metadata.CheckAndSetDefaults(); err != nil { return trace.Wrap(err) } // This is to force users to migrate if len(c.Spec.Roles) != 0 && len(c.Spec.RoleMap) != 0 { return trace.BadParameter("should set either 'roles' or 'role_map', not both") } // we are not mentioning Roles parameter because we are deprecating it if len(c.Spec.Roles) == 0 && len(c.Spec.RoleMap) == 0 { return trace.BadParameter("missing 'role_map' parameter") } if err := c.Spec.RoleMap.Check(); err != nil { return trace.Wrap(err) } return nil } // CombinedMapping is used to specify combined mapping from legacy property Roles // and new property RoleMap func (c *TrustedClusterV2) CombinedMapping() RoleMap { if len(c.Spec.Roles) != 0 { return []RoleMapping{{Remote: Wildcard, Local: c.Spec.Roles}} } return c.Spec.RoleMap } // GetRoleMap returns role map property func (c *TrustedClusterV2) GetRoleMap() RoleMap { return c.Spec.RoleMap } // SetRoleMap sets role map func (c *TrustedClusterV2) SetRoleMap(m RoleMap) { c.Spec.RoleMap = m } // GetMetadata returns object metadata func (c *TrustedClusterV2) GetMetadata() Metadata { return c.Metadata } // SetExpiry sets expiry time for the object func (c *TrustedClusterV2) SetExpiry(expires time.Time) { c.Metadata.SetExpiry(expires) } // Expires retuns object expiry setting func (c *TrustedClusterV2) Expiry() time.Time { return c.Metadata.Expiry() } // SetTTL sets Expires header using realtime clock func (c *TrustedClusterV2) SetTTL(clock clockwork.Clock, ttl time.Duration) { c.Metadata.SetTTL(clock, ttl) } // GetName returns the name of the TrustedCluster. func (c *TrustedClusterV2) GetName() string { return c.Metadata.Name } // SetName sets the name of the TrustedCluster. func (c *TrustedClusterV2) SetName(e string) { c.Metadata.Name = e } // GetEnabled returns the state of the TrustedCluster. func (c *TrustedClusterV2) GetEnabled() bool { return c.Spec.Enabled } // SetEnabled enables (handshake and add ca+reverse tunnel) or disables TrustedCluster. func (c *TrustedClusterV2) SetEnabled(e bool) { c.Spec.Enabled = e } // GetRoles returns the roles for the certificate authority. func (c *TrustedClusterV2) GetRoles() []string { return c.Spec.Roles } // SetRoles sets the roles for the certificate authority. func (c *TrustedClusterV2) SetRoles(e []string) { c.Spec.Roles = e } // GetToken returns the authorization and authentication token. func (c *TrustedClusterV2) GetToken() string { return c.Spec.Token } // SetToken sets the authorization and authentication. func (c *TrustedClusterV2) SetToken(e string) { c.Spec.Token = e } // GetProxyAddress returns the address of the proxy server. func (c *TrustedClusterV2) GetProxyAddress() string { return c.Spec.ProxyAddress } // SetProxyAddress sets the address of the proxy server. func (c *TrustedClusterV2) SetProxyAddress(e string) { c.Spec.ProxyAddress = e } // GetReverseTunnelAddress returns the address of the reverse tunnel. func (c *TrustedClusterV2) GetReverseTunnelAddress() string { return c.Spec.ReverseTunnelAddress } // SetReverseTunnelAddress sets the address of the reverse tunnel. func (c *TrustedClusterV2) SetReverseTunnelAddress(e string) { c.Spec.ReverseTunnelAddress = e } // String represents a human readable version of trusted cluster settings. func (c *TrustedClusterV2) String() string { return fmt.Sprintf("TrustedCluster(Enabled=%v,Roles=%v,Token=%v,ProxyAddress=%v,ReverseTunnelAddress=%v)", c.Spec.Enabled, c.Spec.Roles, c.Spec.Token, c.Spec.ProxyAddress, c.Spec.ReverseTunnelAddress) } // TrustedClusterSpecSchemaTemplate is a template for trusted cluster schema const TrustedClusterSpecSchemaTemplate = `{ "type": "object", "additionalProperties": false, "properties": { "enabled": {"type": "boolean"}, "roles": { "type": "array", "items": { "type": "string" } }, "role_map": %v, "token": {"type": "string"}, "web_proxy_addr": {"type": "string"}, "tunnel_addr": {"type": "string"}%v } }` // RoleMapSchema is a schema for role mappings of trusted clusters const RoleMapSchema = `{ "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "local": { "type": "array", "items": { "type": "string" } }, "remote": {"type": "string"} } } }` // GetTrustedClusterSchema returns the schema with optionally injected // schema for extensions. func GetTrustedClusterSchema(extensionSchema string) string { var trustedClusterSchema string if trustedClusterSchema == "" { trustedClusterSchema = fmt.Sprintf(TrustedClusterSpecSchemaTemplate, RoleMapSchema, "") } else { trustedClusterSchema = fmt.Sprintf(TrustedClusterSpecSchemaTemplate, RoleMapSchema, ","+extensionSchema) } return fmt.Sprintf(V2SchemaTemplate, MetadataSchema, trustedClusterSchema) } // TrustedClusterMarshaler implements marshal/unmarshal of TrustedCluster implementations // mostly adds support for extended versions. type TrustedClusterMarshaler interface { Marshal(c TrustedCluster, opts ...MarshalOption) ([]byte, error) Unmarshal(bytes []byte) (TrustedCluster, error) } var trustedClusterMarshaler TrustedClusterMarshaler = &TeleportTrustedClusterMarshaler{} func SetTrustedClusterMarshaler(m TrustedClusterMarshaler) { marshalerMutex.Lock() defer marshalerMutex.Unlock() trustedClusterMarshaler = m } func GetTrustedClusterMarshaler() TrustedClusterMarshaler { marshalerMutex.Lock() defer marshalerMutex.Unlock() return trustedClusterMarshaler } type TeleportTrustedClusterMarshaler struct{} // Unmarshal unmarshals role from JSON or YAML. func (t *TeleportTrustedClusterMarshaler) Unmarshal(bytes []byte) (TrustedCluster, error) { var trustedCluster TrustedClusterV2 if len(bytes) == 0 { return nil, trace.BadParameter("missing resource data") } err := utils.UnmarshalWithSchema(GetTrustedClusterSchema(""), &trustedCluster, bytes) if err != nil { return nil, trace.BadParameter(err.Error()) } utils.UTC(&trustedCluster.Metadata.Expires) return &trustedCluster, nil } // Marshal marshals role to JSON or YAML. func (t *TeleportTrustedClusterMarshaler) Marshal(c TrustedCluster, opts ...MarshalOption) ([]byte, error) { return json.Marshal(c) } // SortedTrustedCluster sorts clusters by name type SortedTrustedCluster []TrustedCluster // Len returns the length of a list. func (s SortedTrustedCluster) Len() int { return len(s) } // Less compares items by name. func (s SortedTrustedCluster) Less(i, j int) bool { return s[i].GetName() < s[j].GetName() } // Swap swaps two items in a list. func (s SortedTrustedCluster) Swap(i, j int) { s[i], s[j] = s[j], s[i] }