setup

Documentation

Index

• func Logout() error
• func Run(binaryPath string) error
• type ExistingAuth
  • func CurrentAuth() *ExistingAuth
  • func (e *ExistingAuth) Authenticated() bool

Functions

func Logout

func Logout() error

Logout removes stored OAuth tokens so the next setup run authenticates from scratch (used by --switch and --logout). The OAuth client secret is left in place — switching Webex user under the same integration only needs the tokens cleared. A missing token entry is not an error.

func Run

func Run(binaryPath string) error

Run starts the setup UI on a random localhost port and opens the browser.

Types

type ExistingAuth

type ExistingAuth struct {
	DisplayName    string // from people/me; empty if the access token couldn't be validated live
	Email          string
	AccessExpires  time.Time
	RefreshExpires time.Time
}

ExistingAuth describes a currently-stored OAuth session.

func CurrentAuth

func CurrentAuth() *ExistingAuth

CurrentAuth loads stored OAuth tokens and reports the existing session, if any. It returns (nil, nil) when there is nothing usable — no tokens, or the refresh token has expired — so the caller falls through to the interactive setup flow. A non-nil result means the user is already signed in and setup can be skipped (unless they explicitly want to switch or force re-auth).

It never errors out the caller: any inability to determine state is treated as "no existing session" so --setup still works.

func (*ExistingAuth) Authenticated

func (e *ExistingAuth) Authenticated() bool

Authenticated reports whether the identity was confirmed against the Webex API (people/me) on this call, versus inferred from a still-valid refresh token without a live check.