getIPSList

인쇄
공유
PDF

기사 요약

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

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

개요

getIPSList API 는 "Security Monitoring"의 "IPS"에서 제공하는 기능으로 IPS 보안 목록을 이벤트를 확인할 수 있습니다.
해당 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) default value : desc
regionCode	No	string	리전 코드(`KR`)
zoneName	No	string	Zone(KR-1)
eventNm	No	string	탐지이벤트
attackIp	No	string	공격자IP
targetIp	No	string	타겟IP
attackType	No	string	공격유형 `Classic에서만 사용합니다.`
protocol	No	string	프로토콜 `VPC에서만 사용합니다.`

응답

응답 바디

필드명	타입	설명
returnCode	string	요청에 대한 처리 결과 코드
returnMessage	string	요청에 대한 처리 결과 메시지
ipsTotalCount	int	getIPSList의 총 개수
page	int	요청 페이지 번호
ipsDataList	array	IPS 이벤트 목록
ipsDataList[].ticketId	string	IPS 이벤트 번호
ipsDataList[].date	String	탐지날짜
ipsDataList[].product	string	상품분류 classic : `IPS`, vpc : `IPS_V2`
ipsDataList[].eventNm	string	이벤트명
ipsDataList[].attackerIp	string	공격IP
ipsDataList[].attackerPort	string	공격Port
ipsDataList[].targetIp	string	타겟IP
ipsDataList[].targetPort	string	타겟Port
ipsDataList[].detect	string	탐지건수
ipsDataList[].region	string	리전
ipsDataList[].zoneName	string	Zone(KR-1)
ipsDataList[].vpcName	string	vpc name
ipsDataList[].platForm	string	Platform Info
ipsDataList[].attackType	string	공격유형 `Classic에서만 사용합니다.`
ipsDataList[].protocol	string	프로토콜 `VPC에서만 사용합니다.`

예시

요청 예시

curl -X POST "https://securitymonitoring.apigw.gov-ntruss.com/securitymonitoring/v1/getIPSList"
   -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,
  "ipsDataList": [
    {
        "ticketId": "1",
        "date": "1600325545000",
        "product": "IPS_V2",
        "eventNm": "test_event",
        "attackType": null,
        "attackerIp": "10.0.4.10",
        "attackerPort": "2952",
        "targetIp": "10.0.1.7",
        "targetPort": "80",
        "protocol": "TCP",
        "detect": "9",
        "region": "Korea",
        "zoneName": "KR-1",
        "platForm": "VPC",
        "vpcName": "vpc-test"
    }
  ]
}

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

What's Next

getAVList

개요
요청
응답
예시

태그

Security Monitoring