{ "info": { "author": "Jos\u00e9 Lopes de Oliveira Jr.", "author_email": "jlojunior@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# netbox-scanner\nA scanner util for [NetBox](https://netbox.readthedocs.io/en/stable/), because certain networks can be updated automagically. `netbox-scanner` aims to create, update, and delete hosts (`/32`) in NetBox, either discovered after network probes and imported from CSV files.\n\n\n## Installation\n`netbox-scanner` is available as a Python package via [PyPi](https://pypi.org/project/netbox-scanner/), so you can install it using `pip`:\n\n $ pip3 install netbox-scanner\n\nYou can also download from GitHub:\n\n $ wget https://github.com/forkd/netbox-scanner/archive/master.zip\n $ unzip netbox-scanner-master.zip -d netbox-scanner\n $ cd netbox-scanner\n $ pip install -r requirements.txt\n $ python netbox-scanner/nbscanner\n\nNote that `netbox-scanner` will require [Nmap](https://nmap.org/) and an instance of NetBox ready to use.\n\n\n## Scanning the Network\nTo use `netbox-scanner` as a script, simply run `netbox-scanner/nbscanner` and it'll create its configuration file (`.netbox-scanner.conf`) in your home folder:\n\n $ python nbscanner\n\nAfter that, you'll just need to edit that file with your environment settings and run the script again, and `netbox-scanner` will do the following tasks:\n\n1. It will scan all networks defined in the configuration file.\n2. For each discovered host it will:\n 1. If it is in NetBox, description is different, and `tag` is equal to that defined in the configuration file, description will be updated in NetBox.\n 2. If host is not in NetBox, it'll be created.\n3. The script will iterate through each network to find and delete any hosts registered in NetBox that did not respond to scan, and have the `tag` defined in the configuration file.\n\nFor instance, if some hosts in your monitored networks are eventually down, but you don't want `netbox-scanner` to manage them, just make sure that they **don't** have the tag defined in the configuration file.\n\nOf course, you can use `cron` to automatically run `nbscanner`.\n\n\n## Configuration File\n`netbox-scanner` have a configuration file with all parameters needed to scan networks and synchronize them to NetBox. By default, this file is located at user's home folder and is created when `nbscanner` is executed for the first time. Before using `nbscanner` you should edit that file and fill all variables according to your environment.\n\n\n## Importing from CSV File\n`netbox-scanner` can import data from CSV files in the following format:\n\n IP Address,Description\n 10.0.0.1,Gateway\n 10.0.0.2,NTP Server\n ...\n\nNote that the first line is header, IP addresses aren't in CIDR notation (a `/32` will be appended to all addresses automatically) and commas aren't accepted in description. You can import this file using the `--csv` parameter, like this:\n\n $ nbscanner --csv netbox.csv\n\n\n## License\n`netbox-scanner` is licensed under a MIT license --read `LICENSE` file for more information.", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/forkd/netbox-scanner", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "netbox-scanner", "package_url": "https://pypi.org/project/netbox-scanner/", "platform": "", "project_url": "https://pypi.org/project/netbox-scanner/", "project_urls": { "Homepage": "https://github.com/forkd/netbox-scanner" }, "release_url": "https://pypi.org/project/netbox-scanner/0.7.2/", "requires_dist": null, "requires_python": "", "summary": "A scanner util for NetBox", "version": "0.7.2" }, "last_serial": 4428606, "releases": { "0.0.3": [ { "comment_text": "", "digests": { "md5": "8fc7ac4424449e6921c3800e88201527", "sha256": "79deba8be826f88f74d13b9d3fb36d8475c6c20bdcfabf9e905bc7daf9dda1de" }, "downloads": -1, "filename": "netbox_scanner-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "8fc7ac4424449e6921c3800e88201527", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4925, "upload_time": "2018-09-18T23:32:00", "url": "https://files.pythonhosted.org/packages/92/80/bb7d3fcf900921953de130f87d978303e6be1aaba476000bfe8acddeac13/netbox_scanner-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5a81cc078065991c37cae985d641edf3", "sha256": "5092230b8115482f92db1ff0e96c4b6c9bc2f030ffb7152e01c1effa7d79e55d" }, "downloads": -1, "filename": "netbox-scanner-0.0.3.tar.gz", "has_sig": false, "md5_digest": "5a81cc078065991c37cae985d641edf3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3349, "upload_time": "2018-09-18T23:32:02", "url": "https://files.pythonhosted.org/packages/df/b2/2c46d8fd68f83936a84f0b4c3f28eb8d64616c243462c7b13f2d418a50fa/netbox-scanner-0.0.3.tar.gz" } ], "0.0.5": [ { "comment_text": "", "digests": { "md5": "7c33bb191fb64f323e607fbe164ee10f", "sha256": "e88b549c5d01e9e03a19c5cb74a0f082ba8a2c2a3ba9243cff4e140888ed6201" }, "downloads": -1, "filename": "netbox-scanner-0.0.5.tar.gz", "has_sig": false, "md5_digest": "7c33bb191fb64f323e607fbe164ee10f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3012, "upload_time": "2018-09-19T20:11:00", "url": "https://files.pythonhosted.org/packages/00/63/f0f90b9d7b467463aead2770dacfec1912e247e25974a7cd1bcebb58cea2/netbox-scanner-0.0.5.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "36020e9773a67225b9b84c82879d3a16", "sha256": "4a52dee4dd59f46ac6f9f612cd3d33dfb3d3d288d6fb5a2464d30f3eaece0ee4" }, "downloads": -1, "filename": "netbox-scanner-0.1.0.tar.gz", "has_sig": false, "md5_digest": "36020e9773a67225b9b84c82879d3a16", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3306, "upload_time": "2018-09-20T14:56:39", "url": "https://files.pythonhosted.org/packages/7d/22/1ee95dcb6ce0319c0a7ed4feb6c7659523c4ab61a862c1b7aa127e08aa97/netbox-scanner-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "02a91c527b89d29f3c569539d5add2c1", "sha256": "d67ec78b258b1c6d0c56e2eeca310008a51558881b00dbbf657dc621454858d9" }, "downloads": -1, "filename": "netbox-scanner-0.1.1.tar.gz", "has_sig": false, "md5_digest": "02a91c527b89d29f3c569539d5add2c1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3438, "upload_time": "2018-09-20T20:04:13", "url": "https://files.pythonhosted.org/packages/9f/c7/48cce8b5751d80ef0ad9d579e49b77bd5e95530931e3a1fb48096ab9c4ca/netbox-scanner-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "c665f3ad06f3f3d52e5bfa5772a79948", "sha256": "5a9c80a1eb818bdc34d8803aa5029f04382579a778ecdb563d8a4168579a517c" }, "downloads": -1, "filename": "netbox-scanner-0.2.0.tar.gz", "has_sig": false, "md5_digest": "c665f3ad06f3f3d52e5bfa5772a79948", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3773, "upload_time": "2018-09-21T15:56:11", "url": "https://files.pythonhosted.org/packages/aa/68/b38599e6089091ec03b8623021d217bf2096f22f8068ad80fc186bfffd37/netbox-scanner-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "0beeecfc0e0c3b2601c34d43d3efe629", "sha256": "44a0c0415f92a14940827dd0eecb2b8c7a5963a4ee5cc0163a02fe54b96f612d" }, "downloads": -1, "filename": "netbox-scanner-0.2.1.tar.gz", "has_sig": false, "md5_digest": "0beeecfc0e0c3b2601c34d43d3efe629", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3857, "upload_time": "2018-09-24T20:59:52", "url": "https://files.pythonhosted.org/packages/26/8c/43cc07d1d2df79a5dfc17048ca37284b7b3593d97b9231f35c27f98d9fda/netbox-scanner-0.2.1.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "5479dde2308905da40df8d2546be84ae", "sha256": "502288ea141c64319e0ef23091e228a0b82e0550ecdf73e745ed091cadc99bad" }, "downloads": -1, "filename": "netbox-scanner-0.3.0.tar.gz", "has_sig": false, "md5_digest": "5479dde2308905da40df8d2546be84ae", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4063, "upload_time": "2018-09-25T20:34:27", "url": "https://files.pythonhosted.org/packages/9c/86/6cd0c7e5d38a4857c6c640e15efdbaa9bb301a4aaa757980631c47132d78/netbox-scanner-0.3.0.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "426b90aefd956630a9ccc53e887f1cc5", "sha256": "c2d860b26d903a96a66a6c15c2d10d87df13c91778180384b9072dcf8c11a048" }, "downloads": -1, "filename": "netbox-scanner-0.5.0.tar.gz", "has_sig": false, "md5_digest": "426b90aefd956630a9ccc53e887f1cc5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5046, "upload_time": "2018-10-03T19:43:01", "url": "https://files.pythonhosted.org/packages/8d/c4/c7b842a2cccdf6be9945f8a8def2acead4d06a92f0c4c7e56b245571ef68/netbox-scanner-0.5.0.tar.gz" } ], "0.5.1": [ { "comment_text": "", "digests": { "md5": "05a84670c1df51d24a9adbfc1f773e5b", "sha256": "c7910ddc29730b98f8cc1155e13c209f40474742f0e08e8106e26eda2c045526" }, "downloads": -1, "filename": "netbox-scanner-0.5.1.tar.gz", "has_sig": false, "md5_digest": "05a84670c1df51d24a9adbfc1f773e5b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5118, "upload_time": "2018-10-04T15:52:53", "url": "https://files.pythonhosted.org/packages/a5/63/2d834c0e765401f3ad548e44b3357aadb8973159d15470c74238b6d000e6/netbox-scanner-0.5.1.tar.gz" } ], "0.5.2": [ { "comment_text": "", "digests": { "md5": "5954c59753f9873bbbbede4cffea08b6", "sha256": "6324df70b34a92e8affbd9a51c405751b9f929563b7c49934af82f6ea4ff5e11" }, "downloads": -1, "filename": "netbox-scanner-0.5.2.tar.gz", "has_sig": false, "md5_digest": "5954c59753f9873bbbbede4cffea08b6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5131, "upload_time": "2018-10-04T19:04:34", "url": "https://files.pythonhosted.org/packages/26/e3/1513fd45377d7a4449d1a7d72d96d8a7f27fe02ce10a13193b784ba0cf30/netbox-scanner-0.5.2.tar.gz" } ], "0.5.3": [ { "comment_text": "", "digests": { "md5": "78c01ad30f879726084ab4f894939b11", "sha256": "ce3e0f505291eb081a2173c03a6f41d55d01dbc687aed6b0eabaf1f510064033" }, "downloads": -1, "filename": "netbox-scanner-0.5.3.tar.gz", "has_sig": false, "md5_digest": "78c01ad30f879726084ab4f894939b11", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5384, "upload_time": "2018-10-05T20:46:50", "url": "https://files.pythonhosted.org/packages/2f/27/276f431efba12929c07a585797661731a809ebd12fde057f9cb6e17bde53/netbox-scanner-0.5.3.tar.gz" } ], "0.5.4": [ { "comment_text": "", "digests": { "md5": "035f5dfbd75f57e1a9ca6b1476697040", "sha256": "ddc26d57d8ec26be7a4c5cbaaba8e9505e79f0ed6690e2eee91b8f7712875a5c" }, "downloads": -1, "filename": "netbox-scanner-0.5.4.tar.gz", "has_sig": false, "md5_digest": "035f5dfbd75f57e1a9ca6b1476697040", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5392, "upload_time": "2018-10-08T13:42:59", "url": "https://files.pythonhosted.org/packages/2c/dc/c8f7a967b6e4fd32b464aed6d82fc36d16ff7f2f3ab8eebd826d8198602f/netbox-scanner-0.5.4.tar.gz" } ], "0.5.5": [ { "comment_text": "", "digests": { "md5": "3ef01a6d8f45fa52c7a17e73829789f2", "sha256": "613c2834797870f1cd275e0b11b2bc5d17bd49f2b5e033482b4d4b5f4d19a67a" }, "downloads": -1, "filename": "netbox-scanner-0.5.5.tar.gz", "has_sig": false, "md5_digest": "3ef01a6d8f45fa52c7a17e73829789f2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5536, "upload_time": "2018-10-09T15:47:32", "url": "https://files.pythonhosted.org/packages/21/92/909ca36c9f6d990486b0cf8289ee2774a14873fbeb9f8f985afac3fd184f/netbox-scanner-0.5.5.tar.gz" } ], "0.5.6": [ { "comment_text": "", "digests": { "md5": "ea919ae063ca69878c7f4fc0fe3eca01", "sha256": "8df209037a94a5cec281dd134ea1b921a41e6380ec85385987b5f29c85a10575" }, "downloads": -1, "filename": "netbox-scanner-0.5.6.tar.gz", "has_sig": false, "md5_digest": "ea919ae063ca69878c7f4fc0fe3eca01", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5735, "upload_time": "2018-10-10T19:02:59", "url": "https://files.pythonhosted.org/packages/df/65/4dffb2b938daea04c901946a08f838c2fa1316170944ab6347305d5830a0/netbox-scanner-0.5.6.tar.gz" } ], "0.6.0": [ { "comment_text": "", "digests": { "md5": "313517c3eedc7e4a82b2d681291f17ea", "sha256": "2f24fbd8b8314bb47868172d91693d4fcd2947191334ee7fe17b2ff0e05b3b46" }, "downloads": -1, "filename": "netbox-scanner-0.6.0.tar.gz", "has_sig": false, "md5_digest": "313517c3eedc7e4a82b2d681291f17ea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5783, "upload_time": "2018-10-24T15:41:09", "url": "https://files.pythonhosted.org/packages/96/68/551a88ea715a415a697cef94441645bcfa35870310e5b4e842d1756f893c/netbox-scanner-0.6.0.tar.gz" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "e52d63df8b1a21636467a0e8becf85e3", "sha256": "013bf37d602f13bf5e986fe80d240604258605fc9edfe26359ff53dbb21f3575" }, "downloads": -1, "filename": "netbox-scanner-0.7.0.tar.gz", "has_sig": false, "md5_digest": "e52d63df8b1a21636467a0e8becf85e3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5865, "upload_time": "2018-10-24T18:33:36", "url": "https://files.pythonhosted.org/packages/94/bc/fb06639288dbb1a03eed64b908e66dcedac18640696bd4b49ef08b91f4f1/netbox-scanner-0.7.0.tar.gz" } ], "0.7.1": [ { "comment_text": "", "digests": { "md5": "f2bae3791f1ec950cff455d54e4d6a71", "sha256": "2da3e9e447919905b377dfeb6b4aa450f4e5ce1e42e95de7ba91d91db5112862" }, "downloads": -1, "filename": "netbox-scanner-0.7.1.tar.gz", "has_sig": false, "md5_digest": "f2bae3791f1ec950cff455d54e4d6a71", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6045, "upload_time": "2018-10-26T13:35:16", "url": "https://files.pythonhosted.org/packages/f3/ea/d5d9da5b4b21909b55ccea823e74fdd141dbc104029bf9b11fc94cd3655e/netbox-scanner-0.7.1.tar.gz" } ], "0.7.2": [ { "comment_text": "", "digests": { "md5": "a54e19769fe56c4ac454175401bd371b", "sha256": "b34d271d0cac90051080092168f44bc4a3ded9957a02e1cdf6bbe8277a3a81da" }, "downloads": -1, "filename": "netbox-scanner-0.7.2.tar.gz", "has_sig": false, "md5_digest": "a54e19769fe56c4ac454175401bd371b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5182, "upload_time": "2018-10-29T18:21:40", "url": "https://files.pythonhosted.org/packages/68/d5/e36874a35694a08bcd14f1b2c10b4ce8e274eb04d470d5a23f4e0782ae4c/netbox-scanner-0.7.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a54e19769fe56c4ac454175401bd371b", "sha256": "b34d271d0cac90051080092168f44bc4a3ded9957a02e1cdf6bbe8277a3a81da" }, "downloads": -1, "filename": "netbox-scanner-0.7.2.tar.gz", "has_sig": false, "md5_digest": "a54e19769fe56c4ac454175401bd371b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5182, "upload_time": "2018-10-29T18:21:40", "url": "https://files.pythonhosted.org/packages/68/d5/e36874a35694a08bcd14f1b2c10b4ce8e274eb04d470d5a23f4e0782ae4c/netbox-scanner-0.7.2.tar.gz" } ] }