mechub sovereign network-security automation ← all projects
tool early MIT

srxsync

Golden-source SRX fleet sync

Keeps a fleet of Juniper SRX firewalls in sync with a designated master SRX, with commit confirmed safety rails, drift detection and per-target include lists.

About

srxsync reads selected configuration sections from a master Juniper SRX and pushes them to a list of target devices, so a golden device can drive the rest of the fleet.

Every load is paired with commit confirmed, so a crash or network drop between steps auto-rolls back the SRX.

It does not follow the "a human approves" model: there is no approval step, so run check and --dry-run first.

Features

  • Sync categories: objects, policies, NAT, QoS and zones; interfaces, routing and system are never cross-synced
  • Each target's include list names exactly what it receives, with no implicit inheritance
  • srxsync check reports drift; push supports --replace or --merge and --dry-run
  • Secret providers: env, netrc, keyring and Vault
  • Default PyEZ transport, with an optional Rust-backed rustez transport

Quick start

Install (not on PyPI; no tagged release yet)

python -m venv .venv
source .venv/bin/activate
pip install -e .

Credentials (per host)

SRX_USER_<HOST> plus SRX_PASSWORD_<HOST> or SRX_SSH_KEY_<HOST>; host name upper-cased, dots and dashes become underscores (srx-a.example.net -> SRX_USER_SRX_A_EXAMPLE_NET)

Check, dry-run, then push

srxsync check --inventory inv.yaml --verbose
srxsync push --inventory inv.yaml --merge --dry-run
srxsync push --inventory inv.yaml --merge --commit-confirmed 5

Full instructions in the README ↗