Skip to content

hiveguard proxy-rules

Proxy rules control which request paths require a challenge. By default all proxied paths require a valid challenge token. Rules can allow specific paths through without a challenge.

Proxy rule commands require dashboard credentials.

proxy-rules list

Terminal window
hiveguard proxy-rules list

Output columns: id, pattern, match_type, priority, enabled.

proxy-rules create

Terminal window
hiveguard proxy-rules create PATTERN [OPTIONS]
OptionTypeDescription
--match-typestringprefix, exact, or glob (default: prefix)
--priorityintHigher priority rules are evaluated first (default: 0)

Examples:

Terminal window
# Allow /health through without a challenge
hiveguard proxy-rules create "/health" --match-type exact --priority 100
# Skip challenge for all /public/* paths
hiveguard proxy-rules create "/public/" --match-type prefix --priority 50
# Glob pattern
hiveguard proxy-rules create "/api/v*/docs" --match-type glob --priority 10

proxy-rules update

Terminal window
hiveguard proxy-rules update RULE_ID [OPTIONS]
OptionTypeDescription
--enabledboolEnable or disable the rule
--priorityintChange the priority

Example:

Terminal window
# Temporarily disable a rule
hiveguard proxy-rules update RULE_ID --enabled false

proxy-rules delete

Terminal window
hiveguard proxy-rules delete RULE_ID

Deletes the rule immediately. No confirmation prompt.