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.