mirror of
https://github.com/gravitational/teleport.git
synced 2026-10-31 20:39:37 +08:00
Isaiah Becker-MayerandJoel Wejdenstål
d2f5219106
Co-authored-by: Joel Wejdenstål <jwejdenstal@icloud.com>
85 lines
3.0 KiB
Go
85 lines
3.0 KiB
Go
/*
|
|
Copyright 2021 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 (
|
|
"context"
|
|
|
|
"github.com/gravitational/trace"
|
|
|
|
"github.com/gravitational/teleport/api/client/proto"
|
|
"github.com/gravitational/teleport/api/types"
|
|
"github.com/gravitational/teleport/lib/utils"
|
|
)
|
|
|
|
// SessionTrackerService is a realtime session service that has information about
|
|
// sessions that are in-flight in the cluster at the moment.
|
|
type SessionTrackerService interface {
|
|
// GetActiveSessionTrackers returns a list of active session trackers.
|
|
GetActiveSessionTrackers(ctx context.Context) ([]types.SessionTracker, error)
|
|
|
|
// GetActiveSessionTrackersWithFilter returns a list of active sessions filtered by a filter.
|
|
GetActiveSessionTrackersWithFilter(ctx context.Context, filter *types.SessionTrackerFilter) ([]types.SessionTracker, error)
|
|
|
|
// GetSessionTracker returns the current state of a session tracker for an active session.
|
|
GetSessionTracker(ctx context.Context, sessionID string) (types.SessionTracker, error)
|
|
|
|
// CreateSessionTracker creates a tracker resource for an active session.
|
|
CreateSessionTracker(ctx context.Context, st types.SessionTracker) (types.SessionTracker, error)
|
|
|
|
// UpdateSessionTracker updates a tracker resource for an active session.
|
|
UpdateSessionTracker(ctx context.Context, req *proto.UpdateSessionTrackerRequest) error
|
|
|
|
// RemoveSessionTracker removes a tracker resource for an active session.
|
|
RemoveSessionTracker(ctx context.Context, sessionID string) error
|
|
|
|
// UpdatePresence updates the presence status of a user in a session.
|
|
UpdatePresence(ctx context.Context, sessionID, user string) error
|
|
}
|
|
|
|
// UnmarshalSessionTracker unmarshals the Session resource from JSON.
|
|
func UnmarshalSessionTracker(bytes []byte) (types.SessionTracker, error) {
|
|
if len(bytes) == 0 {
|
|
return nil, trace.BadParameter("missing resource data")
|
|
}
|
|
|
|
var session types.SessionTrackerV1
|
|
if err := utils.FastUnmarshal(bytes, &session); err != nil {
|
|
return nil, trace.BadParameter(err.Error())
|
|
}
|
|
|
|
if err := session.CheckAndSetDefaults(); err != nil {
|
|
return nil, trace.Wrap(err)
|
|
}
|
|
|
|
return &session, nil
|
|
}
|
|
|
|
// MarshalSessionTracker marshals the Session resource to JSON.
|
|
func MarshalSessionTracker(session types.SessionTracker) ([]byte, error) {
|
|
if err := session.CheckAndSetDefaults(); err != nil {
|
|
return nil, trace.Wrap(err)
|
|
}
|
|
|
|
switch session := session.(type) {
|
|
case *types.SessionTrackerV1:
|
|
return utils.FastMarshal(session)
|
|
default:
|
|
return nil, trace.BadParameter("unrecognized session version %T", session)
|
|
}
|
|
}
|