Files
harmony/examples/opnsense
Jean-Gabriel Gill-Couture 3b2da4d6ff
Some checks failed
Run Check Script / check (pull_request) Failing after 2s
chore: clear compile warnings; retire SecretManager
- Migrate callers from SecretManager to harmony_config::get_or_prompt
- Lazy-init global ConfigClient from HARMONY_SECRET_NAMESPACE
- Convert remaining Secret derives to Config + #[config(secret)]
- Remove deprecated SecretManager
- Retry::spawn → start; drop unused import; cfg-gate nm_bond_mode
- allow(deprecated) on legacy ApplicationScore examples
2026-08-07 19:12:10 -04:00
..

OPNsense Basic Example

Demonstrates connecting to an existing OPNsense firewall and running Harmony Scores against it.

Prerequisites

  • An OPNsense firewall accessible via SSH and REST API
  • API key + secret created in OPNsense (System > Access > Users > API keys)

Usage

# Set credentials (or use env.sh)
export OPNSENSE_API_KEY=your_key
export OPNSENSE_API_SECRET=your_secret

# Run against a specific OPNsense host
cargo run -p example-opnsense -- 192.168.1.1

Scores applied

Score What it configures
DhcpScore DHCP range and static host bindings via dnsmasq

For automated VM-based testing

See examples/opnsense_vm_integration/ which boots a fresh OPNsense VM via KVM, runs 11 Scores, and verifies idempotency automatically.