getWAFList

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

개요

getWAFList API 는 "Security Monitoring"의 "WAF"에서 제공하는 기능으로 WAF 보안 이벤트를 확인할 수 있습니다.
해당 API는 네이버 클라우드 플랫폼에서 사용하는 IAM인증 및 API Gateway를 통해 사용하실 수 있습니다.

요청

Platform	Method	Request URI
Classic	POST	`https://securitymonitoring.apigw.gov-ntruss.com/securitymonitoring/v1/`
VPC	POST	`https://securitymonitoring.apigw.gov-ntruss.com/vsecuritymonitoring/v1/`

요청 헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-iam-access-key	NCP에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2	요청 경로 및 헤더를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명으로 HMAC 암호화 알고리즘은 HmacSHA256 사용 IAM 인증이 필요한 API 호출하기 참조 바람
Content-type	`application/json` 지정

요청 파라미터

파라미터명	필수 여부	타입	설명
startDateTime	Yes	long	이벤트 조회 시작 시간 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것. ex) 1646628240000
endDateTime	Yes	long	이벤트 조회 종료 시간 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것. ex) 1646628240000
page	Yes	int	페이지
countPerPage	Yes	int	페이지당 노출갯수
order	No	string	이벤트 탐지 시간 기준 정렬(asc, desc) 기본값 : desc
regionCode	No	string	리전 코드 (`KR`)
zoneName	No	string	Zone(KR-1)
attackType	No	string	공격유형
eventNm	No	string	탐지이벤트
attackIp	No	string	공격자IP
targetIp	No	string	타겟IP

응답

응답 바디

필드명	타입	설명
returnCode	string	요청에 대한 처리 결과 코드
returnMessage	string	요청에 대한 처리 결과 메시지
wafTotalCount	int	getWAFList 총 개수
page	int	요청 페이지 번호
wafDataList	array	WAF 이벤트 목록
wafDataList[].ticketId	string	WAF 이벤트 번호
wafDataList[].date	String	탐지날짜입니다.
wafDataList[].product	string	상품분류 classic : `WAF`
wafDataList[].eventNm	string	이벤트명
wafDataList[].attackType	string	공격유형
wafDataList[].attackerIp	string	공격IP
wafDataList[].attackerPort	string	공격Poert
wafDataList[].targetIp	string	타겟IP
wafDataList[].targetPort	string	타겟Port
wafDataList[].region	string	리전
wafDataList[].zoneName	string	Zone(KR-1)
wafDataList[].vpcName	string	vpc name
wafDataList[].platForm	string	Platform Info

예시

요청 예시

curl -X POST "https://securitymonitoring.apigw.gov-ntruss.com/securitymonitoring/v1/getWAFList"
   -H "accept: application/json"
   -H "Content-type: application/json"
   -H "x-ncp-apigw-api-key: {x-ncp-apigw-api-key}"
   -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"
   -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}"
   -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
   -d {"startDateTime": {startDateTime},
         "endDateTime": {endDateTime},
         "page": {page},
         "countPerPage": {countPerPage}
         }

응답 예시

{
  "returnCode": "0",
  "returnMessage": "SUCCESS",
  "totalRows": 9,
  "page": 1,
  "wafDataList": [
    {
        "ticketId": "1",
        "date": "1600203495000",
        "product": "WAF",
        "eventNm": "WAF_TEST",
        "attackType": "WAF 테스트",
        "attackerIp": "10.33.7.6",
        "attackerPort": "4443",
        "targetIp": "10.10.10.10",
        "targetPort": "8080",
        "region": "Korea",
        "zoneName": "KR-1",
        "platForm": "CLASSIC",
        "vpcName": ""
    }
  ]
}

이 문서가 도움이 되었습니까?

What's Next

getAVList

개요
요청
응답
예시

태그

Security Monitoring