IP Allowlist

IP allowlist

The IP allowlist limits where people can use Subimage from. While it is on, Subimage accepts sign-ins only from the IP addresses and ranges that you list, such as your office networks and VPN gateways. A request from any other address is refused, even with a valid session.

Admins manage the allowlist on the Settings → IP Allowlist page.

What the allowlist covers

The allowlist applies to people. Subimage checks every request that carries a person's own sign-in.

How someone connects Checked
The Subimage web app Yes
The REST API with a user's session or access token Yes
The MCP server with a user's sign-in Yes. Subimage checks the address that the MCP client connects from.
API keys (machine-to-machine applications) No
Neo4j API keys and Neo4j Browser No

API keys are not restricted. A machine-to-machine application authenticates as itself and keeps working from any address, so your CI jobs and scripts are unaffected. For more information, see Machine-to-machine authentication.

Neo4j API keys and Neo4j Browser connect to the graph database directly, so the allowlist doesn't apply to them. For more information, see Neo4j API keys.

The check happens after sign-in. Someone outside your networks can still reach the sign-in page and authenticate with your identity provider. Subimage then shows a page that says access is blocked from their network, along with the address they are connecting from.

Turn the allowlist on

  1. Go to Settings → IP Allowlist.
  2. Click Configure. Nothing changes until you confirm the dialog.
  3. Review the addresses in the dialog. Your current address is already in the list when nothing else covers it. Edit its label, or remove it if another address covers the network you are on.
  4. For each additional network, click Add address. In the Address field, enter an IPv4 or IPv6 address, or a range in CIDR notation, such as 203.0.113.0/24. In the Label field, enter what the network is, such as Tallinn office VPN.
  5. Click Turn on.

The change applies right away. People connecting from a listed network keep working. Everyone else loses access on their next request, including in sessions that are already open.

If your address is not covered, or it could not be determined, the dialog warns you and still lets you turn the allowlist on. A range that contains your address counts as covering it.

If another admin changes the list while you have the page open, Subimage refuses your save and loads the current list. Make your change again.

You can list up to 100 addresses and ranges. A single address is stored as a /32 (IPv4) or /128 (IPv6) range.

If your VPN sends traffic out through several gateways, add each gateway's public address. The address that matters is the public one that your traffic leaves from, not a private address such as 10.0.0.5.

Change the list

While the allowlist is on, the addresses are listed on this page. Add address opens the fields there. Edit or remove an address in that list. Each change is saved immediately. The last address cannot be removed. Add another one first.

You can remove the network you are connecting from while the allowlist is on, as long as another address remains. The page warns you, because the next request from this network is refused. Click Disable, or add another network that covers you, to keep this browser working.

Turn the allowlist off

  1. Click Disable.
  2. Click Turn off to confirm.

People can sign in from any network again. Your addresses stay saved, so you can turn the allowlist back on later without entering them again.

How Subimage determines your address

Subimage uses the public address that your connection arrives from, as reported by the load balancer in front of your deployment. Headers that a client sends, such as X-Forwarded-For, can't change it.

MCP clients

When the allowlist is on, connect MCP clients to your tenant MCP URL, which is shown in Connect via MCP.

If you use a cloud-hosted assistant, the connection comes from the assistant provider's servers and not from your network. Add the provider's published address ranges, or use an assistant that runs on a machine inside your network.

Audit trail

Subimage records every change to the allowlist in the audit trail as tenant.update_ip_allowlist, with who made the change and the list before and after. Requests that the allowlist refuses are recorded as denied, with the user who was refused.

If you are locked out

If your network's public address changes while the allowlist is on, Subimage blocks you until the list is updated.

  • Ask another admin who is on a listed network to add your new address.
  • If no admin can reach Subimage, contact Subimage. We can turn the allowlist off for your deployment after verifying the request.