Уведомления от Sense

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

Вы можете настроить Apigee Sense так, чтобы получать уведомления со списком обнаруженных запросов API, которые могут быть нежелательными. После настройки уведомлений Apigee Sense будет отправлять отчет каждые пять минут на указанный вами 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-адресов, отправляющих потенциально нежелательные запросы (например, ботов). Для каждого клиента в отчете указаны:

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

Как настроить уведомления

1. Откройте новый интерфейс Edge.
2. В новом интерфейсе Edge нажмите на меню Анализ, а затем выберите Sense.
3. Нажмите на меню Настройки.

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

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