MrBlake
d904d335a9
- Start- und Endadressen als netaddr-Objekte übergeben - Fehler einzelner IP-Adressen beim Abgleich protokollieren - IP-Netzübersicht direkt im IPAM-Menü registrieren - Plugin-Version auf 1.2.1 erhöhen
2.6 KiB
NetBox Better IPs
Plugin für NetBox 4.6.5 mit zwei Funktionen:
- Beim Speichern einer IP-Adresse wird der durch deren CIDR-Maske beschriebene nutzbare IP-Bereich gesucht und, falls er fehlt, automatisch erstellt. Bei normalen IPv4-Subnetzen werden Netzwerk- und Broadcastadresse nicht in den Bereich aufgenommen.
- Eine zusätzliche IP-Netzübersicht kann nach Organisation/Region, Standortgruppe, Standort, Lokation, Mandantengruppe und Mandant gefiltert werden.
- Unter IPAM → IP-Bereiche legt die Aktion Alle fehlenden Bereiche anlegen die Bereiche für sämtliche bereits vorhandenen, sichtbaren IP-Adressen an.
- Unter IP-Bereich → IP-Adressen wird das zugehörige Gerät beziehungsweise die VM standardmäßig als eigene Spalte angezeigt.
- Die IP-Netzübersicht ist als eigener Eintrag direkt im Menü IPAM verfügbar.
Installation
/opt/netbox/venv/bin/pip install git+https://git.mrblake.cc/MrBlake/Netbox-Better-IPs.git
echo "git+https://git.mrblake.cc/MrBlake/Netbox-Better-IPs.git" >> /opt/netbox/local_requirements.txt
In configuration.py:
PLUGINS = ["netbox_better_ips"]
PLUGINS_CONFIG = {
"netbox_better_ips": {
"auto_create_range": True,
"range_status": "active",
"inherit_tenant": True,
"ignore_host_prefixes": True,
}
}
Danach NetBox neu starten. Das Plugin hat keine eigenen Datenbankmodelle und benötigt daher keine Migration.
Verhalten
Aus 192.0.2.17/24 wird bei Bedarf der IP-Bereich 192.0.2.1/24 bis 192.0.2.254/24 in derselben VRF erstellt. Der Mandant wird von der IP oder dem zugewiesenen Gerät/der VM übernommen. Vorhandene Bereichsmetadaten werden nie überschrieben.
Hostmasken (/32, /128) werden standardmäßig nicht als eigener Bereich erstellt. Dies kann mit ignore_host_prefixes=False geändert werden.
Bereits vorhandene IP-Adressen lassen sich abgleichen:
python /opt/netbox/netbox/manage.py reconcile_ip_ranges --dry-run
python /opt/netbox/netbox/manage.py reconcile_ip_ranges
Berechtigungen
Für die Übersicht ist die NetBox-Berechtigung ipam.view_prefix erforderlich. Die automatische Erstellung läuft serverseitig; stellen Sie sicher, dass dies zu Ihrem Berechtigungs- und Change-Control-Konzept passt.
Die Aktion für Bestandsdaten benötigt ipam.view_ipaddress und ipam.add_iprange. Sie verarbeitet nur IP-Adressen, die der ausführende Benutzer sehen darf.
Hinweis zu „Organisation"
NetBox besitzt kein separates Core-Modell namens Organisation. Die Übersicht bildet Organisation auf NetBox-Region ab und bezieht untergeordnete Regionen sowie deren Standorte und Lokationen ein.