Получение уведомлений от Sense

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Вы можете настроить Apigee Sense, чтобы он уведомлял вас списком обнаруженных запросов API, которые могут быть нежелательными. После настройки уведомлений Apigee Sense отправляет отчет каждые 5 минут на указанный вами URI веб-перехватчика.

Используя URI веб-перехватчика, Apigee Sense отправит строку в форме JSON (вам понадобится код, который анализирует строку в JSON). Следующий краткий пример отчета был отформатирован из строки в JSON для удобства чтения:

{
    "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"
            }
        ]
    }
}

В отчете содержится следующая информация о возможных нежелательных атаках на ваши API:

• Были собраны организация и среда Apigee, куда были отправлены запросы.
• Временная метка отчета.
• Идентификатор сообщения отчета.
• Количество IP-адресов, отправляющих запросы, которые могут быть нежелательными.

• Массив клиентских данных для IP-адресов, отправляющих потенциально нежелательные запросы (например, от ботов). По каждому клиенту отчет включает в себя:

  Характеристика клиента	Описание
  IP-адрес	IP-адрес клиента.
  botDetectedLast	Временная метка последнего запроса от клиента.
  ipIsp	Интернет-провайдер клиента, делающего запросы.
  ipCountry	Страна, откуда поступили запросы от клиента.
  botReason	Правила обнаружения Apigee Sense, которым соответствовали запросы с этого IP-адреса.
  вызовCount	Количество запросов с этого IP-адреса.
  топурл	Наиболее распространенный URL-адрес, запрашиваемый IP-адресом клиента. Это API, запрошенный клиентом.
  ipCity	Город, из которого поступил запрос.

Чтобы настроить уведомления

1. Откройте интерфейс New Edge .
2. В интерфейсе New Edge щелкните меню «Анализ» , затем нажмите «Ощутить» .
3. Нажмите меню «Настройки» .

4. На странице настроек введите значения для настройки уведомлений:

   Параметр	Описание
   Уведомление	Нажмите, чтобы включить или отключить это уведомление.
   URI	URI, который вы хотите использовать Apigee Sense при отправке уведомлений. Обычно это система мониторинга, которая принимает входящие веб-перехватчики. Отчеты Apigee Sense будут отправляться на этот URI.
   Имя ключа API	Необязательный. Имя ключа, которое Apigee Sense следует использовать при аутентификации в вашей системе. Используйте ключ API для повышения безопасности.
   Значение ключа API	Необязательный. Значение ключа, которое Apigee Sense следует использовать при аутентификации в вашей системе. Используйте ключ API для повышения безопасности.
   Максимальное количество IP-адресов	Максимальное количество (от 1 до 300) IP-адресов клиентов, которые будут включены в отчет. Apigee Sense будет включать IP-адреса в порядке количества подозрительных запросов, от наибольшего количества запросов к наименьшему, вплоть до количества IP-адресов, указанного вами здесь.