Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Puoi configurare Apigee Sense in modo che ti invii una notifica con un elenco di richieste API rilevate che potrebbero essere indesiderate. Una volta configurate le notifiche, Apigee Sense invia un report ogni 5 minuti a un URI webhook specificato.
Utilizzando l'URI webhook, Apigee Sense invierà una stringa in formato JSON (è necessario codice che analizza la stringa in formato JSON). Il seguente breve esempio di report è stato formattato da stringa a JSON per migliorarne la leggibilità:
{
"text": {
"metadata": {
"org": "my-org",
"env": "prod",
"reportTimestamp": "2018-10-09T17:25:12Z",
"messageId": "1539105912220"
},
"totalNumberOfBots": 1,
"bots": [
{
"ipAddress": "11.111.111.11",
"botDetectedLast": "2018-10-0917:04:48Z",
"ipIsp": "Their ISP",
"ipCountry": "United States",
"botReason": [
"Flooder",
"Content Robber"
],
"callCount": "274529",
"topUrl": "/v1/my/url",
"ipCity": "Los Angeles"
}
]
}
}
Il report acquisisce le seguenti informazioni sui possibili attacchi indesiderati alle API:
- L'organizzazione e l'ambiente Apigee in cui sono state raccolte le richieste segnalate.
- Il timestamp del report.
- ID del messaggio del report.
- Il numero di indirizzi IP che effettuano richieste che potrebbero essere indesiderate.
Un array di dati client per gli indirizzi IP che effettuano richieste potenzialmente indesiderate (ad esempio i bot). Per ogni cliente, il report include:
Caratteristica del cliente Descrizione ipAddress Indirizzo IP del client. botDetectedLast Timestamp della richiesta più recente da parte del client. ipIsp ISP del client che effettua le richieste. ipCountry Paese da cui hanno avuto origine le richieste del client. botReason Le regole di rilevamento di Apigee Sense a cui le richieste da questo indirizzo IP erano conformi. callCount Numero di richieste da questo indirizzo IP. topUrl L'URL più comune richiesto dall'IP del client. Questa è l'API richiesta dal client. ipCity Città da cui è stata ricevuta la richiesta.
Per configurare le notifiche
- Apri la Nuova esperienza Edge.
- Nella nuova esperienza Edge, fai clic sul menu Analizza e poi su Sense.
- Fai clic sul menu Impostazioni.
Nella pagina Impostazioni, inserisci i valori per configurare le notifiche:
Impostazione Descrizione Notifica Fai clic per attivare o disattivare questa notifica. URI L'URI che desideri venga utilizzato da Apigee Sense per l'invio di notifiche. In genere si tratta di un sistema di monitoraggio che accetta i webhook in arrivo. I report da Apigee Sense verranno inviati a questo URI. Nome chiave API (Facoltativo) Nome chiave che Apigee Sense deve utilizzare durante l'autenticazione con il tuo sistema. Utilizza una chiave API per migliorare la sicurezza. Valore della chiave API (Facoltativo) Valore chiave che Apigee Sense deve utilizzare durante l'autenticazione con il sistema. Utilizza una chiave API per migliorare la sicurezza. Numero massimo di IP Numero massimo (da 1 a 300) di indirizzi IP client da includere nel report. Apigee Sense includerà gli indirizzi IP in ordine di numero di richieste sospette, dal maggior numero di richieste alla meno recente, fino al numero di IP specificati qui.