NetBox is an Open Source IPAM and DCIM tool maintained by Digital Ocean.
Copy the example configuration in netbox.yaml.example
/opt/stackstorm/configs/netbox.yaml and edit as required.
It should look like this:
--- hostname: "netbox.corp.lan" api_token: "aaabbbccc111222333" use_https: true ssl_verify: true
After editing, run
sudo st2ctl reload --register-configs to ensure your configuration
There are more than 290 actions in this pack. Each maps to a particular NetBox API endpoint.
The action naming convention is easy to understand as it follows this basic pattern:
Example for the action to make a GET request for Sites:
Each action has been auto generated based on the NetBox OpenAPI (Swagger) spec file. The actions are periodically updated in accordance with new NetBox releases. Check the change log for details.
All GET actions have the ability to store the NetBox API response directly into the ST2 Key Store rather than provide it as standard action output. This is useful in cases where that reponse is extremely large and thus passing it between actions is impractical. This is controlled with the
save_in_key_store_ttl action parameters. Look at any
get.* action meta file for more details.
The pack contains a single sensor meant to interact with the NetBox Webhook functionality. NetBox has the ability to send webhooks to enternal systems when certain user defined events occur. The
netbox_webhooks sensor is setup to process those events and fire triggers into StackStorm.
The sensor injects three types of triggers based on the webhook event:
The trigger payload contains the entire contents of the webhook data from NetBox.
The sensor exposes three optional pack config parameters to control its operation. This example can be added to the netbox pack config.
sensor_address: 192.168.1.100 # defaults 0.0.0.0, making the sensor reachable on all host addresses sensor_port: 6000 # defaults to 6000 sensor_secret: "<webhook secret>" # defaults to empty string, which disables signature verification
Based on your desired settings, the URL for the webhook's configuration inside of NetBox will be:
Note: the sensor does not support HTTPS but this could be accomplished by fronting the sensor with Nginx/Apache/etc, which would terminate the SSL connection and then proxy the request to the sensor over HTTP.