Skip to main content
Back to the connector catalogue

Connector

OPNsense / pfSense

API credential, entered client by client.

Self-hosted, open-source firewall (official OPNsense API — pfSense instances share the same family of use but are not supported by this connector). Vigicap reads the number of configured filtering rules to evaluate the ReCyF objective « Cloisonnement et sécurité réseau » — a non-trivial rule set attests that filtering exists, but the quality of the segmentation (VLANs, security zones) cannot be automatically verified.

01

What to create in the tool

The access is created in OPNsense / pfSense, not in Vigicap.

Where to generate it

In OPNsense: System > Access > Users > select (or create) a dedicated user > "API keys" section > click + to generate a key/secret pair. The secret is shown only once (downloaded file) — copy it immediately.

Minimum role

Un utilisateur dédié, sans accès shell, porteur des deux seuls privilèges « System: Firmware » (page-system-firmware-manualupdate) et « Firewall: Rules [new] » (page-filter-api). Les ACL d'OPNsense portent sur des motifs d'URL entiers et non sur la méthode HTTP : ces deux privilèges autorisent donc aussi la mise à jour du firmware et la modification des règles de filtrage.

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

02

What to enter in Vigicap

  • API keysecret

    System > Access > Users > your user > API keys > +.

    Clé API OPNsense

  • API secretsecret

    Secret paired with the API key, generated and shown at the same time (once only).

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.

  • 8.20 Networks security
  • 8.21 Security of network services
  • 8.22 Segregation of networks

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.

  • #7 Sécurisation de l'architecture des systèmes d'informationSecuring the architecture of the information systems

Read-only

Vigicap writes nothing to the tool while reading.

How Vigicap handles your credentials.

Verification

This connector was written from the vendor's documented API and has not yet been run against a real instance.