token

Documentation

Index

• type Notifier
• type Store
  • func (t *Store) AgentMasterToken() string
  • func (t *Store) AgentMasterTokenAndSource() (string, TokenSource)
  • func (t *Store) AgentToken() string
  • func (t *Store) AgentTokenAndSource() (string, TokenSource)
  • func (t *Store) IsAgentMasterToken(token string) bool
  • func (t *Store) Notify(kind TokenKind) Notifier
  • func (t *Store) ReplicationToken() string
  • func (t *Store) ReplicationTokenAndSource() (string, TokenSource)
  • func (t *Store) StopNotify(n Notifier)
  • func (t *Store) UpdateAgentMasterToken(token string, source TokenSource) bool
  • func (t *Store) UpdateAgentToken(token string, source TokenSource) bool
  • func (t *Store) UpdateReplicationToken(token string, source TokenSource) bool
  • func (t *Store) UpdateUserToken(token string, source TokenSource) bool
  • func (t *Store) UserToken() string
  • func (t *Store) UserTokenAndSource() (string, TokenSource)
• type TokenKind
• type TokenSource

Types

type Notifier

type Notifier struct {
	Ch <-chan struct{}
	// contains filtered or unexported fields
}

Notifier holds the channel used to notify a watcher of token updates as well as some internal tracking information to allow for deregistering the notifier.

type Store

type Store struct {
	// contains filtered or unexported fields
}

Store is used to hold the special ACL tokens used by Consul agents. It is designed to update the tokens on the fly, so the token store itself should be plumbed around and used to get tokens at runtime, don't save the resulting tokens.

func (*Store) AgentMasterToken

func (t *Store) AgentMasterToken() string

func (*Store) AgentMasterTokenAndSource

func (t *Store) AgentMasterTokenAndSource() (string, TokenSource)

func (*Store) AgentToken

func (t *Store) AgentToken() string

AgentToken returns the best token to use for internal agent operations.

func (*Store) AgentTokenAndSource

func (t *Store) AgentTokenAndSource() (string, TokenSource)

AgentToken returns the best token to use for internal agent operations.

func (*Store) IsAgentMasterToken

func (t *Store) IsAgentMasterToken(token string) bool

IsAgentMasterToken checks to see if a given token is the agent master token. This will never match an empty token for safety.

func (*Store) Notify

func (t *Store) Notify(kind TokenKind) Notifier

Notify will set up a watch for when tokens of the desired kind is changed

func (*Store) ReplicationToken

func (t *Store) ReplicationToken() string

ReplicationToken returns the replication token.

func (*Store) ReplicationTokenAndSource

func (t *Store) ReplicationTokenAndSource() (string, TokenSource)

ReplicationToken returns the replication token.

func (*Store) StopNotify

func (t *Store) StopNotify(n Notifier)

StopNotify stops the token store from sending notifications to the specified notifiers chan

func (*Store) UpdateAgentMasterToken

func (t *Store) UpdateAgentMasterToken(token string, source TokenSource) bool

UpdateAgentMasterToken replaces the current agent master token in the store. Returns true if it was changed.

func (*Store) UpdateAgentToken

func (t *Store) UpdateAgentToken(token string, source TokenSource) bool

UpdateAgentToken replaces the current agent token in the store. Returns true if it was changed.

func (*Store) UpdateReplicationToken

func (t *Store) UpdateReplicationToken(token string, source TokenSource) bool

UpdateReplicationToken replaces the current replication token in the store. Returns true if it was changed.

func (*Store) UpdateUserToken

func (t *Store) UpdateUserToken(token string, source TokenSource) bool

UpdateUserToken replaces the current user token in the store. Returns true if it was changed.

func (*Store) UserToken

func (t *Store) UserToken() string

UserToken returns the best token to use for user operations.

func (*Store) UserTokenAndSource

func (t *Store) UserTokenAndSource() (string, TokenSource)

UserToken returns the best token to use for user operations.

type TokenKind

type TokenKind int

const (
	TokenKindAgent TokenKind = iota
	TokenKindAgentMaster
	TokenKindUser
	TokenKindReplication
)

type TokenSource

type TokenSource bool

const (
	TokenSourceConfig TokenSource = false
	TokenSourceAPI    TokenSource = true
)