Configurer NetBox pour ton équipe

La page précédente t'a laissé un NetBox qui tourne et un administrateur. Avant que les collègues reçoivent l'URL, une poignée de réglages transforment une installation en ton instance. La plupart vivent dans configuration.py ; le reste passe par l'API REST, pour pouvoir le rejouer sur la prochaine instance.

Avant de commencer

$curl -sf -H 'Authorization: Token ${NETBOX_TOKEN}' https://netbox.example.com/api/status/ | python3 -m json.tool | head -3

{
"django-version": "5.x",

Réglages de l'instance

Ajoute à la fin de /opt/netbox/netbox/netbox/configuration.py :

TIME_ZONE = 'Europe/Paris'
BANNER_TOP = 'Lab instance — data may be reset'
LOGIN_REQUIRED = True
CHANGELOG_RETENTION = 180

Envoi de mail

EMAIL = {
    'SERVER': 'smtp.example.com',
    'PORT': 587,
    'USE_TLS': True,
    'FROM_EMAIL': 'netbox@example.com',
    'TIMEOUT': 10,
}

Après redémarrage (section suivante), envoie-toi un message de test :

$sudo /opt/netbox/venv/bin/python /opt/netbox/netbox/manage.py sendtestemail toi@example.com

Test email sent to: toi@example.com

Groupes et permissions

$API=https://netbox.example.com/api
$AUTH="Authorization: Token ${NETBOX_TOKEN}"
$curl -sf -H "$AUTH" -H 'Content-Type: application/json' "$API/users/groups/" -d '{"name": "netops"}'
$curl -sf -H "$AUTH" -H 'Content-Type: application/json' "$API/users/groups/" -d '{"name": "readers"}'

Plugins

$echo netbox-topology-views | sudo tee -a /opt/netbox/local_requirements.txt

Active-les dans configuration.py (les noms de modules utilisent des tirets bas) :

PLUGINS = ['netbox_topology_views']

Puis installe et migre :

$sudo /opt/netbox/upgrade.sh

Champs personnalisés

$curl -sf -H "$AUTH" -H 'Content-Type: application/json' "$API/extras/custom-fields/" -d '{
$  "name": "asset_tag_internal",
$  "label": "Numéro d'\''inventaire interne",
$  "type": "text",
$  "object_types": ["dcim.device"],
$  "required": false,
$  "filter_logic": "exact"
$}'

Redémarrer et vérifier

$sudo systemctl restart netbox netbox-rq

$systemctl is-active netbox netbox-rq

active
active

$curl -sf -H 'Authorization: Token ${NETBOX_TOKEN}' https://netbox.example.com/api/users/groups/ | python3 -c 'import sys,json; print([g["name"] for g in json.load(sys.stdin)["results"]])'

['netops', 'readers']

$curl -sf -H 'Authorization: Token ${NETBOX_TOKEN}' https://netbox.example.com/api/plugins/ | grep -o '"name": "[^"]*"'

"name": "Topology views"

Terminé

Ton instance a un nom sur chaque page, envoie des mails, sait qui peut modifier quoi, et porte les premiers champs dont tes données ont besoin. Suite : la garder dans cet état, avec mises à jour, sauvegardes et supervision.