Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
É possível configurar o Apigee Sense para notificar você com uma lista de solicitações de API detectadas que podem ser indesejadas. Depois de configurar as notificações, o Apigee Sense envia um relatório a cada cinco minutos para o URI do webhook especificado.
Usando o URI do webhook, o Apigee Sense enviará uma string no formato JSON. Você vai precisar do código que analise a string para JSON. O exemplo abaixo de um relatório foi formatado de string para JSON para facilitar a leitura:
{
"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"
}
]
}
}
O relatório inclui as seguintes informações sobre possíveis ataques indesejados às APIs:
- A organização e o ambiente da Apigee em que as solicitações informadas foram coletadas.
- O carimbo de data/hora do relatório.
- ID da mensagem de denúncia.
- O número de endereços IP que fazem solicitações indesejadas.
Uma matriz dos dados de clientes para os endereços IP que fazem solicitações possivelmente indesejadas (como bots). Para cada cliente, o relatório inclui:
Característica do cliente Descrição ipAddress Endereço IP do cliente. botDetectedLast Carimbo de data/hora da solicitação mais recente do cliente. ipIsp ISP do cliente que faz solicitações. ipCountry País de origem das solicitações do cliente. botReason As regras de detecção do Apigee Sense com que as solicitações desse endereço IP estão em conformidade. callCount Número de solicitações deste endereço IP. topUrl O URL mais comum solicitado pelo IP do cliente. Essa é a API solicitada pelo cliente. ipCity Cidade em que a solicitação foi recebida.
Para configurar notificações
- Abra a nova experiência do Edge.
- Na nova experiência do Edge, clique no menu Analyze e em Sense.
- Clique no menu Configurações.
Na página Configurações, insira os valores para configurar as notificações:
Configuração Descrição Notificação Clique para ativar ou desativar a notificação. URI O URI que você quer que o Apigee Sense use ao enviar notificações. Normalmente, é um sistema de monitoramento que aceita webhooks de entrada. Os relatórios do Apigee Sense serão enviados para este URI. Nome da chave de API Opcional. Nome da chave que o Apigee Sense deve usar para autenticar com seu sistema. Use uma chave de API para melhorar a segurança. Valor da chave de API Opcional. A chave-valor que o Apigee Sense deve usar para autenticar com seu sistema. Use uma chave de API para melhorar a segurança. Número máximo de IPs Número máximo (de 1 a 300) de endereços IP de clientes a serem incluídos no relatório. O Apigee Sense inclui os endereços IP em ordem de número de solicitações suspeitas, do maior ao menor, até o número de IPs especificados aqui.