Skip to main content
Back to the connector catalogue

Connector

NetBox

API credential, entered client by client.

Open-source network infrastructure management tool (DCIM/IPAM) — inventory of racks, equipment and IP address ranges, widely used by MSPs and network teams. Vigicap reads the number of devices recorded in the DCIM module (and, for information, the number of IP addresses in the IPAM) to evaluate the ReCyF objective « Inventaire des actifs ».

01

What to create in the tool

The access is created in NetBox, not in Vigicap.

Where to generate it

Create a token in NetBox: user menu (top right) > API Tokens > Add a token (or Admin > API Tokens depending on the version). The token is shown only once — copy it immediately.

Minimum role

Un jeton d'API dont la case « Write enabled » est décochée — NetBox le restreint alors aux opérations de lecture — rattaché à un utilisateur ne portant que les permissions d'objet dcim.view_device et ipam.view_ipaddress.

Taken from the vendor's own role model, and checked before publication.

02

What to enter in Vigicap

  • API tokensecret

    User menu > API Tokens > Add a token — write access is not required, read-only is enough.

    Jeton API NetBox

03

Per-client routing

The connection is made client by client: one credential per client, entered on that client's record. Nothing is shared between two clients, and disconnecting one leaves the other untouched.

04

What it does, and what it does not do

ISO 27001 controls covered

This connector's readings feed ${n} Annex A controls — derived from the ReCyF objectives above, not entered by hand.

  • 5.9 Inventory of information and other associated assets
  • 5.10 Acceptable use of information and other associated assets
  • 5.11 Return of assets
  • 5.12 Classification of information
  • 8.1 User endpoint devices

ReCyF objectives it pre-fills

A reading feeds one objective of the ANSSI ReCyF framework. It PROPOSES it: the level only counts once a consultant has confirmed it.

  • #1 Recensement des systèmes d'informationInventory of information systems

Read-only

Vigicap writes nothing to the tool while reading.

How Vigicap handles your credentials.

Verification

This connector has been run end to end against a real instance of the tool, not merely tested against a mock.