Skip to main content
Cloud

Policy Pack Library

NetBox Validation ships with pre-built policy packs that you can install in one click. Starter packs cover common validation scenarios. Compliance framework packs map industry standards to NetBox-validatable checks.

Starter Packs

Browsing and Installing

In NetBox, navigate to Validation > Policy Packs in the sidebar. The library shows all available packs with their engine type, rule count, and installation status.

Policy Pack Library

Click Install next to any pack to create the policy and all its rules in one step. Installed packs show a green checkmark and can be uninstalled (if no runs reference them).

Via API:

# List available packs
curl https://your-netbox/api/plugins/validation/policy-packs/ \
-H "Authorization: Bearer $NETBOX_TOKEN"

# Install a pack
curl -X POST https://your-netbox/api/plugins/validation/policy-packs/addressing-ipam/install/ \
-H "Authorization: Bearer $NETBOX_TOKEN"

# Uninstall a pack (if no runs reference it)
curl -X POST https://your-netbox/api/plugins/validation/policy-packs/addressing-ipam/uninstall/ \
-H "Authorization: Bearer $NETBOX_TOKEN"

Available Starter Packs

PackRulesEngineFocus
Addressing & IPAM5IntentIP addressing and IPAM compliance
Cabling & Topology6IntentCabling integrity and topology audit
Data Quality6IntentRequired fields, circuit terminations, config context
Naming & Standards8IntentNaming conventions and fleet-wide standards
Redundancy & Resilience5IntentUplink, power, and path redundancy
Security Intent5IntentForbidden values, VRF enforcement, secrets detection
Leaf Intent Baseline10Intent + ConfigBaseline validation for leaf switches
Spine Intent Baseline8Intent + ConfigBaseline validation for spine switches
Config Analysis Baseline17ConfigConfig parse quality, BGP, routing, ACLs
Pre-Change Config Validation10ConfigDifferential config validation for branches
Power Resilience6GraphPower chain completeness, redundancy, blast radius
Network Resilience9GraphNetwork topology and failure domain analysis
BGP Attribute Verification3ConfigBGP local preference, MED, and route advertisement
Full Resilience Audit15Graph + ConfigAll 15 graph checks -- power, topology, and logical

Customizing After Installation

Installed packs create regular policies and rules -- you can edit them freely in NetBox:

  • Narrow the scope: Add site, role, or platform filters to the policy
  • Adjust parameters: Edit individual rules to change thresholds (e.g., min_uplinks: 4 instead of the default 2)
  • Add or remove rules: Delete rules you don't need, add new ones
  • Set triggers and schedule: Enable branch merge or CR triggers, add a cron schedule

YAML Import/Export

Policies can also be imported and exported as YAML:

Export:

# Single policy
curl -X POST https://your-netbox/api/plugins/validation/policies/1/export/ \
-H "Authorization: Bearer $NETBOX_TOKEN"

# All policies
curl -X POST https://your-netbox/api/plugins/validation/policies/export-all/ \
-H "Authorization: Bearer $NETBOX_TOKEN"

YAML format:

name: Leaf Intent Baseline
description: Standard intent validation for leaf switches
enable_config_engine: false
enable_graph_engine: false
trigger_on_branch_merge: false
trigger_on_cr_submit: true
schedule: "0 2 * * *"
rules:
- name: No Duplicate IPs
engine: intent
category: addressing
check_name: no_duplicate_ips
severity: critical

- name: Minimum Uplinks
engine: intent
category: redundancy
check_name: min_cabled_uplinks
severity: critical
parameters:
min_uplinks: 2

Import:

curl -X POST https://your-netbox/api/plugins/validation/policies/import/ \
-H "Authorization: Bearer $NETBOX_TOKEN" \
-H "Content-Type: application/json" \
-d @leaf-intent-baseline.yaml

Compliance Framework Packs

Available to Premium tier customers.

Eight compliance framework policy packs map industry standards and regulatory frameworks to NetBox-validatable checks. Each pack documents what it covers and explicitly notes what requires other tools.

These provide design-time compliance validation -- they validate infrastructure intent (the design documented in NetBox) before deployment. This is complementary to runtime compliance tools that validate live device state after deployment. NetBox Validation prevents compliance drift; runtime tools detect it.

Available Frameworks

PackFrameworkEnginesRules
CLOS Fabric DesignCLOS leaf-spine architectureIntent + Config + Graph19
TIA-942Data center tiers (I--IV)Intent + Graph20
NIS2 / DORAEU cyber resilience regulationIntent + Config + Graph21
NIST 800-53US federal security controlsIntent + Config + Graph26
NERC CIPCritical infrastructure protectionIntent + Config + Graph18
PCI-DSSPayment card data securityIntent + Config + Graph16
MANRSRouting security best practicesIntent + Config + Graph15
ISO 27001:2022Information security managementIntent + Config + Graph22

Total: 157 rules across 8 frameworks.

Installing Framework Packs

In NetBox, navigate to Validation > Policy Packs. Compliance framework packs appear in a separate section from starter packs. Click Install to load a framework with all its rules.

Via API:

curl -X POST https://your-netbox/api/plugins/validation/policy-packs/compliance-nist-800-53/install/ \
-H "Authorization: Bearer $NETBOX_TOKEN"

