Apigee Edge 문서를 보고 있습니다.
Go to the
Apigee X 문서로 이동합니다. info
Apigee Sense를 구성하여 원치 않는 것으로 감지된 API 요청 목록을 알리도록 할 수 있습니다. 알림을 설정하면 Apigee Sense에서 지정한 웹훅 URI로 5분마다 보고서를 보냅니다.
웹훅 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 환경에서 분석 메뉴를 클릭한 후 Sense 를 클릭합니다.
- 설정 메뉴를 클릭합니다.
설정 페이지에서 값을 입력하여 알림을 구성합니다.
설정 설명 알림 이 알림을 사용 설정 또는 사용 중지하려면 클릭합니다. 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 수만큼 포함합니다.