Skip to main content

Admin IP restriction

Control access to your Management Server by restricting admin logins to specific IP addresses. This feature enhances security by ensuring only trusted networks can access administrative functions.

Admin Navigation > System > Settings > Security

Available Commands

CommandDescriptionExample
Enable IP RestrictionActivates IP-based admin access controlhvcli admin:ip enable
Disable IP RestrictionDeactivates IP restrictions (allows logins from any IP)hvcli admin:ip disable
List Allowed IPsShows currently whitelisted IPshvcli admin:ip list
Add an IPGrants admin access to a new IPhvcli admin:ip add 203.0.113.45
Remove an IPRevokes access for a specific IPhvcli admin:ip remove 203.0.113.45

How It Works

  • When enabled, only the specified IPs can log in as admin users.
  • When disabled, admin logins work from any IP (default setting).
  • Changes take effect immediately—no restart required.

Usage Examples

1. Enable IP Restriction

hvcli admin:ip enable

Output:

Admin IP restriction is now ENABLED. Only whitelisted IPs can access admin accounts.

2. Add Trusted IPs

hvcli admin:ip add 192.168.1.100
hvcli admin:ip add 203.0.113.45

Output:

Added 192.168.1.100 to the admin IP whitelist.

3. List Allowed IPs

hvcli admin:ip list

Output:

Whitelisted Admin IPs:
- 192.168.1.100
- 203.0.113.45

4. Remove an IP

hvcli admin:ip remove 203.0.113.45

Output:

Removed 203.0.113.45 from the admin IP whitelist.

5. Disable IP Restriction

hvcli admin:ip disable

Output:

Admin IP restriction is now DISABLED. Admin logins are allowed from any IP.
warning

This allows admin logins from any IP address.