Skip to content

Configure IP Access

This page describes how to configure the ip_allowlist setting in the Hydrolix configuration. This setting controls access to network services running on Hydrolix.

A Hydrolix cluster manifest without an ip_allowlist accepts connections only from 127.0.0.1/32. No outside client can reach the cluster until you set ip_allowlist.

The ip_allowlist limits access to all services, such as the Query Interfaces and HTTP Stream API.

Effects of IP access controls⚓︎

When ip_allowlist includes 0.0.0.0/0, any client can reach the cluster. Automatic ACME certificates work, because the certificate authority can reach the cluster to check it.

When ip_allowlist lists specific ranges, only clients in those ranges can connect. HTTP validation requests from certificate authorities may not be able to reach the cluster either, causing certificate acquisition to fail. To get certificates, do one of the following:

For finer control that restricts access at the Traefik proxy layer, see Configure the Traefik IP Allowlist.

The allowlist doesn't replace authentication

Clients in the allowlist still need to log in or send a valid token.

Example Hydrolix spec fragments⚓︎

The operator software reconfigures the traefik reverse proxy when the ip_allowlist changes.

Public cluster⚓︎

To allow access from any address, use the IPv4 default route 0.0.0.0/0 in the ip_allowlist field of the Hydrolix cluster manifest.

apiVersion: hydrolix.io/v1
kind: HydrolixCluster
metadata:
  name: hydrolix
  namespace: hydrolix
spec:
  admin_email: admin@email.com
  db_bucket_url: gs://hydrolix-demo
  env: {}
  hydrolix_url: https://hostname.hydrolix.live
  ip_allowlist:
  - 0.0.0.0/0
  overcommit: false
  scale: {}
  scale_profile: minimal

Limited access cluster⚓︎

To constrain access to a specific set of IPv4 addresses or network prefixes, list them in the ip_allowlist field of the Hydrolix cluster manifest.

apiVersion: hydrolix.io/v1
kind: HydrolixCluster
metadata:
  name: hydrolix
  namespace: hydrolix
spec:
  admin_email: admin@email.com
  basic_auth:
  - version
  db_bucket_url: gs://hydrolix-demo
  env: {}
  hydrolix_url: https://hostname.hydrolix.live
  ip_allowlist:
  - 23.235.32.0/20
  - 43.249.72.0/22
  - 103.244.50.0/24
  overcommit: false
  scale: {}
  scale_profile: minimal