vip defensive-mode configure
Update the defensive mode configuration (step-up auth required).
Usage
vip defensive-mode configure [options]
Options
| Option | Description |
|---|---|
-a, --app [value] |
Target an application. Accepts a string value for the application name or an integer for the application ID. |
-e, --env [value] |
Target an environment. Accepts a string value for the environment type. |
-h, --help |
Retrieve a description, examples, and available options for a (sub)command. (default: false) |
-v, --version |
Retrieve the version number of VIP-CLI currently installed on the local machine. (default: false) |
-d, --debug [value] |
Generate verbose output during command execution to help identify or fix errors or bugs. |
--enabled [value] |
Whether defensive mode should be enabled (true|false). Required. |
-c, --challenge-type [value] |
Challenge type integer. Required. |
--connection-threshold-absolute [value] |
Absolute connection threshold that triggers defensive mode. |
--connection-threshold-percentage [value] |
Connection threshold percentage that triggers defensive mode. |
-n, --non-interactive |
Disable prompts and browser-open; fail fast if a required flag is missing. (default: false) |
-s, --skip-confirmation |
Skip the confirmation prompt for production envs. (default: false) |
-r, --rechallenge-wait |
When step-up verification is required non-interactively, print the URL and wait for verification on another device instead of failing fast. (default: false) |
Examples
- Update defensive mode configuration non-interactively (minimal required flags).
$ vip @example-app.production defensive-mode configure --enabled=true --challenge-type=1
- Update with explicit thresholds.
$ vip @example-app.production defensive-mode configure --enabled=true --challenge-type=2 --connection-threshold-absolute=5000 --connection-threshold-percentage=80
Last updated: November 05, 2026