Class Finding (2.18.0)

public final class Finding extends GeneratedMessageV3 implements FindingOrBuilder

A Finding resource represents a vulnerability instance identified during a ScanRun.

Protobuf type google.cloud.websecurityscanner.v1beta.Finding

Implements

FindingOrBuilder

Static Fields

BODY_FIELD_NUMBER

public static final int BODY_FIELD_NUMBER
Field Value
TypeDescription
int

DESCRIPTION_FIELD_NUMBER

public static final int DESCRIPTION_FIELD_NUMBER
Field Value
TypeDescription
int

FINAL_URL_FIELD_NUMBER

public static final int FINAL_URL_FIELD_NUMBER
Field Value
TypeDescription
int

FINDING_TYPE_FIELD_NUMBER

public static final int FINDING_TYPE_FIELD_NUMBER
Field Value
TypeDescription
int

FORM_FIELD_NUMBER

public static final int FORM_FIELD_NUMBER
Field Value
TypeDescription
int

FRAME_URL_FIELD_NUMBER

public static final int FRAME_URL_FIELD_NUMBER
Field Value
TypeDescription
int

FUZZED_URL_FIELD_NUMBER

public static final int FUZZED_URL_FIELD_NUMBER
Field Value
TypeDescription
int

HTTP_METHOD_FIELD_NUMBER

public static final int HTTP_METHOD_FIELD_NUMBER
Field Value
TypeDescription
int

NAME_FIELD_NUMBER

public static final int NAME_FIELD_NUMBER
Field Value
TypeDescription
int

OUTDATED_LIBRARY_FIELD_NUMBER

public static final int OUTDATED_LIBRARY_FIELD_NUMBER
Field Value
TypeDescription
int

REPRODUCTION_URL_FIELD_NUMBER

public static final int REPRODUCTION_URL_FIELD_NUMBER
Field Value
TypeDescription
int

TRACKING_ID_FIELD_NUMBER

public static final int TRACKING_ID_FIELD_NUMBER
Field Value
TypeDescription
int

VIOLATING_RESOURCE_FIELD_NUMBER

public static final int VIOLATING_RESOURCE_FIELD_NUMBER
Field Value
TypeDescription
int

VULNERABLE_HEADERS_FIELD_NUMBER

public static final int VULNERABLE_HEADERS_FIELD_NUMBER
Field Value
TypeDescription
int

VULNERABLE_PARAMETERS_FIELD_NUMBER

public static final int VULNERABLE_PARAMETERS_FIELD_NUMBER
Field Value
TypeDescription
int

XSS_FIELD_NUMBER

public static final int XSS_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static Finding getDefaultInstance()
Returns
TypeDescription
Finding

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static Finding.Builder newBuilder()
Returns
TypeDescription
Finding.Builder

newBuilder(Finding prototype)

public static Finding.Builder newBuilder(Finding prototype)
Parameter
NameDescription
prototypeFinding
Returns
TypeDescription
Finding.Builder

parseDelimitedFrom(InputStream input)

public static Finding parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Finding
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Finding parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Finding
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static Finding parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
Finding
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Finding parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Finding
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Finding parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
Finding
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Finding parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Finding
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Finding parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
Finding
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Finding parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Finding
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static Finding parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Finding
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Finding parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Finding
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static Finding parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
Finding
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Finding parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Finding
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<Finding> parser()
Returns
TypeDescription
Parser<Finding>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getBody()

public String getBody()

The body of the request that triggered the vulnerability.

string body = 5;

Returns
TypeDescription
String

The body.

getBodyBytes()

public ByteString getBodyBytes()

The body of the request that triggered the vulnerability.

string body = 5;

Returns
TypeDescription
ByteString

The bytes for body.

getDefaultInstanceForType()

public Finding getDefaultInstanceForType()
Returns
TypeDescription
Finding

getDescription()

public String getDescription()

The description of the vulnerability.

string description = 6;

Returns
TypeDescription
String

The description.

getDescriptionBytes()

public ByteString getDescriptionBytes()

The description of the vulnerability.

string description = 6;

Returns
TypeDescription
ByteString

The bytes for description.

getFinalUrl()

public String getFinalUrl()

The URL where the browser lands when the vulnerability is detected.

string final_url = 9;

Returns
TypeDescription
String

The finalUrl.

getFinalUrlBytes()

public ByteString getFinalUrlBytes()

The URL where the browser lands when the vulnerability is detected.

string final_url = 9;

Returns
TypeDescription
ByteString

The bytes for finalUrl.

getFindingType()

public String getFindingType()

