Skip to content

Share CLI command - auth

share auth

Login, logout & manage your Vendia account.

Table of Contents

Commands for share auth

Manage authorization & set current Vendia user.

Usage for share auth

Terminal window
share auth <subcommand>
SubcommandDescription
auth loginLogin to Vendia user account
auth logoutLogout of Vendia user account
auth roleManage roles for users
auth role deleteDelete roles for users
auth role getGet role information
auth role listList roles for user
auth role setSet Roles for user
auth switchSwitch active Vendia account
auth whoamiDisplay active Vendia account

Examples for share auth

Terminal window
Login to Vendia
share login
# Login to new account
share login --new
# Login programmatically
share login --email your@email.com --password *******
Logout of Vendia
share logout
# Logout of all accounts
share logout --all
Switch user accounts
share auth switch
share auth switch --email xyz@abc.com
Show current user
share auth whoami

auth login

Login to Vendia user account.

Usage for auth login

Terminal window
share auth login

Flags for auth login

  • new (boolean) - Login to new Vendia account
  • email (option) - User email
  • password (option) - User password

Examples for auth login

Terminal window
share login
# Login to new account
share login --new
# Login programmatically
share login --email your@email.com --password *******

auth logout

Logout of Vendia user account.

Usage for auth logout

Terminal window
share auth logout

Flags for auth logout

  • all (boolean) - Logout of all accounts on this machine

Examples for auth logout

Terminal window
share logout
# Logout of all accounts
share logout --all

auth role

Manage roles for users.

See RBAC documentation for additional information.

Usage for auth role

Terminal window
share auth role <SubCommand>

Examples for auth role

Terminal window
List user roles
# Get all roles for current user
share auth role list
# Get all details about user
share auth role list --user email@email.com
# Return role details as json
share auth role list --json
Get user role details
share auth role get <RoleName>
# Return role details as json
share auth role get <RoleName> --json
Set user roles
share auth role set ./policy.json
share auth role set '{ name: "my-role", "capabilities": [...] }'
share auth role set ./policy.json --user email@email.com
share auth role set ./policy.json --user email@email.com --as-role my-admin-role
Delete user roles
share auth role delete <RoleName>
share auth role delete <RoleName> --user email@email.com
share auth role delete <RoleName> --user email@email.com --as-role my-admin-role

auth role delete

Delete roles for users.

Usage for auth role delete

Terminal window
share auth role delete

Arguments for auth role delete

  • roleName - undefined

Flags for auth role delete

  • as-role (option) - Role name to use for the operation
  • user (option) - User email

Examples for auth role delete

Terminal window
share auth role delete <RoleName>
share auth role delete <RoleName> --user email@email.com
share auth role delete <RoleName> --user email@email.com --as-role my-admin-role

auth role get

Get role information.

Usage for auth role get

Terminal window
share auth role get

Arguments for auth role get

  • roleName - undefined

Flags for auth role get

  • user (option) - User email

Examples for auth role get

Terminal window
share auth role get <RoleName>
# Return role details as json
share auth role get <RoleName> --json

auth role list

List roles for user.

Usage for auth role list

Terminal window
share auth role list

Flags for auth role list

  • user (option) - User email

Examples for auth role list

Terminal window
# Get all roles for current user
share auth role list
# Get all details about user
share auth role list --user email@email.com
# Return role details as json
share auth role list --json

auth role set

Set Roles for user.

See RBAC documentation for additional information.

Usage for auth role set

Terminal window
share auth role set

Arguments for auth role set

  • roleName - undefined

Flags for auth role set

  • policy (option) - Policy document
  • as-role (option) - Role name to use for the operation
  • user (option) - User email

Examples for auth role set

Terminal window
share auth role set ./policy.json
share auth role set '{ name: "my-role", "capabilities": [...] }'
share auth role set ./policy.json --user email@email.com
share auth role set ./policy.json --user email@email.com --as-role my-admin-role

auth switch

Switch active Vendia account.

Usage for auth switch

Terminal window
share auth switch

Flags for auth switch

  • email (option) - User email

Examples for auth switch

Terminal window
share auth switch
share auth switch --email xyz@abc.com

auth whoami

Display active Vendia account.

Usage for auth whoami

Terminal window
share auth whoami

Examples for auth whoami

Terminal window
share auth whoami