REST Resource: projects.scanConfigs.scanRuns.findings

리소스: Finding

발견 항목 리소스는 ScanRun 중에 식별된 취약점 인스턴스를 나타냅니다.

JSON 표현 
{
  "name": string,
  "findingType": string,
  "severity": enum (Severity),
  "httpMethod": string,
  "fuzzedUrl": string,
  "body": string,
  "description": string,
  "reproductionUrl": string,
  "frameUrl": string,
  "finalUrl": string,
  "trackingId": string,
  "form": {
    object (Form)
  },
  "outdatedLibrary": {
    object (OutdatedLibrary)
  },
  "violatingResource": {
    object (ViolatingResource)
  },
  "vulnerableHeaders": {
    object (VulnerableHeaders)
  },
  "vulnerableParameters": {
    object (VulnerableParameters)
  },
  "xss": {
    object (Xss)
  },
  "xxe": {
    object (Xxe)
  }
}
필드
name

string

발견 항목의 리소스 이름입니다. 이름은 'projects/{projectId}/scanConfigs/{scanConfigId}/scanruns/{scanRunId}/findings/{findingId}' 형식입니다. 발견 ID는 시스템에서 생성합니다.
findingType

string

발견 항목 유형입니다. 발견 항목에 관한 자세하고 최신 정보는 https://cloud.google.com/security-command-center/docs/how-to-remediate-web-security-scanner에서 확인할 수 있습니다.
severity

enum (Severity)

신고된 취약점의 심각도 수준입니다.
httpMethod

string

취약점을 트리거한 요청의 HTTP 메서드(대문자)입니다.
fuzzedUrl

string

서버 측 퍼저에서 생성하고 취약점을 트리거한 요청에 사용된 URL입니다.
body

string

취약점을 트리거한 요청의 본문입니다.
description

string

취약점에 대한 설명입니다.
reproductionUrl

string

사용자가 취약점을 재현하는 데 활용할 수 있는 사람이 읽을 수 있는 페이로드가 포함된 URL입니다.
frameUrl

string

취약점이 중첩된 IFrame에서 발생한 경우 즉시 상위 IFrame이 보고됩니다.
finalUrl

string

취약점이 감지될 때 브라우저가 연결되는 URL입니다.
trackingId

string

추적 ID는 여러 ScanRun에서 취약점 인스턴스를 고유하게 식별합니다.
form

object (Form)

HTML 양식으로 취약점에 대해 보고된 정보가 포함된 부가기능(있는 경우)
outdatedLibrary

object (OutdatedLibrary)

오래된 라이브러리에 관한 정보가 포함된 부가기능입니다.
violatingResource

object (ViolatingResource)

JavaScript 소스, 이미지, 오디오 파일 등 취약점을 일으키는 리소스에 관한 세부정보가 포함된 부가기능입니다.
vulnerableHeaders

object (VulnerableHeaders)

취약하거나 누락된 HTTP 헤더에 관한 정보가 포함된 부가기능입니다.
vulnerableParameters

object (VulnerableParameters)

취약한 것으로 확인된 요청 매개변수에 관한 정보가 포함된 부가기능입니다.
xss

object (Xss)

XSS에 대해 보고된 정보가 포함된 부가기능(있는 경우)
xxe

object (Xxe)

XXE에 대해 보고된 정보가 포함된 부가기능(있는 경우)

심각도

취약점의 심각도 수준입니다.

열거형
SEVERITY_UNSPECIFIED 심각도가 지정되지 않았습니다. 기본값입니다.
CRITICAL 심각한 심각도
HIGH 심각도가 높습니다.
MEDIUM 심각도가 중간입니다.
LOW 심각도가 낮습니다.

양식

! HTML로 작성된 취약점 정보입니다.

JSON 표현 
{
  "actionUri": string,
  "fields": [
    string
  ]
}
필드
actionUri

string

! 양식이 제출될 때 전송되는 URI입니다.
fields[]

string

! 취약점과 관련된 양식 필드의 이름입니다.

OutdatedLibrary

오래된 라이브러리에 대해 보고된 정보입니다.

JSON 표현 
{
  "libraryName": string,
  "version": string,
  "learnMoreUrls": [
    string
  ]
}
필드
libraryName

string

오래된 라이브러리의 이름입니다.
version

string

버전 번호입니다.
learnMoreUrls[]

string

라이브러리의 취약점에 관한 자세한 정보를 제공하는 URL입니다.

ViolatingResource

JavaScript 소스, 이미지, 오디오 파일 등 취약점을 야기하는 리소스에 관한 정보

JSON 표현 
{
  "contentType": string,
  "resourceUrl": string
}
필드
contentType

string

이 리소스의 MIME 유형입니다.
resourceUrl

string

정책을 위반하는 리소스의 URL입니다.

VulnerableHeaders

취약하거나 누락된 HTTP 헤더에 관한 정보

JSON 표현 
{
  "headers": [
    {
      object (Header)
    }
  ],
  "missingHeaders": [
    {
      object (Header)
    }
  ]
}
필드
headers[]

object (Header)

취약한 헤더 목록입니다.
missingHeaders[]

object (Header)

누락된 헤더 목록입니다.

VulnerableParameters

취약한 요청 매개변수에 관한 정보

JSON 표현 
{
  "parameterNames": [
    string
  ]
}
필드
parameterNames[]

string

취약한 매개변수 이름입니다.

Xss

XSS에 대해 보고된 정보입니다.

JSON 표현 
{
  "stackTraces": [
    string
  ],
  "errorMessage": string
}
필드
stackTraces[]

string

XSS가 발생한 지점으로 이어지는 스택 트레이스
errorMessage

string

JavaScript 중단으로 인해 생성된 오류 메시지입니다.

Xxe

XXE에 대해 보고된 정보입니다.

JSON 표현 
{
  "payloadValue": string,
  "payloadLocation": enum (Location)
}
필드
payloadValue

string

XXE 취약점을 트리거한 XML 문자열입니다. 페이로드가 아닌 값은 수정될 수 있습니다.
payloadLocation

enum (Location)

요청 내에서 페이로드가 배치된 위치입니다.

위치

요청 내에서 XML이 대체된 위치입니다.

열거형
LOCATION_UNSPECIFIED 알 수 없는 위치입니다.
COMPLETE_REQUEST_BODY XML 페이로드가 전체 요청 본문을 대체했습니다.

메서드

get

 발견 항목을 가져옵니다.

list

 지정된 ScanRun 아래에 발견 항목을 나열합니다.