Version: 0.6 Author: John Neerdael Email: [email protected]
This script can be used to import data from NIOS CSV files in to BloxOne DDI. We expect CSV files per object type (example: networks.csv containing a header-network line and the objects which start with network).
Host objects are currently not supported in this script.
Python 3.6 or above
Non-standard modules:
- bloxone 0.5.6+
The latest version of the bloxone module is available on PyPI and can simply be installed using:
pip3 install bloxone --user
To upgrade to the latest version:
pip3 install bloxone --user --upgrade
Complete list of modules:
import bloxone
import csv
import json
import argparse
import re
import ipaddress
The bloxone module use an ini file for configuration.
A sample is provided called demo.ini. Unless an alternative is specified on the command line, the script will automatically use the demo.ini from the current working directory if available.
The format of the ini file is:
[BloxOne] url = 'https://csp.infoblox.com' api_version = 'v1' api_key = '<Your Region API Key Here>'
Once your API key is configured, your username and customer name are set you are ready to run the script with the required parameters.
csv2b1ddi.py supports -h or --help on the command line to access the options available:
$ ./csv2b1ddi.py --help
usage: csv2b1ddi [-h] [-b NETWORKCONTAINERS] [-n NETWORKS] [-r RANGES] [-f FIXED] [-z AUTHZONES] [-a ARECORD] [-t TXTRECORD] [-m MXRECORD] [-p PTRRECORD] [-s SRVRECORD] [--aaaa AAAARECORD] [--cname CNAMERECORD] [--tags TAGS] -i IPSPACE -c CONFIG [-v]
This is a simple NIOS to B1DDI migration tool
optional arguments:
-h, --help show this help message and exit
-b NETWORKCONTAINERS, --networkblock NETWORKCONTAINERS
CSV file with Networks data
-n NETWORKS, --networks NETWORKS
CSV file with Networks data
-r RANGES, --ranges RANGES
CSV file with DHCP ranges data
-f FIXED, --fixed FIXED
CSV file with Fixed Address data
-z AUTHZONES, --authzone AUTHZONES
CSV file with Authoritative Zones data
-a ARECORD, --arecord ARECORD
CSV file with A record data
-t TXTRECORD, --txtrecord TXTRECORD
CSV file with TXT record data
-m MXRECORD, --mxrecord MXRECORD
CSV file with MX record data
-p PTRRECORD, --ptrrecord PTRRECORD
CSV file with PTR record data
-s SRVRECORD, --srvrecord SRVRECORD
CSV file with SRV record data
--aaaa AAAARECORD CSV file with AAAA record data
--cname CNAMERECORD CSV file with AAAA record data
--tags TAGS Tags to apply to imported objects
-i IPSPACE, --ipspace IPSPACE
Name of IP space to import data in
-c CONFIG, --config CONFIG
Path to ini file with API key
-v, --version show program's version number and exit
- Tags are added in a specific format (note that currently the double quotes need to be escaped):
- $ ./csv2b1ddi-0.5.py --tags '{"OWNER":"jneerdael","LOCATION":"Amsterdam"}'
There is currently no or very little error handling. Please thread with caution, EA's are not imported and tags are currently only supported as shown above. We except a correct and existing BloxOne DNS view to be present in the CSV files, the ipspace provided through the CLI also needs to be present.