Questa pagina è stata tradotta dall'API Cloud Translation.

Report sulla sicurezza

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

La visualizzazione Report sulla sicurezza ti consente di creare report per identificare le minacce alla sicurezza delle tue API. Per generare report, Apigee analizza i dati sul traffico delle API in un intervallo di tempo specificato e cerca pattern di traffico insoliti che potrebbero essere causati da agenti dannosi. Apigee visualizza quindi un report che mostra tutte le attività sospette. Utilizzando queste informazioni, puoi intervenire per bloccare gli attacchi alle tue API.

Puoi creare report sulla sicurezza nell'interfaccia utente di Apigee, come descritto di seguito, o utilizzando l'API Security Reports. Se utilizzi l'interfaccia utente, i dati per i report sono limitati all'ambiente scelto. Tuttavia, utilizzando l'API, puoi anche creare report per gruppi di ambienti.

Vedi Ruoli richiesti per i report sulla sicurezza per i ruoli necessari a eseguire attività relative ai report sulla sicurezza.

Per utilizzare questa funzionalità, devi attivare il componente aggiuntivo. Se sei un cliente Subscription, puoi attivare per la tua organizzazione. Per ulteriori dettagli, consulta Gestire la sicurezza avanzata dell'API per le organizzazioni con abbonamento. Se sei un cliente con pagamento a consumo, puoi attivare il componente aggiuntivo nei tuoi ambienti idonei. Per saperne di più, vedi Gestire il componente aggiuntivo Sicurezza API avanzata.

Rilevamento bot

Una delle più gravi minacce alla sicurezza delle API deriva bot: automatizzati script che inviano richieste dannose alle API. Ricerche di Advanced API Security per modelli di traffico API specifici, regole di rilevamento, che si basano sull'analisi di dati reali delle API per rilevare i bot.

Ritardo dei dati dei report sulla sicurezza

I dati che fluiscono nella pipeline di Apigee Analytics presentano un ritardo medio di 15-20 minuti. Il risultato è un report di sicurezza in cui l'ora di fine risale a meno di 20 minuti prima della data corrente potrebbe restituire risultati errati.

Apri la visualizzazione Report sulla sicurezza

Per aprire la visualizzazione Report sulla sicurezza:

Se utilizzi la UI di Apigee nella console Cloud: seleziona Sicurezza avanzata delle API > Report sulla sicurezza
Se utilizzi la UI Apigee classica: seleziona Analizza > Sicurezza API > Report sulla sicurezza. I nomi e il comportamento delle colonne possono variare nella UI classica di Apigee rispetto a quella della console Cloud.

Viene visualizzata la visualizzazione principale dei report sulla sicurezza:

Finestra principale dei report sulla sicurezza.

Nella parte superiore della pagina puoi selezionare:

L'ambiente in cui vuoi creare un report.
Il filtro Tipo di report. Le opzioni sono:
- Tutti
- Attivo
- Non riuscito
- Scaduto

Sotto queste opzioni, i report sulla sicurezza sono visualizzati nelle righe di una tabella. Ogni riga mostra i seguenti dettagli del report:

Il Nome del report. Fai clic sul nome del report per visualizzarlo.
Il report Stato, che può essere uno dei seguenti:
- In esecuzione: il report è attualmente in esecuzione e non può ancora essere visualizzato.
- completed: il report è stato completato e può essere visualizzato o esportato.
- scaduto: il report è scaduto e non può più essere visualizzato o esportato nell'interfaccia utente. Per visualizzare un report dopo la data di scadenza, devi esportarlo prima di questa data. Dopo 30 giorni, il report viene rimosso dall'elenco dei report disponibili.
Ora di inizio e Ora di fine mostrano le date e le ore di inizio e di fine del report.
Data di invio: la data e l'ora in cui la richiesta di segnalazione è stata inviata.
Data e ora di scadenza: la data e l'ora in cui il report scade e non può più essere visualizzato nell'interfaccia utente di Apigee. La data di scadenza è 7 giorni dopo la creazione del report. Dopo 30 giorni, il report viene rimosso dall'elenco dei report disponibili. Non puoi visualizzare o esportare i report nell'interfaccia utente dopo la data di scadenza.
Dimensioni file: le dimensioni del file del report. Potrebbe essere necessario modificare i criteri del report per per creare un report con dimensioni inferiori a quelle massime. Consulta Limitazioni dei report sulla sicurezza per informazioni sulle dimensioni massime dei file e su metodi specifici per ridurle.
Esporta: esporta/scarica il report in un file ZIP. L'esportazione è disponibile solo se lo stato del report è Completato.

