package command import ( "fmt" "strings" "github.com/hashicorp/vault/api" "github.com/hashicorp/vault/sdk/helper/consts" "github.com/mitchellh/cli" "github.com/posener/complete" ) var ( _ cli.Command = (*PluginRegisterCommand)(nil) _ cli.CommandAutocomplete = (*PluginRegisterCommand)(nil) ) type PluginRegisterCommand struct { *BaseCommand flagArgs []string flagCommand string flagSHA256 string flagVersion string } func (c *PluginRegisterCommand) Synopsis() string { return "Registers a new plugin in the catalog" } func (c *PluginRegisterCommand) Help() string { helpText := ` Usage: vault plugin register [options] TYPE NAME Registers a new plugin in the catalog. The plugin binary must exist in Vault's configured plugin directory. The argument of type takes "auth", "database", or "secret". Register the plugin named my-custom-plugin: $ vault plugin register -sha256=d3f0a8b... -version=v1.0.0 auth my-custom-plugin Register a plugin with custom arguments: $ vault plugin register \ -sha256=d3f0a8b... \ -version=v1.0.0 \ -args=--with-glibc,--with-cgo \ auth my-custom-plugin ` + c.Flags().Help() return strings.TrimSpace(helpText) } func (c *PluginRegisterCommand) Flags() *FlagSets { set := c.flagSet(FlagSetHTTP) f := set.NewFlagSet("Command Options") f.StringSliceVar(&StringSliceVar{ Name: "args", Target: &c.flagArgs, Completion: complete.PredictAnything, Usage: "Arguments to pass to the plugin when starting. Separate " + "multiple arguments with a comma.", }) f.StringVar(&StringVar{ Name: "command", Target: &c.flagCommand, Completion: complete.PredictAnything, Usage: "Command to spawn the plugin. This defaults to the name of the " + "plugin if unspecified.", }) f.StringVar(&StringVar{ Name: "sha256", Target: &c.flagSHA256, Completion: complete.PredictAnything, Usage: "SHA256 of the plugin binary. This is required for all plugins.", }) f.StringVar(&StringVar{ Name: "version", Target: &c.flagVersion, Completion: complete.PredictAnything, Usage: "Version of the plugin. Optional.", }) return set } func (c *PluginRegisterCommand) AutocompleteArgs() complete.Predictor { return c.PredictVaultPlugins(consts.PluginTypeUnknown) } func (c *PluginRegisterCommand) AutocompleteFlags() complete.Flags { return c.Flags().Completions() } func (c *PluginRegisterCommand) Run(args []string) int { f := c.Flags() if err := f.Parse(args); err != nil { c.UI.Error(err.Error()) return 1 } var pluginNameRaw, pluginTypeRaw string args = f.Args() switch { case len(args) < 1: c.UI.Error(fmt.Sprintf("Not enough arguments (expected 1 or 2, got %d)", len(args))) return 1 case len(args) > 2: c.UI.Error(fmt.Sprintf("Too many arguments (expected 1 or 2, got %d)", len(args))) return 1 case c.flagSHA256 == "": c.UI.Error("SHA256 is required for all plugins, please provide -sha256") return 1 // These cases should come after invalid cases have been checked case len(args) == 1: pluginTypeRaw = "unknown" pluginNameRaw = args[0] case len(args) == 2: pluginTypeRaw = args[0] pluginNameRaw = args[1] } client, err := c.Client() if err != nil { c.UI.Error(err.Error()) return 2 } pluginType, err := consts.ParsePluginType(strings.TrimSpace(pluginTypeRaw)) if err != nil { c.UI.Error(err.Error()) return 2 } pluginName := strings.TrimSpace(pluginNameRaw) command := c.flagCommand if command == "" { command = pluginName } if err := client.Sys().RegisterPlugin(&api.RegisterPluginInput{ Name: pluginName, Type: pluginType, Args: c.flagArgs, Command: command, SHA256: c.flagSHA256, Version: c.flagVersion, }); err != nil { c.UI.Error(fmt.Sprintf("Error registering plugin %s: %s", pluginName, err)) return 2 } c.UI.Output(fmt.Sprintf("Success! Registered plugin: %s", pluginName)) return 0 }