NetBox

Le connecteur NetBox vous permet de synchroniser vos données de gestion d'infrastructure réseau directement depuis votre instance NetBox.

Objectif

Le connecteur NetBox permet de récupérer les informations suivantes :

• Plan d'adressage IP (IPAM)
• Inventaire des équipements réseau
• Câblage et topologie

Prérequis

• Instance NetBox accessible (version 3.0+)
• Token API NetBox généré
• Permissions de lecture sur les données IPAM et d'inventaire

Informations à fournir dans OverSOC

Configuration

Générer un token API NetBox

1. Connectez-vous à votre instance NetBox.
2. Cliquez sur votre icône de profil utilisateur dans le coin supérieur droit.
3. Sélectionnez API Tokens dans le menu.
4. Cliquez sur Add a token.
5. Remplissez les détails du token :
   • Description : OverSOC Connector
   • Write enabled : Laissez décoché (lecture seule recommandée)
6. Cliquez sur Create.
7. Copiez immédiatement la valeur du token (elle n'apparaîtra qu'une seule fois). Le token aura le format nbt_... lors de l'utilisation de l'API v2.

Configurer le connecteur dans OverSOC

1. Dans OverSOC, accédez à Data Sources Settings > Sources.
2. Sélectionnez NetBox et cliquez sur Configure.
3. Renseignez tous les champs requis :
   • Server URL : Votre URL d'instance NetBox (ex: https://netbox.example.com)
   • API Token : Votre token généré
4. Cliquez sur Save Configuration.

Référence : NetBox REST API - Authentication

Permissions requises

Le token API doit disposer des permissions minimales suivantes :

• Accès en lecture aux objets IPAM (Adresses IP, Préfixes, VLANs, etc.)
• Accès en lecture à l'inventaire (Devices, Device types, Interfaces, etc.)
• Accès en lecture au câblage (Cables, Power connections, etc.)