Provider di reputazione
In Amministrazione → Reputation Providers l'amministratore configura APIVoid e AbuseIPDB per il Data Plane selezionato. Questa selezione è distinta dal tenant della barra principale: verifica sempre l'ambito prima di salvare o ripristinare.
Il portale mostra configurazione salvata, versione, origine (env, redis, postgres o sconosciuta), configurazione runtime e metriche. I default effettivi provengono dal Data Plane e dal suo ambiente: non esiste un unico insieme di numeri da copiare su tutte le installazioni.
Aprire il provider corretto
Percorso: Amministrazione → Impostazioni globali → Reputation Providers (/platform/reputation/providers). Seleziona il Data Plane nell'intestazione, individua APIVoid o AbuseIPDB nella tabella e premi Open. Il collegamento del dettaglio conserva il Data Plane scelto.
Servono un Data Plane raggiungibile, i permessi di amministrazione e le credenziali operative necessarie alla lettura/gestione del provider. I parametri di lookup non creano la chiave commerciale APIVoid/AbuseIPDB. Prima di modificarli controlla versione salvata, origine e readiness runtime; se il dettaglio è indisponibile, risolvi prima la lettura.
| Esigenza | Parametro o azione | Conseguenza da considerare |
|---|---|---|
| Fermare i lookup di un provider | Lookup enabled spento | Disabilita le interrogazioni secondo la configurazione runtime; non equivale a rimuovere la chiave. |
| Ridurre richieste ripetute per risultati già noti | TTL della cache pertinente | Un TTL più lungo riusa più a lungo il risultato e ne riduce la freschezza. |
| Limitare il volume di nuove richieste | Rate limit e, per AbuseIPDB, budget giornaliero | I lookup oltre i controlli vengono limitati/saltati: non sono riscontri clean. |
| Separare i contatori dei tenant | Rate limit scope tenant | La finestra di richieste è per tenant; il provider continua a essere gestito sul Data Plane selezionato. |
| Usare un contatore condiviso | Rate limit scope global | Il volume dei tenant concorre allo stesso limite globale del Data Plane. |
| Cambiare il criterio di emissione alert | Sezione Alert threshold | Influenza il trattamento dei riscontri nel motore; non è un'impostazione di frequenza delle richieste. |
| Tornare ai valori dell'ambiente | Reset to Data Plane env | Rimuove l'override secondo il flusso di reset e torna alla configurazione ambientale, che può essere diversa dai valori correnti. |
Parametri comuni
Tutti i conteggi e le durate sotto sono interi.
| Campo | Vincolo | Significato |
|---|---|---|
Lookup enabled (enabled) | Booleano | Abilita le interrogazioni di reputazione. Non imposta la chiave del provider. |
| Timeout ms | 500–10.000 ms | Limite di attesa della singola interrogazione. |
| Clean cache TTL | 60–604.800 secondi | Durata in cache dei risultati classificati clean. |
| Risky cache TTL | 60–604.800 secondi | Durata in cache dei risultati classificati risky. |
| Error cache TTL | 30–3.600 secondi | Durata di cache per gli esiti di errore, per limitare richieste ripetute. |
| Rate limit enabled | Sempre attivo nel form | Il server rifiuta il salvataggio con rate limit disattivo. |
| Rate limit scope | tenant / global | Contatore per tenant oppure condiviso globalmente nel Data Plane. |
| Max requests | Intero almeno 1 | Numero massimo di richieste nella finestra. |
| Window seconds | 60–86.400 secondi | Finestra del rate limit. |
| Fail mode | Fisso skip_lookup, non editabile | Quando il rate limit impedisce la richiesta, il comportamento configurato è saltare il lookup, non ignorare il limite. |
Cache e rate limit hanno funzioni diverse: un cache hit riusa un esito, mentre una richiesta non eseguita per limite non è un risultato “clean”.
APIVoid
| Campo | Vincolo | Significato |
|---|---|---|
| Disable reverse DNS | Booleano | Disabilita il reverse DNS nella configurazione del provider. |
| Min risk score | 0–100 | Soglia di rischio usata per valutare i riscontri APIVoid. |
| Min blacklist detections | 1–100 | Numero minimo di rilevamenti blacklist richiesto dalla configurazione del motore. |
Soglie alert APIVoid
Questa sezione è applicata dal Data Plane ai match APIVoid prima di deduplicazione e consegna.
| Campo | Vincolo | Significato |
|---|---|---|
| Threshold enabled | Booleano | Abilita la politica di soglia sugli alert. |
| Critical min count | Almeno 1 | Conteggio richiesto dal ramo critical nella finestra critical. |
| High min count | Almeno 1 | Conteggio richiesto dal ramo high nella finestra high. |
| Critical window seconds | Almeno 1 secondo | Ampiezza temporale del conteggio critical. |
| High window seconds | Almeno 1 secondo | Ampiezza temporale del conteggio high. |
| Immediate critical risk | 0–100 | Soglia di rischio per il ramo di criticità immediata. |
| Immediate critical detections | Almeno 1 | Soglia di rilevamenti per il ramo immediato. |
AbuseIPDB
AbuseIPDB aggiunge criteri relativi ai report sull'indirizzo IP.
| Campo | Vincolo | Significato |
|---|---|---|
| Max age days | 1–365 giorni | Età massima dei report considerati nella richiesta. |
| Min confidence | 0–100 | Confidenza minima del risultato AbuseIPDB. |
| Min reports | Almeno 0 | Numero minimo di report. |
| Min distinct users | Almeno 0 | Numero minimo di segnalatori distinti. |
| Daily request budget | Facoltativo, almeno 1 | Budget giornaliero configurato. Svuotando il campo viene omesso l'override; non si imposta un budget pari a zero. |
La sezione Alert threshold ha gli stessi campi comuni di APIVoid e aggiunge Immediate critical reports, intero almeno 1. I campi Immediate critical risk e Immediate critical detections mantengono questi nomi anche nel form AbuseIPDB: se assenti nel record, la UI li inizializza rispettivamente a 95 e 5. Sono valori di ripiego del frontend, non una certificazione dei default del Data Plane.
Il contratto conserva anche un eventuale valore storico criticalImmediateMinConfidenceScore; non è un campo autonomo editabile in questa versione della schermata.
Il repository del portale conferma parametri, unità, vincoli e trasmissione della configurazione. L'algoritmo che combina le soglie e produce l'alert risiede nel Data Plane: da questi form non si può dedurre se una particolare combinazione sia applicata in AND o OR. La wiki non attribuisce una formula non verificata al motore.
Salvare, ripristinare e verificare
- Dall'elenco provider scegli il Data Plane, premi Open sulla riga corretta e attendi il caricamento della configurazione salvata.
- Confronta le modifiche desiderate con la tabella dei campi. Controlla le unità: i timeout sono in millisecondi, cache e finestre in secondi, età report AbuseIPDB in giorni.
- Modifica i parametri, quindi Save. La richiesta include
expectedVersion; un conflitto richiede una nuova lettura. - Rileggi il dettaglio e confronta versione salvata e versione runtime, indicatori Configured e Ready, motivo di eventuale fallback e messaggi di validazione.
- Osserva le metriche durante il normale funzionamento per verificare richieste, cache e limitazioni. Non usare il solo aumento dei cache hit come prova che una nuova richiesta esterna sia riuscita.
- Considera conclusa la modifica quando i valori riletti sono quelli attesi e il runtime dichiara uno stato coerente. Se mantiene una configurazione di fallback, risolvi il motivo prima di considerare applicate le nuove soglie.
Un conflitto 409 indica che la configurazione è cambiata nel Data Plane. Il portale ricarica i dati: confrontali prima di salvare di nuovo. Reset to Data Plane env ripristina la configurazione dell'ambiente del Data Plane, con controllo della versione; non significa “disabilita provider” né “ripristina i numeri di questa guida”.
La funzione di provisioning del manage token registra la credenziale di gestione necessaria al collegamento piattaforma/Data Plane. È idempotente: può riportare che il token esiste già. Non coincide con l'acquisto o con la creazione della chiave APIVoid/AbuseIPDB.
Metriche e diagnosi
| Indicatore | Lettura corretta |
|---|---|
| Cache hits / misses | Risultati riusati o non trovati in cache. |
| Requests | Richieste effettive al provider. |
| Matches (APIVoid) | Riscontri classificati come match dal motore. |
| Enrichments / risky enrichments (AbuseIPDB) | Arricchimenti prodotti e relativo sottoinsieme risky. |
| Errors | Errori di interrogazione/elaborazione; non risultati negativi. |
| Rate limited | Richieste limitate dal controllo di frequenza. |
| Bypassed | Lookup saltati. |
| Threshold suppressions (APIVoid) | Riscontri per i quali la soglia ha soppresso l'emissione. |
Unavailable significa che il dettaglio non è disponibile per quel Data Plane: non dimostra l'assenza di reputazione negativa. Se la configurazione è salvata ma il runtime usa un fallback, risolvi il motivo riportato prima di assumere che le nuove soglie siano applicate.
Verifica sorgente: workspace dei due provider, contratti e validazione server platform-reputation.service; snapshot del 10 novembre 2026. Nessun valore di credenziale viene pubblicato.