이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Sense에서 알림 받기

Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보

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

Webhook 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 조직 및 환경입니다.
보고서의 타임스탬프입니다.
신고 메시지의 ID입니다.
원치 않는 요청을 하는 IP 주소 수입니다.

원치 않는 요청을 할 수 있는 IP 주소 (예: 봇)의 클라이언트 데이터 배열입니다. 각 고객의 보고서에는 다음이 포함됩니다.

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

알림을 설정하려면 다음 단계를 따르세요.

새로운 Edge 환경을 엽니다.
새 Edge 환경에서 분석 메뉴를 클릭한 다음 감지를 클릭합니다.
설정 메뉴를 클릭합니다.

설정 페이지에서 알림을 구성할 값을 입력합니다.

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