Skip to content

vip defensive-mode configure

Update the defensive mode configuration (step-up auth required).

Usage

vip defensive-mode configure [options]

Options

OptionDescription
-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: July 07, 2026