57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# NetBox Better IPs
|
|
|
|
Plugin für **NetBox 4.6.5** mit zwei Funktionen:
|
|
|
|
- Beim Speichern einer IP-Adresse wird das durch deren CIDR-Maske beschriebene Prefix gesucht und, falls es fehlt, automatisch erstellt. NetBox ordnet die IP danach nativ anhand von Prefix und VRF ein.
|
|
- Eine zusätzliche IP-Netzübersicht kann nach Organisation/Region, Standortgruppe, Standort, Lokation, Mandantengruppe und Mandant gefiltert werden.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
/opt/netbox/venv/bin/pip install git+https://git.mrblake.cc/MrBlake/Netbox-Better-IPs.git
|
|
```
|
|
|
|
```bash
|
|
echo "git+https://git.mrblake.cc/MrBlake/Netbox-Better-IPs.git" >> /opt/netbox/local_requirements.txt
|
|
```
|
|
|
|
In `configuration.py`:
|
|
|
|
```python
|
|
PLUGINS = ["netbox_better_ips"]
|
|
|
|
PLUGINS_CONFIG = {
|
|
"netbox_better_ips": {
|
|
"auto_create_prefix": True,
|
|
"prefix_status": "active",
|
|
"inherit_scope": True,
|
|
"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 `192.0.2.0/24` in derselben VRF erstellt. Bei einer Interface-Zuweisung wird bevorzugt die Lokation, sonst der Standort als Prefix-Scope übernommen. Der Mandant wird von der IP oder dem zugewiesenen Gerät/der VM übernommen. Vorhandene Prefix-Metadaten werden nie überschrieben.
|
|
|
|
Hostmasken (`/32`, `/128`) werden standardmäßig nicht als Prefix erstellt. Dies kann mit `ignore_host_prefixes=False` geändert werden.
|
|
|
|
Bereits vorhandene IP-Adressen lassen sich abgleichen:
|
|
|
|
```bash
|
|
python /opt/netbox/netbox/manage.py reconcile_ip_prefixes --dry-run
|
|
python /opt/netbox/netbox/manage.py reconcile_ip_prefixes
|
|
```
|
|
|
|
## 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.
|
|
|
|
## 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.
|
|
|