Sense에서 알림 받기

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

Apigee Sense를 구성하여 원치 않을 수 있는 감지된 API 요청의 목록을 알릴 수 있습니다. 알림을 설정하면 Apigee Sense는 지정한 웹훅 URI로 5분마다 보고서를 전송합니다.

Apigee Sense는 웹훅 URI를 사용하여 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 조직 및 환경입니다.
  • 보고서의 타임스탬프입니다.
  • 신고 메시지의 ID입니다.
  • 원치 않는 요청을 하는 IP 주소의 수입니다.
  • 잠재적으로 원치 않는 요청을 보내는 IP 주소의 클라이언트 데이터 배열 (예: 봇). 각 고객에 대해 보고서에는 다음 항목이 포함됩니다.

    고객 특성 설명
    ipAddress 클라이언트의 IP 주소입니다.
    botDetectedLast 클라이언트의 가장 최근 요청의 타임스탬프입니다.
    ipIsp 요청을 실행하는 클라이언트의 ISP.
    ipCountry 클라이언트의 요청이 발생한 국가입니다.
    botReason 이 IP 주소의 요청이 준수하는 Apigee Sense 감지 규칙입니다.
    callCount 이 IP 주소의 요청 수입니다.
    topUrl 클라이언트 IP에서 요청한 가장 일반적인 URL입니다. 클라이언트가 요청한 API입니다.
    ipCity 요청을 받은 도시입니다.

알림 설정하기

  1. New Edge 환경을 엽니다.
  2. New Edge 환경에서 분석 메뉴를 클릭한 다음 Sense를 클릭합니다.
  3. 설정 메뉴를 클릭합니다.
  4. 설정 페이지에서 알림을 구성할 값을 입력합니다.

    설정 설명
    알림 이 알림을 사용하거나 사용 중지하려면 클릭하세요.
    URI 알림을 보낼 때 Apigee Sense에서 사용할 URI입니다. 이는 일반적으로 수신 웹훅을 허용하는 모니터링 시스템입니다. Apigee Sense의 보고서가 이 URI로 전송됩니다.
    API 키 이름 선택사항입니다. 시스템에서 인증할 때 Apigee Sense에서 사용할 키 이름입니다. API 키를 사용하여 보안을 강화하세요.
    API 키 값 선택사항입니다. 시스템으로 인증할 때 Apigee Sense에서 사용해야 하는 키-값입니다. API 키를 사용하여 보안을 강화하세요.
    최대 IP 수 보고서에 포함할 클라이언트 IP 주소의 최대 개수 (1~300개)입니다. Apigee Sense에는 의심스러운 요청 수부터 요청 수부터 낮은 수까지, 여기에서 지정한 IP 수까지 순서대로 IP 주소가 포함됩니다.