<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동 정보
원치 않을 수 있는 감지된 API 요청 목록을 알림으로 받을 수 있도록 Apigee Sense를 구성할 수 있습니다. 알림을 설정하면 Apigee Sense에서 5분마다 보고서를 지정한 웹훅 URI로 전송합니다.
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입니다. 일반적으로 수신되는 웹훅을 허용하는 모니터링 시스템입니다. Apigee Sense의 보고서가 이 URI로 전송됩니다. API 키 이름 선택사항입니다. 시스템으로 인증할 때 Apigee Sense에서 사용할 키 이름입니다. API 키를 사용하여 보안을 강화하세요. API 키 값 선택사항입니다. 시스템으로 인증할 때 Apigee Sense에서 사용해야 하는 키 값입니다. API 키를 사용하여 보안을 강화하세요. 최대 IP 수 보고서에 포함할 최대 클라이언트 IP 주소 수 (1~300)입니다. Apigee Sense는 의심스러운 요청 수가 가장 많은 IP 주소부터 가장 적은 IP 주소까지 여기에서 지정한 IP 주소 수까지 IP 주소를 포함합니다.