Crea un nuovo report sulla sicurezza

Per creare un nuovo report sulla sicurezza, inizia facendo clic su +Crea nella visualizzazione Report sulla sicurezza. Viene visualizzata la finestra di dialogo Crea job di generazione di report sulla sicurezza, in cui puoi configurare le opzioni per il report come descritto nella sezione successiva.

Opzioni del report sulla sicurezza

Per un report sulla sicurezza puoi specificare le seguenti opzioni:

Nome report:il nome del report.
Intervallo di date del report:ora di inizio e ora di fine del report.
Nota: l'ora di inizio e l'ora di fine del report devono essere nel passato e, al massimo, uno l'anno passato in cui è stato creato il report.

Metriche: metrica per il report. Puoi scegliere tra le seguenti metriche e funzioni di aggregazione, ovvero funzioni che calcolano le statistiche per le metriche.

Metrica	Descrizione	Funzioni di aggregazione
bot	Il numero di indirizzi IP distinti per i bot rilevati in intervalli di un minuto.	count_distinct
bot_traffic	Il numero di messaggi provenienti dagli indirizzi IP dei bot rilevati in intervalli di un minuto.	sum
message_count	Numero totale di chiamate API elaborate da Apigee in intervalli di un minuto. Nota: message_count non può essere utilizzato con altre metriche o con la dimensione bot_reason nello stesso report.	sum
response_size	Dimensioni del payload della risposta restituito in byte.	somma, media, min, max

Dimensioni: le dimensioni ti consentono di raggruppare i valori delle metriche in base a sottoinsiemi di dati. La tabella seguente descrive le dimensioni specifiche per i report Sicurezza API avanzata.

Dimensioni	Descrizione
`bot_reason`
`incident_id` (anteprima)
`security_action` (anteprima)	Il tipo di azione di sicurezza. I valori possibili sono ALLOW, DENY e FLAG.
`security_action_name`	Il nome dell'azione di sicurezza.
`security_action_headers`	Intestazioni allegate a una richiesta di azione ALLOW.

Nota:la dimensione bot_reason specifica dell'API Advanced Sicurezza: può essere una qualsiasi combinazione dei singoli regole di rilevamento. Quando viene rilevato un bot, bot_reason è costituito dal sottoinsieme delle singole regole di rilevamento a cui corrispondeva il traffico del bot quando è stato rilevato.

Nota: bot_reason e incident_id funzionano solo con le seguenti metriche:

bot
bot_traffic
response_size

Consulta dimensioni per conoscere le altre dimensioni supportate dai report Sicurezza API avanzata.

Per aggiungere più dimensioni, è sufficiente fare clic su + Aggiungi una dimensione per ogni dimensione. che vuoi aggiungere. Puoi anche modificare l'ordine in cui le dimensioni vengono visualizzate nel report facendo clic sulle frecce su o giù a destra del campo della dimensione.

Filtri: i filtri ti consentono di limitare i risultati alle metriche con valori specifici. Per creare un filtro, imposta i seguenti campi:
- Seleziona un nome per il filtro.
- Seleziona un operatore di confronto.
- Seleziona un valore.
Consulta la sezione Filtri.

Dopo aver selezionato tutte le opzioni del report, fai clic su Crea per creare il job di report.

Visualizzare un report completato

Una volta completato, il report viene visualizzato nella tabella come mostrato di seguito:

Report sulla sicurezza visualizzato nella tabella.

Per visualizzare il report:

Fai clic sul nome del report.
Fai clic su Esporta nella riga del report in questione.

Nota: il rilevamento dei bot ha un ritardo di elaborazione di circa 15-20 minuti su media.

Esempio: report sugli indirizzi IP dei bot

L'esempio seguente crea un report che mostra gli indirizzi IP dei bot rilevati. Per creare il report, utilizza la seguente configurazione:

Metrica: bot, il numero di indirizzi IP distinti identificati come origini di bot.
Funzione di aggregazione: count_distinct
Dimensione: IP client risolto

Di seguito è riportato il report completo:

Report sugli indirizzi IP del bot del report sulla sicurezza

Tieni presente che nella tabella in fondo al report sono elencati gli indirizzi IP di cui Advanced API Security identificati come bot.

Esempio: report sul traffico dei bot per motivo del bot

