usermanager

Documentation

Index

• type Client
  • func NewClient(st base.APICallCloser) *Client
  • func (c *Client) AddUser(username, displayName, password, access string, modelUUIDs ...string) (_ names.UserTag, secretKey []byte, _ error)
  • func (c *Client) CreateLocalLoginMacaroon(tag names.UserTag) (*macaroon.Macaroon, error)
  • func (c *Client) DisableUser(username string) error
  • func (c *Client) EnableUser(username string) error
  • func (c *Client) SetPassword(username, password string) error
  • func (c *Client) UserInfo(usernames []string, all IncludeDisabled) ([]params.UserInfo, error)
• type IncludeDisabled

Types

type Client

type Client struct {
	base.ClientFacade
	// contains filtered or unexported fields
}

Client provides methods that the Juju client command uses to interact with users stored in the Juju Server.

func NewClient

func NewClient(st base.APICallCloser) *Client

NewClient creates a new `Client` based on an existing authenticated API connection.

func (*Client) AddUser

func (c *Client) AddUser(
	username, displayName, password, access string, modelUUIDs ...string,
) (_ names.UserTag, secretKey []byte, _ error)

AddUser creates a new local user in the controller, sharing with that user any specified models.

func (*Client) CreateLocalLoginMacaroon

func (c *Client) CreateLocalLoginMacaroon(tag names.UserTag) (*macaroon.Macaroon, error)

CreateLocalLoginMacaroon creates a local login macaroon for the authenticated user.

func (*Client) DisableUser

func (c *Client) DisableUser(username string) error

DisableUser disables a user. If the user is already disabled, the action is consided a success.

func (*Client) EnableUser

func (c *Client) EnableUser(username string) error

EnableUser enables a users. If the user is already enabled, the action is consided a success.

func (*Client) SetPassword

func (c *Client) SetPassword(username, password string) error

SetPassword changes the password for the specified user.

func (*Client) UserInfo

func (c *Client) UserInfo(usernames []string, all IncludeDisabled) ([]params.UserInfo, error)

UserInfo returns information about the specified users. If no users are specified, the call should return all users. If includeDisabled is set to ActiveUsers, only enabled users are returned.

type IncludeDisabled

type IncludeDisabled bool

IncludeDisabled is a type alias to avoid bare true/false values in calls to the client method.

var (
	// ActiveUsers indicates to only return active users.
	ActiveUsers IncludeDisabled = false
	// AllUsers indicates that both enabled and disabled users should be
	// returned.
	AllUsers IncludeDisabled = true
)