Whitelisting UI Access Hosts (Managed Kubernetes Deployments)

For managed Kubernetes (K8s) deployments (EKS, AKS, and GKE), this topic explains when and how to whitelist the hostnames/IPs (URLs) allowed to access the AppViewX Web UI.

When to Use This Feature

Automatic Setup:

  • Fresh Installation: During installation, the default LoadBalancer URL is automatically whitelisted.
  • Upgrade: The whitelist URL is preserved from your existing ConfigMap and automatically updated if configured.

Manual Update Required:

  • When using a custom domain name instead of the default LoadBalancer URL.
  • When migrating from one LoadBalancer to another.
  • When adding or changing DNS records pointing to your AppViewX instance.

Configuration Steps

Step 1: Update the Configuration File

Edit your .appviewxctl.yaml file and add the whitelistUrl field:

provider: aws
kubeConfig: ~/.kube/config
chartPath: ./helm_charts
whitelistUrl: "custom-domain.example.com"  # Add your custom URL here
install:
  isSaasEnabled: true
  imageTag: "2023.1.0"
  # ... rest of your config
Note: The whitelistUrl field accepts:
  • IP addresses (for example, "52.123.xx.xx")
  • Hostnames/FQDNs (for example, "appviewx.company.com")
  • LoadBalancer DNS names (for example, "a1b2c3.us-east-1.elb.amazonaws.com")

Step 2: Run the Update Utility

Execute the standalone utility to update the whitelist:

./appviewxctl --config .appviewxctl.yaml updateWhitelist