자산 IP 생성

새 자산 IP를 생성합니다.

필요 권한

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

HTTP 요청

POST /api/sonar/ip-addresses

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d ip="192.168.1.100" \
     -d hostname="server01" \
     -d description="웹 서버" \
     -d scoring_type="priority" \
     -d priority=3 \
     -X POST \
     https://HOSTNAME/api/sonar/ip-addresses

요청 매개변수

키	필수	타입	설명	비고
guid	X	문자열	IP 주소 GUID	36자 GUID. 미설정 시 무작위 생성
ip	O	문자열	IP 주소
site_guid	X	문자열	사이트 GUID	36자
category_guid	X	문자열	분류 GUID	36자
description	X	문자열	설명	최대 2000자
emp_guid	X	문자열	담당자 GUID (정)	36자
emp_guid2	X	문자열	담당자 GUID (부)	36자
hostname	X	문자열	호스트명	최대 255자
os_name	X	문자열	운영체제명	최대 50자
os_ver	X	문자열	운영체제 버전	최대 20자
workgroup	X	문자열	작업그룹	최대 255자
location	X	문자열	위치	최대 255자
mac	X	문자열	MAC 주소
installed	X	문자열	설치일	`yyyy-MM-dd HH:mm:ssZ` 형식
scoring_type	O	문자열	점수 유형	`priority` 또는 `cia`
priority	X	정수	우선순위	scoring_type이 `priority`일 때 필수 (1~3)
confidentiality	X	정수	기밀성	scoring_type이 `cia`일 때 필수 (1~3)
integrity	X	정수	무결성	scoring_type이 `cia`일 때 필수 (1~3)
availability	X	정수	가용성	scoring_type이 `cia`일 때 필수 (1~3)

정상 응답

{}

오류 응답

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

HTTP 상태 코드 400 응답

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

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

HTTP 상태 코드 400 응답

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

scoring_type이 priority인데 CIA 값을 포함한 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'confidentiality', 'integrity', 'availability' must not be set when type is 'priority'."
}

scoring_type이 cia인데 priority 값을 포함한 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'priority' must not be set when type is 'cia'."
}

priority 값이 범위를 벗어난 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'priority' must be between 1 and 3."
}

CIA 값이 범위를 벗어난 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'confidentiality' must be between 1 and 3."
}

지원하지 않는 scoring_type인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "unsupported type: ABC"
}

중복된 IP 주소인 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicate ip address: 192.168.1.100"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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