Files
teleport/lib/services/plugins.go
T
rosstimothy dad8c4475c Add helper method to preserve resource identifiers (#35573)
Attempts to reduce some of the boilerplate required to marshal a
resource by moving common resource idenfitier handling to a utility
method. This currently only works for resources that are proto in
nature and not plain structs(access lists, secreports, discovery
config, etc.).
2023-12-14 19:17:53 +00:00

103 lines
3.3 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 (
"bytes"
"context"
"github.com/gogo/protobuf/jsonpb"
"github.com/gravitational/trace"
"github.com/gravitational/teleport/api/types"
"github.com/gravitational/teleport/lib/utils"
)
// Plugins is the plugin service
type Plugins interface {
CreatePlugin(ctx context.Context, plugin types.Plugin) error
DeleteAllPlugins(ctx context.Context) error
DeletePlugin(ctx context.Context, name string) error
GetPlugin(ctx context.Context, name string, withSecrets bool) (types.Plugin, error)
GetPlugins(ctx context.Context, withSecrets bool) ([]types.Plugin, error)
ListPlugins(ctx context.Context, limit int, startKey string, withSecrets bool) ([]types.Plugin, string, error)
HasPluginType(ctx context.Context, pluginType types.PluginType) (bool, error)
SetPluginCredentials(ctx context.Context, name string, creds types.PluginCredentials) error
SetPluginStatus(ctx context.Context, name string, creds types.PluginStatus) error
}
// MarshalPlugin marshals Plugin resource to JSON.
func MarshalPlugin(plugin types.Plugin, opts ...MarshalOption) ([]byte, error) {
cfg, err := CollectOptions(opts)
if err != nil {
return nil, trace.Wrap(err)
}
switch plugin := plugin.(type) {
case *types.PluginV1:
if err := plugin.CheckAndSetDefaults(); err != nil {
return nil, trace.Wrap(err)
}
var buf bytes.Buffer
err := (&jsonpb.Marshaler{}).Marshal(&buf, maybeResetProtoResourceID(cfg.PreserveResourceID, plugin))
if err != nil {
return nil, trace.Wrap(err)
}
return buf.Bytes(), nil
default:
return nil, trace.BadParameter("unsupported plugin resource %T", plugin)
}
}
// UnmarshalPlugin unmarshals the plugin resource from JSON.
func UnmarshalPlugin(data []byte, opts ...MarshalOption) (types.Plugin, error) {
if len(data) == 0 {
return nil, trace.BadParameter("missing plugin resource data")
}
cfg, err := CollectOptions(opts)
if err != nil {
return nil, trace.Wrap(err)
}
var h types.ResourceHeader
if err := utils.FastUnmarshal(data, &h); err != nil {
return nil, trace.Wrap(err)
}
switch h.Version {
case types.V1:
var plugin types.PluginV1
if err := jsonpb.Unmarshal(bytes.NewReader(data), &plugin); err != nil {
return nil, trace.BadParameter(err.Error())
}
if err := plugin.CheckAndSetDefaults(); err != nil {
return nil, trace.Wrap(err)
}
if cfg.ID != 0 {
plugin.SetResourceID(cfg.ID)
}
if cfg.Revision != "" {
plugin.SetRevision(cfg.Revision)
}
if !cfg.Expires.IsZero() {
plugin.SetExpiry(cfg.Expires)
}
return &plugin, nil
}
return nil, trace.BadParameter("unsupported plugin resource version %q", h.Version)
}