A Netbox plugin for Access List management.

This plugin provides the following models:

• Access Lists
• Access List to Interface Assignment
• Access List Rules (abstract model basis for other rules)
• Access List Standard Rules
• Access List Extended Rules

Based on the NetBox plugin tutorial by jeremystretch:

• demo repository
• tutorial

All credit should go to Jeremy. Thanks, Jeremy!

This project just looks to build on top of this framework and model presented.

This project is currently maintained jointly by:

• Abhimanyu Saharan
• Ryan Merolle

See the CONTRIBUTING for more information.

Each Plugin Version listed below has been tested with its corresponding NetBox Version.

For adding to a NetBox Docker setup see the general instructions for using netbox-docker with plugins.

You can install with pip:

pip install netbox-acls

or by adding to your local_requirements.txt or plugin_requirements.txt (netbox-docker):

netbox-acls

Enable the plugin in /opt/netbox/netbox/netbox/configuration.py, or if you use netbox-docker, your /configuration/plugins.py file :

PLUGINS = [
    "netbox_acls"
]

PLUGINS_CONFIG = {
    "netbox_acls": {
        "top_level_menu": True # If set to True the plugin will add a top level menu item for the plugin. If set to False the plugin will add a menu item under the Plugins menu item.  Default is set to True.
    },
}

To develop this plugin further one can use the included .devcontainer configuration. This configuration creates a docker container which includes a fully working netbox installation. Currently it should work when using WSL 2. For this to work make sure you have Docker Desktop installed and the WSL 2 integrations activated.

1. In the WSL terminal, enter code to run Visual studio code.
2. Install the devcontainer extension "ms-vscode-remote.remote-containers"
3. Press Ctrl+Shift+P and use the "Dev Container: Clone Repository in Container Volume" function to clone this repository. This will take a while depending on your computer
4. If you'd like the netbox instance to be prepopulated with example data from netbox-initializers run make initializers
5. Start the netbox instance using make all

Your netbox instance will be served under 0.0.0.0:8000, so it should now be available under localhost:8000.

Access List - List View

Access List (Type Extended) - Individual View

Access List (Type Standard) - Individual View

Extended Access List Rules - List View

Standard Access List Rules - List View

Access List Interface Assignments- List View

Host (device, virtual_chassis, virtual_machine) Access Lists - New Card

Host Interface (vminterface interface) Access Lists - New Card