Skip to navigation

Dedicated Zscaler IP

Use one ZIA Forwarding Control rule to send Chainalysis traffic out a dedicated IP

You can register a limited number of individual IP addresses rather than large ranges. If your organization reaches the internet through Zscaler, your traffic normally leaves from shared Zscaler addresses that many other Zscaler customers also use, so those addresses cannot be allowlisted.

A Zscaler dedicated IP solves this. It gives your organization a small, fixed set of egress addresses that only you use. With one Forwarding Control rule, you can send all Chainalysis traffic out through those addresses, and register just those addresses with us.

How it works

StageWhat happensWhere it’s configured
1. User or systemA Zscaler-connected device opens a Chainalysis site or calls the API.Zscaler Client Connector.
2. Forwarding ControlZscaler matches the request against your rule for Chainalysis domains.ZIA Forwarding Control policy (steps 3 and 4 below).
3. Dedicated IP gatewayMatching traffic is sent out through your dedicated IP gateway.ZIA gateway (step 2 below).
4. ChainalysisThe request arrives from your registered IP and is accepted.Chainalysis allowlist.

Before you begin

To follow this guide, you’ll need:

  • An administrator account in the Zscaler Internet Access (ZIA) Admin Portal that can manage gateways and Forwarding Control policies.
  • A dedicated IP allocation from Zscaler (see step 1 below).
  • Your Chainalysis CSM contact in order to register your IPs.

Chainalysis domains to route

DomainWhat it’s used forNotes
*.chainalysis.comAll Chainalysis products, sign-in, and APIs.We recommend routing through this domain. It covers sign-in and every Chainalysis product, including any you add later.
kyt.chainalysis.comThe KYT user interface.This domain is the minimum required to access KYT. If you use this, you must also route api.chainalysis.com.
api.chainalysis.comThe KYT API and other Chainalysis APIs.This domain is the minimum required to access KYT. If you use this, you must also route kyt.chainalysis.com.

Caution: Ensure that you route by domain, not by IP address. Chainalysis IP addresses change, so rules built on them will break.

Configuration steps

1

Request a dedicated IP from Zscaler

Ask your Zscaler account team or Zscaler Support for a dedicated IP allocation. Licenses normally include five dedicated IP sets; confirm your exact entitlement with Zscaler.

Write down the addresses Zscaler assigns. You’ll use them in step 2 and send them to Chainalysis afterwards (see Register your IPs with Chainalysis).

2

Create a gateway for the dedicated IP

In the ZIA Admin Portal, create a new gateway (the default gateway type used by Forwarding Control).

  1. Give it a clear name, for example Dedicated IP - Chainalysis.
  2. Set the server location to the dedicated IP range Zscaler assigned in step 1.
  3. Save the gateway.
3

Create a Forwarding Control policy rule

Go to the Forwarding Control policy and add a new rule (for example, Chainalysis via dedicated IP). Place it above any broader rule that could match Chainalysis traffic first.

You can limit the rule to specific users or groups, for instance a SAML group from your identity provider. Note that this is optional; applying the rule to everyone is usually easier because every request to Chainalysis has to come from a registered IP anyway.

4

Match Chainalysis domains and forward to the dedicated IP

  1. In the rule criteria, add the Chainalysis domains listed in the Chainalysis domains to route section as destination FQDNs.
  2. In the rule action on the right-hand side, set the forwarding method to forward to a dedicated IP.
5

Select the gateway, save, and activate

  1. When prompted, choose the gateway you created in step 2 from the drop-down list.
  2. Save the rule.
  3. Activate your pending changes. ZIA changes don’t take effect until they are activated.

Note: Once the rule is active, all traffic from your Zscaler-connected users to Chainalysis leaves through your dedicated IP egress.

6

Register your IPs with Chainalysis

Send the following to your Chainalysis CSM or Chainalysis Support, using the IP submission template:

  • Your dedicated egress IP addresses: IPv4 addresses and, if your network uses IPv6, your IPv6 /64 range.
  • Your organization name and the Chainalysis account or organization each IP applies to.
  • Any other fixed addresses that call Chainalysis without going through Zscaler, such as servers or integrations that use the API.

Your allowlist can contain up to 50 IP addresses. If your number of IPs exceeds 50, you can request an exception through your CSM or Chainalysis Support.

The following table details the types of IPs we support.

What we acceptNotes
Public IPv4 addressesIndividual addresses or small CIDR ranges. Every address in a range counts toward your limit of 50, so a /27 (32 addresses) fits but a /24 (256) does not. If your network needs more, your CSM can discuss an exception.
IPv6 rangesSend your network’s /64 range rather than single addresses. Each /64 counts as one entry. Ranges broader than /64 are subject to approval.
Fixed egress onlyThis includes corporate VPNs, proxies, office gateways, dedicated security-cloud IPs, and cloud NAT addresses.

At this time, we do not accept private addresses (10.x, 172.16-31.x, 192.168.x, 100.64.x), home internet connections, shared or commercial VPN services, shared security-cloud egress pools, or broad ISP ranges.

Your CSM will tell you when the allowlist is live. Do not switch traffic over until they have confirmed.

7

Confirm your connection

  1. On a Zscaler-connected device, sign in to KYT.
  2. In your ZIA logs, filter on chainalysis.com and check the requests matched your new Forwarding Control rule.
  3. From each system that calls the Chainalysis API, run a test request and confirm it succeeds.
  4. Repeat the sign-in test with a remote user who is off your corporate network.

When you confirm your connection, we recommend resetting your password (if your organization uses SSO, you can skip this). To reset your password, log out and go to app.chainalysis.com. Enter your email address, click Continue, select Reset password, and follow the on-screen instructions.

We also recommend rotating your API key by following the steps on this page.

If you have issues, please contact support@chainalysis.com.

Common issues

  • Likely cause: Your IPs are not on the Chainalysis allowlist yet, or a different IP was registered.
  • How to resolve: Check https://kyt.chainalysis.com/cdn-cgi/trace and confirm the address with your CSM or Chainalysis Support.
  • Likely cause: The device is not using Zscaler, or Chainalysis is on a bypass list.
  • How to resolve: Make sure Client Connector is on, and remove chainalysis.com from any bypass or PAC exclusions.
  • Likely cause: API calls come from servers that do not route through Zscaler.
  • How to resolve: Route those servers through Zscaler, or register their fixed egress IPs as well.
  • Likely cause: The rule only covers some Chainalysis hostnames.
  • How to resolve: Use *.chainalysis.com as the destination.
  • Likely cause: Changes weren’t activated, or a higher rule matches first.
  • How to resolve: Activate pending changes and move the rule higher in the policy.
  • Likely cause: Your network is dual-stack and the browser or client is connecting over IPv6.
  • How to resolve: Send your IPv6 /64 range to your CSM or Chainalysis Support. As a quick test, disable IPv6 on the device and retry.
  • Likely cause: The API key doesn’t have the right permissions or the API key must be rotated, even though the IP is allowed.
  • How to resolve: Check the API key’s permissions in your Chainalysis account, or create a new key.
    • API keys created before November 2, 2026 no longer work. To replace one, follow the key rotation steps.

Additional support

We’re here to help. For questions, contact your Chainalysis CSM or Chainalysis Support.