The type of the Finding. Detailed and up-to-date information on findings can be found here: https://cloud.google.com/security-scanner/docs/scan-result-details

string finding_type = 2;

Returns
TypeDescription
String

The findingType.

getFindingTypeBytes()

public ByteString getFindingTypeBytes()

The type of the Finding. Detailed and up-to-date information on findings can be found here: https://cloud.google.com/security-scanner/docs/scan-result-details

string finding_type = 2;

Returns
TypeDescription
ByteString

The bytes for findingType.

getForm()

public Form getForm()

An addon containing information reported for a vulnerability with an HTML form, if any.

.google.cloud.websecurityscanner.v1beta.Form form = 16;

Returns
TypeDescription
Form

The form.

getFormOrBuilder()

public FormOrBuilder getFormOrBuilder()

An addon containing information reported for a vulnerability with an HTML form, if any.

.google.cloud.websecurityscanner.v1beta.Form form = 16;

Returns
TypeDescription
FormOrBuilder

getFrameUrl()

public String getFrameUrl()

If the vulnerability was originated from nested IFrame, the immediate parent IFrame is reported.

string frame_url = 8;

Returns
TypeDescription
String

The frameUrl.

getFrameUrlBytes()

public ByteString getFrameUrlBytes()

If the vulnerability was originated from nested IFrame, the immediate parent IFrame is reported.

string frame_url = 8;

Returns
TypeDescription
ByteString

The bytes for frameUrl.

getFuzzedUrl()

public String getFuzzedUrl()

The URL produced by the server-side fuzzer and used in the request that triggered the vulnerability.

string fuzzed_url = 4;

Returns
TypeDescription
String

The fuzzedUrl.

getFuzzedUrlBytes()

public ByteString getFuzzedUrlBytes()

The URL produced by the server-side fuzzer and used in the request that triggered the vulnerability.

string fuzzed_url = 4;

Returns
TypeDescription
ByteString

The bytes for fuzzedUrl.

getHttpMethod()

public String getHttpMethod()

The http method of the request that triggered the vulnerability, in uppercase.

string http_method = 3;

Returns
TypeDescription
String

The httpMethod.

getHttpMethodBytes()

public ByteString getHttpMethodBytes()

The http method of the request that triggered the vulnerability, in uppercase.

string http_method = 3;

Returns
TypeDescription
ByteString

The bytes for httpMethod.

getName()

public String getName()

The resource name of the Finding. The name follows the format of 'projects/{projectId}/scanConfigs/{scanConfigId}/scanruns/{scanRunId}/findings/{findingId}'. The finding IDs are generated by the system.

string name = 1;

Returns
TypeDescription
String

The name.

getNameBytes()

public ByteString getNameBytes()

The resource name of the Finding. The name follows the format of 'projects/{projectId}/scanConfigs/{scanConfigId}/scanruns/{scanRunId}/findings/{findingId}'. The finding IDs are generated by the system.

string name = 1;

Returns
TypeDescription
ByteString

The bytes for name.

getOutdatedLibrary()

public OutdatedLibrary getOutdatedLibrary()

An addon containing information about outdated libraries.

.google.cloud.websecurityscanner.v1beta.OutdatedLibrary outdated_library = 11;

Returns
TypeDescription
OutdatedLibrary

The outdatedLibrary.

getOutdatedLibraryOrBuilder()

public OutdatedLibraryOrBuilder getOutdatedLibraryOrBuilder()

An addon containing information about outdated libraries.

.google.cloud.websecurityscanner.v1beta.OutdatedLibrary outdated_library = 11;

Returns
TypeDescription
OutdatedLibraryOrBuilder

getParserForType()

public Parser<Finding> getParserForType()
Returns
TypeDescription
Parser<Finding>
Overrides

getReproductionUrl()

public String getReproductionUrl()

The URL containing human-readable payload that user can leverage to reproduce the vulnerability.

string reproduction_url = 7;

Returns
TypeDescription
String

The reproductionUrl.

getReproductionUrlBytes()

public ByteString getReproductionUrlBytes()

The URL containing human-readable payload that user can leverage to reproduce the vulnerability.

string reproduction_url = 7;

Returns
TypeDescription
ByteString

The bytes for reproductionUrl.

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getTrackingId()

public String getTrackingId()

The tracking ID uniquely identifies a vulnerability instance across multiple ScanRuns.

string tracking_id = 10;

Returns
TypeDescription
String

The trackingId.

getTrackingIdBytes()

public ByteString getTrackingIdBytes()

The tracking ID uniquely identifies a vulnerability instance across multiple ScanRuns.

string tracking_id = 10;

Returns
TypeDescription
ByteString

The bytes for trackingId.

