차단 연동 조회

지정한 차단 연동 설정의 상세 정보를 조회합니다. 전체 차단 연동 설정 목록은 차단 연동 목록 조회 API로 확인할 수 있습니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/response-targets/a1b2c3d4-e5f6-7890-abcd-ef1234567890

요청 매개변수

경로 매개변수

정상 응답

{
  "response_target": {
    "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "방화벽 차단 연동",
    "description": "경계 방화벽으로 공격자 IP 차단",
    "enabled": true,
    "model_type": "bluemax-ngf",
    "model_name": "블루맥스 NGF",
    "ip_blacklist_name": "방화벽 차단 IP",
    "ip_blacklist_guid": "4dc14f3d-ebf8-4032-8a7a-ef9ec6cd3dd2",
    "profile_guid": "66666666-7777-8888-9999-000000000000",
    "created_at": "2026-06-18 10:00:00+0900",
    "updated_at": "2026-06-18 10:00:00+0900",
    "configs": {}
  }
}

• response_target (맵): 지정한 차단 연동 설정
  • guid (문자열): 차단 연동 설정 GUID
  • name (문자열): 차단 연동 설정 이름
  • description (문자열): 설명
  • enabled (불리언): 활성화 여부
  • model_type (문자열): 차단 연동 모델 유형 코드
  • model_name (문자열): 차단 연동 모델 이름. 세션 언어에 맞게 지역화되어 반환됩니다
  • ip_blacklist_name (문자열): 차단 대상 IP를 등록하는 주소 그룹 이름
  • ip_blacklist_guid (문자열): 주소 그룹 GUID
  • profile_guid (문자열): 연동 대상과 통신할 때 사용하는 접속 프로파일 GUID
  • created_at (문자열): 생성 일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated_at (문자열): 수정 일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • configs (문자열 키/값): 차단 연동 모델별 설정 값

오류 응답

guid가 누락된 경우

HTTP 상태 코드 400 응답

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

guid가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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

지정한 차단 연동 설정이 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "response-target-not-found",
  "error_msg": null
}

차단 연동 모델을 찾을 수 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "response-model-not-found",
  "error_msg": null
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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