Skip to main content
Back to the connector catalogue

Connector

Pi-hole

API credential, entered client by client.

Self-hosted network DNS blocker (Pi-hole v6), used by MSPs to filter advertising/malicious domains at the client's network level. Vigicap reads the size of the blocklist (gravity) and the volume of filtered DNS queries to evaluate the ReCyF objective « Sécurisation de la messagerie et du web (filtrage DNS) ». This connector only covers DNS filtering of web traffic, not e-mail security, which caps the automatic proposal at level 3.

01

What to create in the tool

The access is created in Pi-hole, not in Vigicap.

Where to generate it

In Pi-hole (v6 only — the v5 ?auth= token API is not compatible): Settings > API (or Web interface / API depending on the version), "App password" section — generate it and copy it immediately, it is shown only once.

Minimum role

The minimum role this connector needs is not documented to date. We would rather write that than guess it: an unverified claim about access rights ends up in front of a client's data protection officer, who is precisely the person who will check it. Refer to the vendor's documentation, which alone is authoritative on its role model.

02

What to enter in Vigicap

  • App passwordsecret

    Settings > API > App password — dedicated to the API, distinct from the full web password.

    Mot de passe d'application Pi-hole

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.14 Information transfer
  • 8.7 Protection against malware
  • 8.23 Web filtering

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.

  • #9 Protection des systèmes d'information contre les codes malveillantsProtection of the information systems against malicious code

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.