getUnknownFields()

public final UnknownFieldSet getUnknownFields()
Returns
TypeDescription
UnknownFieldSet
Overrides

getViolatingResource()

public ViolatingResource getViolatingResource()

An addon containing detailed information regarding any resource causing the vulnerability such as JavaScript sources, image, audio files, etc.

.google.cloud.websecurityscanner.v1beta.ViolatingResource violating_resource = 12;

Returns
TypeDescription
ViolatingResource

The violatingResource.

getViolatingResourceOrBuilder()

public ViolatingResourceOrBuilder getViolatingResourceOrBuilder()

An addon containing detailed information regarding any resource causing the vulnerability such as JavaScript sources, image, audio files, etc.

.google.cloud.websecurityscanner.v1beta.ViolatingResource violating_resource = 12;

Returns
TypeDescription
ViolatingResourceOrBuilder

getVulnerableHeaders()

public VulnerableHeaders getVulnerableHeaders()

An addon containing information about vulnerable or missing HTTP headers.

.google.cloud.websecurityscanner.v1beta.VulnerableHeaders vulnerable_headers = 15;

Returns
TypeDescription
VulnerableHeaders

The vulnerableHeaders.

getVulnerableHeadersOrBuilder()

public VulnerableHeadersOrBuilder getVulnerableHeadersOrBuilder()

An addon containing information about vulnerable or missing HTTP headers.

.google.cloud.websecurityscanner.v1beta.VulnerableHeaders vulnerable_headers = 15;

Returns
TypeDescription
VulnerableHeadersOrBuilder

getVulnerableParameters()

public VulnerableParameters getVulnerableParameters()

An addon containing information about request parameters which were found to be vulnerable.

.google.cloud.websecurityscanner.v1beta.VulnerableParameters vulnerable_parameters = 13;

Returns
TypeDescription
VulnerableParameters

The vulnerableParameters.

getVulnerableParametersOrBuilder()

public VulnerableParametersOrBuilder getVulnerableParametersOrBuilder()

An addon containing information about request parameters which were found to be vulnerable.

.google.cloud.websecurityscanner.v1beta.VulnerableParameters vulnerable_parameters = 13;

Returns
TypeDescription
VulnerableParametersOrBuilder

getXss()

public Xss getXss()

An addon containing information reported for an XSS, if any.

.google.cloud.websecurityscanner.v1beta.Xss xss = 14;

Returns
TypeDescription
Xss

The xss.

getXssOrBuilder()

public XssOrBuilder getXssOrBuilder()

An addon containing information reported for an XSS, if any.

.google.cloud.websecurityscanner.v1beta.Xss xss = 14;

Returns
TypeDescription
XssOrBuilder

hasForm()

public boolean hasForm()

An addon containing information reported for a vulnerability with an HTML form, if any.

.google.cloud.websecurityscanner.v1beta.Form form = 16;

Returns
TypeDescription
boolean

Whether the form field is set.

hasOutdatedLibrary()

public boolean hasOutdatedLibrary()

An addon containing information about outdated libraries.

.google.cloud.websecurityscanner.v1beta.OutdatedLibrary outdated_library = 11;

Returns
TypeDescription
boolean

Whether the outdatedLibrary field is set.

hasViolatingResource()

public boolean hasViolatingResource()

An addon containing detailed information regarding any resource causing the vulnerability such as JavaScript sources, image, audio files, etc.

.google.cloud.websecurityscanner.v1beta.ViolatingResource violating_resource = 12;

Returns
TypeDescription
boolean

Whether the violatingResource field is set.

hasVulnerableHeaders()

public boolean hasVulnerableHeaders()

An addon containing information about vulnerable or missing HTTP headers.

.google.cloud.websecurityscanner.v1beta.VulnerableHeaders vulnerable_headers = 15;

Returns
TypeDescription
boolean

Whether the vulnerableHeaders field is set.

hasVulnerableParameters()

public boolean hasVulnerableParameters()

An addon containing information about request parameters which were found to be vulnerable.

.google.cloud.websecurityscanner.v1beta.VulnerableParameters vulnerable_parameters = 13;

Returns
TypeDescription
boolean

Whether the vulnerableParameters field is set.

hasXss()

public boolean hasXss()

An addon containing information reported for an XSS, if any.

.google.cloud.websecurityscanner.v1beta.Xss xss = 14;

Returns
TypeDescription
boolean

Whether the xss field is set.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public Finding.Builder newBuilderForType()
Returns
TypeDescription
Finding.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Finding.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
Finding.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public Finding.Builder toBuilder()
Returns
TypeDescription
Finding.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException