Configuration Parameters

The following plugin configuration parameters are available. These are set under PLUGINS_CONFIG in your NetBox configuration.py:

PLUGINS_CONFIG = {
    'netbox_changes': {
        'protect_main': True,
    },
}

protect_main

Default: False

When enabled, all object creations, changes, and deletions must be made within a branch. Changes to objects in main will not be permitted, except for those object types which do not support branching.

Bypass Permission

Users with the bypass permission can make changes directly to main even when protect_main is enabled. This is useful for administrators who need to make emergency fixes or resolve merge conflicts without creating a temporary branch. (Superusers are assigned this permission automatically.)

To bypass protect_main, a user must be assigned the netbox_changes.bypass_policy permission. This is achieved by assigning the user (or group) a permission on the NetBox Change Management > Policy object and specifying the bypass action in Permissions as shown below.