Ricevere notifiche da Sense

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Puoi configurare Apigee Sense per ricevere una notifica con un elenco di richieste API rilevate che potrebbero essere indesiderate. Dopo aver configurato le notifiche, Apigee Sense invia un report ogni 5 minuti all'URI webhook da te specificato.

Utilizzando l'URI webhook, Apigee Sense invierà una stringa in formato JSON (avrai bisogno di codice che analizza la stringa in formato JSON). Il seguente breve esempio di report è stato formattato da stringa a JSON per una migliore 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 contiene le seguenti informazioni su 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 di segnalazione.
• Il numero di indirizzi IP che effettuano richieste indesiderate.

• Un array di dati client per gli indirizzi IP che effettuano richieste potenzialmente indesiderate (ad esempio i bot). Per ciascun cliente, il report include:

  Caratteristiche del cliente	Descrizione
  ipAddress	Indirizzo IP del client.
  botDetectedLast	Timestamp della richiesta più recente 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 sono conformi le richieste provenienti da questo indirizzo IP.
  callCount	Numero di richieste da questo indirizzo IP.
  topUrl	L'URL più comune richiesto dall'IP client. Questa è l'API richiesta dal client.
  ipCity	Città da cui è stata ricevuta la richiesta.

Configurare le notifiche

1. Apri la nuova esperienza Edge.
2. Nella nuova esperienza Edge, fai clic sul menu Analizza, quindi su Sense.
3. Fai clic sul menu Impostazioni.

4. 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 vuoi che Apigee Sense utilizzi per inviare le notifiche. Si tratta in genere di un sistema di monitoraggio che accetta i webhook in arrivo. I report di Apigee Sense verranno inviati a questo URI.
   Nome chiave API	Campo facoltativo. Nome della chiave che Apigee Sense deve utilizzare durante l'autenticazione con il tuo sistema. Utilizza una chiave API per migliorare la sicurezza.
   Valore chiave API	Campo facoltativo. Valore chiave che Apigee Sense deve utilizzare durante l'autenticazione sul tuo 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 al minimo, fino al numero di IP specificato qui.