dpsctl login

dpsctl login Usage Guide

Login to the DPS server and store authentication credentials.

Usage

dpsctl login [options]

Flags

Includes global dpsctl options.

   --username value, -u value   The username to use to authenticate to DPS
   --password-stdin             Read password from stdin
   --password value, -p value   The password to use to authenticate to DPS (hidden; prefer --password-stdin or DPSCTL_PASSWORD)
   --help, -h                   show help

Examples

Interactive Login

$ dpsctl login
Please enter the value for username: alice
Please enter the value for password:
{
  "status": {
    "ok": true,
    "diag_msg": "Login successful"
  }
}

Login with Flags

$ dpsctl login --username alice --password mypassword
{
  "status": {
    "ok": true,
    "diag_msg": "Login successful"
  }
}

Login with Password from Stdin

$ echo '<password>' | dpsctl login --username alice --password-stdin
{
  "status": {
    "ok": true,
    "diag_msg": "Login successful"
  }
}

Login with Environment Variables

$ export DPSCTL_USERNAME=alice
$ export DPSCTL_PASSWORD=<password>
$ dpsctl login
{
  "status": {
    "ok": true,
    "diag_msg": "Login successful"
  }
}

Notes

  • Credentials are stored in ${HOME}/.dpsctl/credentials.yaml by default
  • The credentials file path can be customized with --credentials-path flag
  • A password provided with --password-stdin, --password, or DPSCTL_PASSWORD requires --username or DPSCTL_USERNAME
  • Tokens are automatically refreshed when expired
  • For automation, consider using automation accounts