After Installation: Customize Parameters

Framework packs include default values for site-specific parameters. After loading, review each policy in NetBox and customize these parameters for your environment:

  • VRF names: Replace MGMT with your management VRF name
  • Restricted prefixes: Set your actual restricted prefix ranges
  • CDE subnets (PCI-DSS): Replace 172.16.0.0/16 with your cardholder data environment prefix
  • Spine role (CLOS): Set spine_role to match your spine device role name

Parameter customization is done by editing individual rules on the policy detail page in NetBox.

Coverage Transparency

Each pack explicitly documents both what it covers and what it doesn't. NetBox Validation validates what NetBox can validate -- network segmentation, power redundancy, routing security, config hygiene. Controls that require runtime monitoring, human procedures, or physical security are explicitly called out as out of scope.

Framework Details

CLOS Fabric Design (19 rules)

Coverage: Leaf-spine full mesh, /31 P2P links, loopback /32s, eBGP multipath, EVPN/VXLAN overlay, ECMP path redundancy, SPOF detection.

Not covered: Traffic engineering, QoS policies, telemetry pipelines.

Prerequisites: Set spine_role parameter to match your spine device role name. Config engine checks require Config Templates assigned to devices.

Control AreaKey ChecksEngine
Fabric connectivityleaf_spine_connectivity, symmetric_cablingIntent
Addressingpoint_to_point_subnet_sizing, loopback_has_host_route, no_duplicate_ipsIntent
Routingbgp_sessions, bgp_unestablished_reason, bgp_process_config, bgp_localpref_equalsConfig
Overlayevpn_l3_vni_consistency, vxlan_vni_configConfig
Resiliencedevice_single_point_of_failure, forwarding_path_redundancyGraph

TIA-942 Data Center Tiers (20 rules)

Coverage: Power path completeness (Tier I+), N+1 feed redundancy (Tier II+), panel-level independence and concurrent maintainability (Tier III+), WAN circuit diversity, physical SPOF detection, asset documentation.

Not covered: Cooling, fire suppression, physical security, mechanical systems.

Prerequisites: Requires power feeds, power panels, and power port cabling in NetBox. Circuit and provider data for WAN diversity checks.

TierKey ChecksEngine
Tier Ipower_path_complete, power_feed_capacityGraph
Tier IIpower_redundancy (feed), power_feed_blast_radiusGraph
Tier IIIpower_redundancy (panel), concurrent_maintainabilityGraph
Generaldevice_single_point_of_failure, site_connectivity_redundancy, asset_documentation_completeGraph + Intent

NIS2 / DORA (21 rules)

Controls mapped: NIS2 Art.21(2) risk analysis, incident handling, business continuity, supply chain security, network security, vulnerability assessment, cyber hygiene. DORA Art.9 ICT risk, Art.10 concentration risk, Art.11 testing.

Not covered: Governance processes, authority reporting, staff training, incident response procedures.

Prerequisites: Customize management_vrf_name (default: MGMT) and restricted_prefixes parameters.

NIST 800-53 (26 rules)

Control families mapped: SC (System and Communications Protection), CM (Configuration Management), CP (Contingency Planning), AC (Access Control).

Not covered: AU (audit logging), AT (training), PS (personnel), PE (physical), SI (system monitoring).

Prerequisites: Customize management_vrf_name, restricted_prefixes, and ospf_authentication_configured.require_type parameters.

NERC CIP (18 rules)

Controls mapped: CIP-005 (Electronic Security Perimeter), CIP-007 (System Security Management), CIP-010 (Configuration Change Management), CIP-009 (Recovery Plans).

Not covered: CIP-004 (personnel training), CIP-006 (physical access logs), CIP-011 (information protection).

Prerequisites: Customize management_vrf_name for your BES management VRF and restricted_prefixes for ESP boundary prefixes.

PCI-DSS (16 rules)

Controls mapped: Req 1 (CDE network segmentation via VRF + ACL), Req 2 (secure config -- no defaults, no plaintext), Req 11 (segmentation testing via differential reachability).

Not covered: Req 3--4 (data encryption), Req 6 (application security), Req 9 (physical access).

Prerequisites: Replace default CDE subnet 172.16.0.0/16 with your actual cardholder data environment prefix. Configure assert_traffic_blocked source/destination IPs for your corporate-to-CDE boundary.

MANRS (15 rules)

Actions mapped: Action 1 (filtering -- BGP session validation, prefix filter verification), Action 2 (anti-spoofing -- duplicate IP detection, ACL verification), Action 3 (coordination -- contact documentation), Action 4 (global validation -- BGP authentication, loop detection).

Not covered: RPKI ROA publication, IRR database entries.

Prerequisites: No site-specific customization required. Works with default parameters for BGP-heavy environments.

ISO 27001:2022 (22 rules)

Controls mapped: A.8.20 (network security), A.8.21 (network services), A.8.22 (segregation), A.8.24 (cryptography), A.8.9 (config management), A.5.37 (documented procedures).

Not covered: A.5.15--18 (identity management), A.7 (physical security), A.8.25--28 (application controls).

Prerequisites: Customize management_vrf_name (default: MGMT) and restricted_prefixes parameters.