open-vault/command/token_create.go

156 lines
4.9 KiB
Go
Raw Normal View History

2015-04-07 21:20:18 +00:00
package command
import (
"fmt"
"strings"
"github.com/hashicorp/vault/api"
"github.com/hashicorp/vault/helper/flag-kv"
"github.com/hashicorp/vault/helper/flag-slice"
2016-04-01 17:16:05 +00:00
"github.com/hashicorp/vault/meta"
2015-04-07 21:20:18 +00:00
)
// TokenCreateCommand is a Command that mounts a new mount.
type TokenCreateCommand struct {
2016-04-01 17:16:05 +00:00
meta.Meta
2015-04-07 21:20:18 +00:00
}
func (c *TokenCreateCommand) Run(args []string) int {
var format string
2016-02-29 18:27:31 +00:00
var id, displayName, lease, ttl, role string
var orphan, noDefaultPolicy bool
2015-04-07 21:20:18 +00:00
var metadata map[string]string
var numUses int
2015-04-07 21:20:18 +00:00
var policies []string
2016-04-01 17:16:05 +00:00
flags := c.Meta.FlagSet("mount", meta.FlagSetDefault)
flags.StringVar(&format, "format", "table", "")
flags.StringVar(&displayName, "display-name", "", "")
flags.StringVar(&id, "id", "", "")
2015-04-07 21:20:18 +00:00
flags.StringVar(&lease, "lease", "", "")
flags.StringVar(&ttl, "ttl", "", "")
2016-02-29 18:27:31 +00:00
flags.StringVar(&role, "role", "", "")
2015-04-07 21:20:18 +00:00
flags.BoolVar(&orphan, "orphan", false, "")
flags.BoolVar(&noDefaultPolicy, "no-default-policy", false, "")
flags.IntVar(&numUses, "use-limit", 0, "")
2015-04-07 21:20:18 +00:00
flags.Var((*kvFlag.Flag)(&metadata), "metadata", "")
flags.Var((*sliceflag.StringFlag)(&policies), "policy", "")
flags.Usage = func() { c.Ui.Error(c.Help()) }
if err := flags.Parse(args); err != nil {
return 1
}
args = flags.Args()
if len(args) != 0 {
flags.Usage()
c.Ui.Error(fmt.Sprintf(
"\ntoken-create expects no arguments"))
return 1
}
client, err := c.Client()
if err != nil {
c.Ui.Error(fmt.Sprintf(
"Error initializing client: %s", err))
return 2
}
if ttl == "" {
ttl = lease
}
2016-02-29 18:27:31 +00:00
tcr := &api.TokenCreateRequest{
ID: id,
Policies: policies,
Metadata: metadata,
TTL: ttl,
NoParent: orphan,
NoDefaultPolicy: noDefaultPolicy,
DisplayName: displayName,
NumUses: numUses,
2016-02-29 18:27:31 +00:00
}
var secret *api.Secret
if role != "" {
secret, err = client.Auth().Token().CreateWithRole(tcr, role)
} else {
secret, err = client.Auth().Token().Create(tcr)
}
2015-04-07 21:20:18 +00:00
if err != nil {
c.Ui.Error(fmt.Sprintf(
"Error creating token: %s", err))
return 2
}
return OutputSecret(c.Ui, format, secret)
2015-04-07 21:20:18 +00:00
}
func (c *TokenCreateCommand) Synopsis() string {
return "Create a new auth token"
}
func (c *TokenCreateCommand) Help() string {
helpText := `
Usage: vault token-create [options]
Create a new auth token.
This command creates a new token that can be used for authentication.
This token will be created as a child of your token. The created token
will inherit your policies, or can be assigned a subset of your policies.
2015-09-12 01:08:32 +00:00
A lease can also be associated with the token. If a lease is not associated
2015-09-12 01:36:20 +00:00
with the token, then it cannot be renewed. If a lease is associated with
2015-09-12 01:08:32 +00:00
the token, it will expire after that amount of time unless it is renewed.
2015-04-07 21:20:18 +00:00
Metadata associated with the token (specified with "-metadata") is
written to the audit log when the token is used.
If a role is specified, the role may override parameters specified here.
2015-04-07 21:20:18 +00:00
General Options:
` + meta.GeneralOptionsUsage() + `
2015-04-07 21:20:18 +00:00
Token Options:
-id="7699125c-d8...." The token value that clients will use to authenticate
with vault. If not provided this defaults to a 36
character UUID. A root token is required to specify
the ID of a token.
-display-name="name" A display name to associate with this token. This
is a non-security sensitive value used to help
identify created secrets, i.e. prefixes.
-lease="1h" Deprecated; use "-ttl" instead.
-ttl="1h" TTL to associate with the token. This option enables
2015-09-12 01:08:32 +00:00
the tokens to be renewable.
2015-04-07 21:20:18 +00:00
-metadata="key=value" Metadata to associate with the token. This shows
up in the audit log. This can be specified multiple
times.
-orphan If specified, the token will have no parent. Only
root tokens can create orphan tokens. This prevents
the new token from being revoked with your token.
-no-default-policy If specified, the token will not have the "default"
policy included in its policy set.
2015-04-07 21:20:18 +00:00
-policy="name" Policy to associate with this token. This can be
specified multiple times.
-use-limit=5 The number of times this token can be used until
it is automatically revoked.
-format=table The format for output. By default it is a whitespace-
delimited table. This can also be json or yaml.
-role=name If set, the token will be created against the named
role. The role may override other parameters. This
requires the client to have permissions on the
appropriate endpoint (auth/token/create/<name>).
2015-04-07 21:20:18 +00:00
`
return strings.TrimSpace(helpText)
}