VigicapConnettore
Have I Been Pwned
Credenziale API, inserita cliente per cliente.
Servizio pubblico che censisce le violazioni di dati. Vigicap interroga il dominio del cliente e legge quante indirizzi compaiono in violazioni note e in quanti incidenti distinti — mai le password, che questa API non espone. Questo connettore non propone alcun livello ReCyF: una violazione misura un'esposizione passata, non un controllo in essere. Il dominio deve essere verificato sull'account HIBP e l'abbonamento deve coprire la ricerca per dominio.
01
Che cosa creare nello strumento
L'accesso si crea in Have I Been Pwned, non in Vigicap. Vigicap non chiede mai la password di un amministratore: si aspetta una credenziale API che create voi, che vedete voi e che potete revocare senza di noi.
Dove generarla
Créez une clé sur https://haveibeenpwned.com/API/Key avec un abonnement couvrant la recherche par domaine, puis vérifiez le domaine du client dans le tableau de bord HIBP (Domain search). Sans cette vérification, l'API répond 403 même avec une clé valide.
Ruolo minimo
Une clé d'API Have I Been Pwned avec un abonnement permettant la recherche par domaine, et le domaine du client vérifié dans le tableau de bord HIBP. La clé ne donne accès qu'aux domaines vérifiés sur le compte qui la détient : elle ne peut pas interroger un domaine tiers.
Ripresa dal modello di ruoli del fornitore e verificata prima della pubblicazione.
02
Che cosa inserire in Vigicap
I campi esatti del modulo di connessione, nell'ordine in cui compaiono. I valori contrassegnati come «segreto» non tornano mai al browser: sono cifrati a riposo ed eliminati alla disconnessione.
Il modulo comincia dall'indirizzo dell'istanza, inserito separatamente dai campi qui sotto. Il catalogo pubblico non pubblica ancora se questo connettore ne richieda uno né che aspetto abbia — questo elenco è quindi esatto su tutto il resto e muto su quel primo campo.
- Clé d'API HIBPsegreto
Souscrite sur haveibeenpwned.com/API/Key, avec la recherche par domaine.
- Domaine du client
Doit être vérifié sur le compte HIBP qui détient la clé.
exemple.fr
03
Instradamento per cliente
La connessione si fa cliente per cliente: una credenziale per cliente, inserita nella scheda di quel cliente. Nulla è condiviso fra due clienti, e disconnetterne uno lascia l'altro intatto.
04
Che cosa fa e che cosa non fa
Obiettivi ReCyF precompilati
Questo connettore non alimenta alcun obiettivo ReCyF, e non è una lacuna: non misura la postura di un cliente.
Sola lettura
Le letture sono di sola lettura: leggendo, Vigicap non scrive nulla nello strumento.
Che cosa viene letto, che cosa viene conservato, per quanto tempo e con quali diritti: lo stesso registro, connettore per connettore, nell'inventario dei dati.
Verifica
L'API è pubblica e documentata, ma è raggiungibile solo con un abbonamento a pagamento per cui il fornitore non rilascia alcuna versione di prova: non esiste un'istanza che possiamo ottenere per eseguirlo. Non è un «non ancora fatto» — servirebbe un cliente che ci presti il proprio tenant.
I marchi e i loghi citati appartengono ai rispettivi titolari e identificano gli strumenti con cui Vigicap è compatibile — vedere le note legali.