L'esempio seguente crea un report sul traffico dei bot, ovvero il numero di richieste provenienti da indirizzi IP identificati come origini dei bot, in base a bot_reason, l'insieme di regole di rilevamento che hanno portato al rilevamento del bot. Per creare il report: utilizza la seguente configurazione:

Metrica: bot_traffic
Funzione di aggregazione: somma
Dimensione: bot_reason

Di seguito è riportato il report completo:

$Report sulla sicurezza: traffico dei bot per motivo del bot \report$

Ogni bot_reason è costituito da un sottoinsieme delle singole regole di rilevamento. Come puoi vedere nel grafico, la regola di rilevamento che ha contribuito alla maggior parte del traffico di bot è il seguente insieme di regole:

Inondazione
Brute Guessor
Abusatore di robot

Esempio: report sul traffico di bot

L'esempio seguente crea un report non raggruppato in base a una dimensione. Se non vuoi raggruppare i dati in base a una dimensione, puoi impostare Dimensione su ambiente. Poiché i dati sono sempre limitati all'ambiente selezionato, il risultato sarà un report con nessun raggruppamento di dati.

Metrica: traffico di bot
Funzione di aggregazione: somma
Dimensione: ambiente

Report sulla sicurezza del traffico di bot

Il report mostra il traffico totale proveniente dagli indirizzi IP identificati come da fonti di bot, per ogni intervallo di un minuto nell'intervallo di tempo del report. Nota che non ci sia alcun raggruppamento.

Altri esempi di report sulla sicurezza

La tabella seguente elenca alcuni esempi di sicurezza dei report che puoi creare utilizzando metriche e dimensioni diverse:

Report	Metriche	Dimensioni
Report sul traffico e sul conteggio dei bot per ambiente	bot, bot_traffic	ambiente
Traffico generato da bot e Report sul conteggio dei bot per diversi motivi	bot, bot_traffic	bot_reason
Traffico generato da bot e Report sul numero di bot per paesi diversi	bot, bot_traffic	ax_geo_country
Traffico generato da bot e Report sul conteggio dei bot per ISP diversi	bot, bot_traffic	ax_isp
Report sul rilevamento dei bot (Visualizzazione elenco dettagliata)	bot_traffic	IP client risolto, ax_isp, bot_reason, request_uri, client_id
Traffico di bot per token di accesso	bot_traffic	access_token
Traffico di bot per proxy API	bot_traffic	apiproxy
Traffico di bot per famiglia di agenti	bot_traffic	ax_ua_agent_family
Traffico di bot per user agent	bot_traffic	useragent
Traffico bot per tipo di agente	bot_traffic	ax_ua_agent_type
Traffico generato dai bot per categoria dispositivo	bot_traffic	ax_ua_device_category
Traffico di bot per famiglia di sistemi operativi	bot_traffic	ax_ua_os_family
Traffico di bot per ID cliente	bot_traffic	client_id
Traffico bot per Basepath proxy	bot_traffic	proxy_basepath
Traffico bot per suffisso percorso proxy	bot_traffic	proxy_pathsuffix
Traffico di bot per URI richiesta	bot_traffic	request_uri
Traffico dei bot per verbo di richiesta	bot_traffic	request_verb
Traffico dei bot per codice di stato della risposta	bot_traffic	response_status_code

Limitazioni dei report di sicurezza

I report sulla sicurezza presentano i seguenti limiti:

I dati che fluiscono nella pipeline di Apigee Analytics presentano un ritardo medio di massimo 15-20 minuti. Di conseguenza, la creazione di un report in cui l'ora di fine risalga a meno di 20 minuti fa potrebbe restituire risultati errati.
L'intervallo di tempo massimo per i report sui bot è di un anno.
Il numero massimo di metriche che puoi utilizzare in un report è 25 e il numero massimo di dimensioni è 25.
Come per l'API dei report personalizzati asincroni, esiste un limite di 31 MB di dati per un report. Se un report supera il limite di dimensioni, puoi:
- Riduci l'intervallo di tempo del report.
- Suddividi i dati in sottoinsiemi più piccoli applicando un filtro a un insieme di valori, quindi crea più report, uno per ogni sottoinsieme.
La dimensione IP client risolto non può essere elencata nello stesso report con la dimensione ax_geo_city o ax_geo_country, per motivi di privacy.
Le seguenti metriche sono disponibili solo tramite l'API Security Reports, ma non nell'interfaccia utente: bot_first_detected (min) e bot_last_detected (max).