자산 IP 취약점 등록

지정한 자산 IP에 새 취약점을 등록합니다.

필요 권한

사용자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

POST /api/sonar/ip-address-vulnerabilities

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d ip_guid="56654243-bd42-4b67-b21d-3cb21a86c09e" \
     -d cve_id="CVE-2024-12345" \
     -d status="UNRESOLVED" \
     -d scheduled="2025-08-20 00:00:00+0900" \
     -X POST \
     https://HOSTNAME/api/sonar/ip-address-vulnerabilities

요청 매개변수

키	필수	타입	설명	비고
guid	X	문자열	자산 IP 취약점 GUID	36자 GUID. 미설정 시 무작위 생성
ip_guid	O	문자열	자산 IP GUID	36자
cve_id	O	문자열	CVE 식별자	`CVE-YYYY-NNNN` 형식
status	X	문자열	처리 상태	`UNRESOLVED`, `REVIEWING`, `IN_PROGRESS`, `RISK_ACCEPTED`, `RESOLVED`. 기본값: `UNRESOLVED`
emp_guid	X	문자열	담당자 GUID	36자
diagnosis	X	문자열	진단 일시	`yyyy-MM-dd HH:mm:ssZ` 형식. 미설정 시 현재 시각
scheduled	X	문자열	조치 예정일	`yyyy-MM-dd HH:mm:ssZ` 형식
completed	X	문자열	조치 완료 일시	`yyyy-MM-dd HH:mm:ssZ` 형식

정상 응답

{}

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "ip_guid should be not null"
}

CVE 식별자 형식이 유효하지 않은 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-argument",
  "error_msg": "invalid cve format: CVE-XXXX"
}

처리 상태 값이 유효하지 않은 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-argument",
  "error_msg": "No enum constant com.logpresso.sonar.api.asset.IpAddressVulnerabilityStatus.INVALID"
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

자산 IP가 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "ip address not found"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}