Integration · NetBox

Rule analysis that knows what the network actually is

A firewall rule is a set of addresses and ports. NetBox knows what those addresses mean, which prefix, which site, which device, which tenant. FwChange reads that context and puts it next to the rule, so a reviewer judges the change against the real network, not a guess.

Why it matters

An IP address is not context

Most rule reviews happen blind. Is 10.42.0.0/16 the DMZ or an internal user segment? Is 203.0.113.5 a live production gateway or a host that was decommissioned last quarter? Answering means leaving the review screen and digging through IPAM by hand, so most reviewers don't, and approve on memory instead.

FwChange closes that gap. While a change sits in review, it resolves every source and destination against NetBox and shows the match inline, the prefix, its site and tenant, and the nearest device, so the decision is grounded in what the network is today.

src 10.42.7.18DMZ-Web · Frankfurt
dst 10.10.0.0/16Internal-Users
dst 203.0.113.5Decommissioned
device fw-edge-02Rack B12 · Site DC1
tenant PaymentsVRF prod-pay

What it syncs

Read-only context, pulled on demand

FwChange reads from NetBox, it never writes. The connector uses a read-only API token and pulls just enough to enrich a review, then caches the result so it isn't hammering your source of truth.

Prefix & subnet

Each address in a rule resolves to its smallest enclosing NetBox prefix, carrying site, VRF, tenant, and description.

Device & location

A firewall linked to its NetBox device surfaces name, serial, rack, and site, and a deep link straight back to the record.

Tenant & ownership

Tenant assignment travels with the prefix, so a reviewer can see whose segment a change touches before approving it.

In the analysis

The same context that catches the bad rule

FwChange already flags shadowed rules, redundant policy, and over-permissive any/any access before a change ships. NetBox data makes that judgement sharper, an open rule to a host the IPAM marks as retired is a different risk to the same rule into an active production prefix.

  • Scope, not just syntax, risk reads against the real segment, tenant, and site behind each address.
  • Decommissioned targets surface instead of slipping through as plausible-looking IPs.
  • Cross-tenant exposure is visible at review time, not discovered in an audit later.
Med
dst in retired prefixHigh
crosses tenant boundaryReview
same VRF, same siteLow

How it connects

One read-only token, five minutes of setup

No agent, no write access, no copy of your IPAM. FwChange holds an encrypted token and queries NetBox live when a review needs it.

1

Mint a read-only token

Create an API token in NetBox with write disabled. Set an expiry if policy requires it. That token is the whole footprint.

2

Add the connector

Enter the NetBox base URL and the token. The credential is encrypted at rest with AES-256-GCM and scoped to your organization.

3

Test the connection

FwChange calls the status endpoint, confirms the NetBox version, and marks the connector active. Self-signed certificates are handled per connector.

4

Review with context

Open any pending change. Every source and destination resolves to its NetBox prefix inline, with responses cached for five minutes to spare your instance.

Built to be safe

It reads. It never touches your data.

The connector speaks standard NetBox REST endpoints: status, devices, prefixes, stable since the 3.x line and supported from NetBox 3.7 onward. It runs on a read-only token by design, so there is no path for FwChange to create, edit, or delete a record.

  • Nothing persisted, NetBox responses live in cache for five minutes, then are discarded.
  • Degrades quietly, if NetBox is unreachable the review still proceeds; context just shows as unavailable.
  • Multiple instances, run several connectors across sites or tenants, each isolated.

NetBox stays the source of truth. FwChange borrows its context for the length of a review and gives nothing back to store, change, or trust against your IPAM. Your records are exactly as you left them.

Context is the difference between a review and a rubber stamp

The NetBox integration is one part of how FwChange turns a firewall change into a decision you can defend. See where it fits in the platform, or read the longer argument for why rule review needs network context.