jwt create

Creates a new JSON Web Token (JWT) for testing purposes.

Synopsis

devproxy jwt create [options]

Options:
  -n, --name <name>        User name (default: Dev Proxy)
  -i, --issuer <issuer>    Token issuer (default: dev-proxy)
  -a, --audiences <url>    Audience URL (repeatable)
  -r, --roles <role>       Role claim (repeatable)
  -s, --scopes <scope>     Scope claim (repeatable)
  --claims <name:value>    Custom claim (repeatable)
  -v, --valid-for <mins>   Token validity in minutes (default: 60)
  --signing-key <key>      Signing key (min 32 chars)
  --log-level <level>      Logging level
  -h, --help               Show help

Usage

devproxy jwt create [options]

Example

Generates a JWT for a user named Megan Bowen with the issuer my-app and audience https://myserver.com. The token includes the role admin, scopes read and write, and a custom claim custom:claim. The token is valid for 120 minutes.

devproxy jwt create --name "Megan Bowen" --issuer "my-app" --audiences "https://myserver.com" --roles "admin" --scopes "read" --scopes "write" --claims "custom:claim" --valid-for 120

Arguments

None

Options

Name	Description	Allowed values	Default
-n, --name	The name of the user to create the token for.	string	Dev Proxy
-i, --issuer	The issuer of the token.	string	dev-proxy
-a, --audiences	The audiences to create the token for. Specify once for each audience.	string	https://myserver.com
-r, --roles	A role claim to add to the token. Specify once for each role.	string	None
-s, --scopes	A scope claim to add to the token. Specify once for each scope.	string	None
--claims	Claims to add to the token. Specify once for each claim in the format name:value. Dev Proxy splits each claim on the first colon only, so the value can contain colons, for example website:https://contoso.com.	None
-v, --valid-for	The duration which the token is valid for. Duration is set in minutes.	60
--signing-key	The key to use to sign the token. Must be at least 32 characters long.	Randomly generated
--log-level <loglevel>	Level of messages to log	trace, debug, information, warning, error	information

Note

Dev Proxy automatically adds registered claims (for example, iss, sub, aud, exp, nbf, iat, jti) to the token. If you specify any of these claims, or scp or roles, using the --claims option, Dev Proxy ignores them. Use the dedicated options instead.