Ricevere notifiche da Sense

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

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 un codice che analizzi la stringa in 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 su possibili attacchi indesiderati alle tue 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 inviano richieste potenzialmente indesiderate.

• Un array di dati del 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 del cliente.
  ipIsp	ISP del client che invia 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:

1. Apri la nuova esperienza Edge.
2. Nella nuova esperienza Edge, fai clic sul menu Analizza e poi 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 l'invio delle notifiche. In genere si tratta di un sistema di monitoraggio che accetta webhook in entrata. I report di Apigee Sense verranno inviati a questo URI.
   Nome chiave API	Facoltativo. Nome della chiave che Apigee Sense deve utilizzare per l'autenticazione con il tuo sistema. Utilizza una chiave API per migliorare la sicurezza.
   Valore chiave API	Facoltativo. Valore della chiave che Apigee Sense deve utilizzare per l'autenticazione con il 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 numero più elevato di richieste a quello più basso, fino al numero di IP specificati qui.