mirror of
https://github.com/OMGeeky/google-apis-rs.git
synced 2026-01-27 12:20:17 +01:00
952 lines
38 KiB
HTML
952 lines
38 KiB
HTML
<!DOCTYPE html>
|
|
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
|
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<title>Sources Findings Patch - Security Command Center v3.0.0+20220224</title>
|
|
|
|
|
|
|
|
<link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
|
|
|
|
<link rel="stylesheet" href="../css/theme.css" type="text/css" />
|
|
<link rel="stylesheet" href="../css/theme_extra.css" type="text/css" />
|
|
<link rel="stylesheet" href="../css/highlight.css">
|
|
|
|
<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
|
|
<script src="//cdnjs.cloudflare.com/ajax/libs/modernizr/2.8.3/modernizr.min.js"></script>
|
|
<script type="text/javascript" src="../js/highlight.pack.js"></script>
|
|
<script src="../js/theme.js"></script>
|
|
|
|
<style>
|
|
body {font-size: 90%;}
|
|
pre, code {font-size: 100%;}
|
|
h3, h4, h5, h6 {color: #2980b9; font-weight: 300}
|
|
</style>
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav" role="document">
|
|
|
|
<div class="wy-grid-for-nav">
|
|
|
|
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
|
|
<div class="wy-side-nav-search">
|
|
<a href=".." class="icon icon-home"> Security Command Center v3.0.0+20220224</a>
|
|
|
|
</div>
|
|
|
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
|
<ul class="current">
|
|
|
|
|
|
<span>Folders</span>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_assets-group">Assets Group</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_assets-list">Assets List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_assets-update-security-marks">Assets Update Security Marks</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_big-query-exports-create">Big Query Exports Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_big-query-exports-delete">Big Query Exports Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_big-query-exports-get">Big Query Exports Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_big-query-exports-list">Big Query Exports List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_big-query-exports-patch">Big Query Exports Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_findings-bulk-mute">Findings Bulk Mute</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_mute-configs-create">Mute Configs Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_mute-configs-delete">Mute Configs Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_mute-configs-get">Mute Configs Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_mute-configs-list">Mute Configs List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_mute-configs-patch">Mute Configs Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-external-systems-patch">Sources Findings External Systems Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-group">Sources Findings Group</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-list">Sources Findings List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-patch">Sources Findings Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-set-mute">Sources Findings Set Mute</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-set-state">Sources Findings Set State</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-findings-update-security-marks">Sources Findings Update Security Marks</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../folders_sources-list">Sources List</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<span>Organizations</span>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_assets-group">Assets Group</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_assets-list">Assets List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_assets-run-discovery">Assets Run Discovery</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_assets-update-security-marks">Assets Update Security Marks</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_big-query-exports-create">Big Query Exports Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_big-query-exports-delete">Big Query Exports Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_big-query-exports-get">Big Query Exports Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_big-query-exports-list">Big Query Exports List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_big-query-exports-patch">Big Query Exports Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_findings-bulk-mute">Findings Bulk Mute</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_get-organization-settings">Get Organization Settings</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_mute-configs-create">Mute Configs Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_mute-configs-delete">Mute Configs Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_mute-configs-get">Mute Configs Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_mute-configs-list">Mute Configs List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_mute-configs-patch">Mute Configs Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_notification-configs-create">Notification Configs Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_notification-configs-delete">Notification Configs Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_notification-configs-get">Notification Configs Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_notification-configs-list">Notification Configs List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_notification-configs-patch">Notification Configs Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_operations-cancel">Operations Cancel</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_operations-delete">Operations Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_operations-get">Operations Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_operations-list">Operations List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-create">Sources Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-create">Sources Findings Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-external-systems-patch">Sources Findings External Systems Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-group">Sources Findings Group</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-list">Sources Findings List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-patch">Sources Findings Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-set-mute">Sources Findings Set Mute</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-set-state">Sources Findings Set State</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-findings-update-security-marks">Sources Findings Update Security Marks</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-get">Sources Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-get-iam-policy">Sources Get Iam Policy</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-list">Sources List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-patch">Sources Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-set-iam-policy">Sources Set Iam Policy</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_sources-test-iam-permissions">Sources Test Iam Permissions</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../organizations_update-organization-settings">Update Organization Settings</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<span>Projects</span>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_assets-group">Assets Group</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_assets-list">Assets List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_assets-update-security-marks">Assets Update Security Marks</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_big-query-exports-create">Big Query Exports Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_big-query-exports-delete">Big Query Exports Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_big-query-exports-get">Big Query Exports Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_big-query-exports-list">Big Query Exports List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_big-query-exports-patch">Big Query Exports Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_findings-bulk-mute">Findings Bulk Mute</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_mute-configs-create">Mute Configs Create</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_mute-configs-delete">Mute Configs Delete</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_mute-configs-get">Mute Configs Get</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_mute-configs-list">Mute Configs List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_mute-configs-patch">Mute Configs Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-findings-external-systems-patch">Sources Findings External Systems Patch</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-findings-group">Sources Findings Group</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-findings-list">Sources Findings List</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 current">
|
|
<a class="current" href=".">Sources Findings Patch</a>
|
|
|
|
<ul>
|
|
|
|
<li class="toctree-l2"><a href="#scopes">Scopes</a></li>
|
|
|
|
|
|
<li class="toctree-l2"><a href="#required-scalar-argument">Required Scalar Argument</a></li>
|
|
|
|
|
|
<li class="toctree-l2"><a href="#required-request-value">Required Request Value</a></li>
|
|
|
|
<li><a class="toctree-l3" href="#about-cursors">About Cursors</a></li>
|
|
|
|
|
|
<li class="toctree-l2"><a href="#optional-output-flags">Optional Output Flags</a></li>
|
|
|
|
|
|
<li class="toctree-l2"><a href="#optional-method-properties">Optional Method Properties</a></li>
|
|
|
|
|
|
<li class="toctree-l2"><a href="#optional-general-properties">Optional General Properties</a></li>
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-findings-set-mute">Sources Findings Set Mute</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-findings-set-state">Sources Findings Set State</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-findings-update-security-marks">Sources Findings Update Security Marks</a>
|
|
|
|
</li>
|
|
|
|
<li class="toctree-l1 ">
|
|
<a class="" href="../projects_sources-list">Sources List</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
|
|
|
|
|
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
|
|
<i data-toggle="wy-nav-top" class="icon icon-reorder"></i>
|
|
<a href=".."></a>
|
|
</nav>
|
|
|
|
|
|
<div class="wy-nav-content">
|
|
<div class="rst-content">
|
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
<ul class="wy-breadcrumbs">
|
|
<li><a href="..">Docs</a> »</li>
|
|
<li>Sources Findings Patch</li>
|
|
<li class="wy-breadcrumbs-aside">
|
|
|
|
|
|
<a href="https://github.com/Byron/google-apis-rs/tree/main/gen/securitycenter1-cli" class="icon icon-github"> Edit on GitHub</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
<hr/>
|
|
</div>
|
|
<div role="main">
|
|
<div class="section">
|
|
<p>Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.</p>
|
|
<h1 id="scopes">Scopes</h1>
|
|
<p>You will need authorization for the <em>https://www.googleapis.com/auth/cloud-platform</em> scope to make a valid call.</p>
|
|
<p>If unset, the scope for this method defaults to <em>https://www.googleapis.com/auth/cloud-platform</em>.
|
|
You can set the scope for this method like this: <code>securitycenter1 --scope <scope> projects sources-findings-patch ...</code></p>
|
|
<h1 id="required-scalar-argument">Required Scalar Argument</h1>
|
|
<ul>
|
|
<li><strong><name></strong> <em>(string)</em><ul>
|
|
<li>The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h1 id="required-request-value">Required Request Value</h1>
|
|
<p>The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure.
|
|
In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely.</p>
|
|
<p>For example, a structure like this:</p>
|
|
<pre><code>Finding:
|
|
access:
|
|
caller-ip: string
|
|
caller-ip-geo:
|
|
region-code: string
|
|
method-name: string
|
|
principal-email: string
|
|
service-name: string
|
|
user-agent-family: string
|
|
canonical-name: string
|
|
category: string
|
|
create-time: string
|
|
event-time: string
|
|
external-uri: string
|
|
finding-class: string
|
|
indicator:
|
|
domains: [string]
|
|
ip-addresses: [string]
|
|
mitre-attack:
|
|
additional-tactics: [string]
|
|
additional-techniques: [string]
|
|
primary-tactic: string
|
|
primary-techniques: [string]
|
|
version: string
|
|
mute: string
|
|
mute-initiator: string
|
|
mute-update-time: string
|
|
name: string
|
|
parent: string
|
|
resource-name: string
|
|
security-marks:
|
|
canonical-name: string
|
|
marks: { string: string }
|
|
name: string
|
|
severity: string
|
|
state: string
|
|
vulnerability:
|
|
cve:
|
|
cvssv3:
|
|
attack-complexity: string
|
|
attack-vector: string
|
|
availability-impact: string
|
|
base-score: number
|
|
confidentiality-impact: string
|
|
integrity-impact: string
|
|
privileges-required: string
|
|
scope: string
|
|
user-interaction: string
|
|
id: string
|
|
upstream-fix-available: boolean
|
|
|
|
</code></pre>
|
|
|
|
<p>can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time.</p>
|
|
<ul>
|
|
<li><code>-r .access caller-ip=diam</code><ul>
|
|
<li>Caller's IP address, such as "1.1.1.1".</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>caller-ip-geo region-code=diam</code></p>
|
|
<ul>
|
|
<li>A CLDR.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. method-name=sed</code></p>
|
|
<ul>
|
|
<li>The method that the service account called, e.g. "SetIamPolicy".</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>principal-email=et</code><ul>
|
|
<li>Associated email, such as "foo@google.com".</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>service-name=ea</code><ul>
|
|
<li>This is the API service that the service account made a call to, e.g. "iam.googleapis.com"</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>user-agent-family=dolore</code></p>
|
|
<ul>
|
|
<li>What kind of user agent is associated, e.g. operating system shells, embedded or stand-alone applications, etc.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. canonical-name=ipsum</code></p>
|
|
<ul>
|
|
<li>The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>category=ea</code><ul>
|
|
<li>The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>create-time=at</code><ul>
|
|
<li>The time at which the finding was created in Security Command Center.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>event-time=sit</code><ul>
|
|
<li>The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>external-uri=sit</code><ul>
|
|
<li>The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>finding-class=lorem</code><ul>
|
|
<li>The class of the finding.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>indicator domains=stet</code><ul>
|
|
<li>List of domains associated to the Finding.</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>ip-addresses=duo</code></p>
|
|
<ul>
|
|
<li>List of ip addresses associated to the Finding.</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>..mitre-attack additional-tactics=elitr</code></p>
|
|
<ul>
|
|
<li>Additional MITRE ATT&CK tactics related to this finding, if any.</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>additional-techniques=aliquyam</code><ul>
|
|
<li>Additional MITRE ATT&CK techniques related to this finding, if any, along with any of their respective parent techniques.</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>primary-tactic=erat</code><ul>
|
|
<li>The MITRE ATT&CK tactic most closely represented by this finding, if any.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>primary-techniques=ut</code><ul>
|
|
<li>The MITRE ATT&CK technique most closely represented by this finding, if any. primary_techniques is a repeated field because there are multiple levels of MITRE ATT&CK techniques. If the technique most closely represented by this finding is a sub-technique (e.g. SCANNING_IP_BLOCKS), both the sub-technique and its parent technique(s) will be listed (e.g. SCANNING_IP_BLOCKS, ACTIVE_SCANNING).</li>
|
|
<li>Each invocation of this argument appends the given value to the array.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>version=et</code></p>
|
|
<ul>
|
|
<li>The MITRE ATT&CK version referenced by the above fields. E.g. "8".</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. mute=lorem</code></p>
|
|
<ul>
|
|
<li>Indicates the mute state of a finding (either unspecified, muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>mute-initiator=rebum.</code><ul>
|
|
<li>First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>mute-update-time=et</code><ul>
|
|
<li>Output only. The most recent time this finding was muted or unmuted.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>name=sed</code><ul>
|
|
<li>The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>parent=stet</code><ul>
|
|
<li>The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>resource-name=aliquyam</code><ul>
|
|
<li>For findings on Google Cloud resources, the full resource name of the Google Cloud resource this finding is for. See: https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation time.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>security-marks canonical-name=kasd</code><ul>
|
|
<li>The canonical name of the marks. Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" "folders/{folder_id}/assets/{asset_id}/securityMarks" "projects/{project_number}/assets/{asset_id}/securityMarks" "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks" "folders/{folder_id}/sources/{source_id}/findings/{finding_id}/securityMarks" "projects/{project_number}/sources/{source_id}/findings/{finding_id}/securityMarks"</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>marks=key=lorem</code><ul>
|
|
<li>Mutable user specified security marks belonging to the parent resource. Constraints are as follows: * Keys and values are treated as case insensitive * Keys must be between 1 - 256 characters (inclusive) * Keys must be letters, numbers, underscores, or dashes * Values have leading and trailing whitespace trimmed, remaining characters must be between 1 - 4096 characters (inclusive)</li>
|
|
<li>the value will be associated with the given <code>key</code></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>name=sit</code></p>
|
|
<ul>
|
|
<li>The relative resource name of the SecurityMarks. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks".</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. severity=kasd</code></p>
|
|
<ul>
|
|
<li>The severity of the finding. This field is managed by the source that writes the finding.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>state=tempor</code><ul>
|
|
<li>The state of the finding.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>vulnerability.cve.cvssv3 attack-complexity=dolor</code><ul>
|
|
<li>This metric describes the conditions beyond the attacker's control that must exist in order to exploit the vulnerability.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>attack-vector=amet</code><ul>
|
|
<li>Base Metrics Represents the intrinsic characteristics of a vulnerability that are constant over time and across user environments. This metric reflects the context by which vulnerability exploitation is possible.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>availability-impact=sit</code><ul>
|
|
<li>This metric measures the impact to the availability of the impacted component resulting from a successfully exploited vulnerability.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>base-score=0.6642185324610259</code><ul>
|
|
<li>The base score is a function of the base metric scores.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>confidentiality-impact=ipsum</code><ul>
|
|
<li>This metric measures the impact to the confidentiality of the information resources managed by a software component due to a successfully exploited vulnerability.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>integrity-impact=ipsum</code><ul>
|
|
<li>This metric measures the impact to integrity of a successfully exploited vulnerability.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>privileges-required=et</code><ul>
|
|
<li>This metric describes the level of privileges an attacker must possess before successfully exploiting the vulnerability.</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>scope=elitr</code><ul>
|
|
<li>The Scope metric captures whether a vulnerability in one vulnerable component impacts resources in components beyond its security scope.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>user-interaction=eirmod</code></p>
|
|
<ul>
|
|
<li>This metric captures the requirement for a human user, other than the attacker, to participate in the successful compromise of the vulnerable component.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><code>.. id=dolor</code></p>
|
|
<ul>
|
|
<li>The unique identifier for the vulnerability. e.g. CVE-2021-34527</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>upstream-fix-available=false</code><ul>
|
|
<li>Whether upstream fix is available for the CVE.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h3 id="about-cursors">About Cursors</h3>
|
|
<p>The cursor position is key to comfortably set complex nested structures. The following rules apply:</p>
|
|
<ul>
|
|
<li>The cursor position is always set relative to the current one, unless the field name starts with the <code>.</code> character. Fields can be nested such as in <code>-r f.s.o</code> .</li>
|
|
<li>The cursor position is set relative to the top-level structure if it starts with <code>.</code>, e.g. <code>-r .s.s</code></li>
|
|
<li>You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify <code>-r struct.sub_struct=bar</code>.</li>
|
|
<li>You can move the cursor one level up by using <code>..</code>. Each additional <code>.</code> moves it up one additional level. E.g. <code>...</code> would go three levels up.</li>
|
|
</ul>
|
|
<h1 id="optional-output-flags">Optional Output Flags</h1>
|
|
<p>The method's return value a JSON encoded structure, which will be written to standard output by default.</p>
|
|
<ul>
|
|
<li><strong>-o out</strong><ul>
|
|
<li><em>out</em> specifies the <em>destination</em> to which to write the server's result to.
|
|
It will be a JSON-encoded structure.
|
|
The <em>destination</em> may be <code>-</code> to indicate standard output, or a filepath that is to contain the received bytes.
|
|
If unset, it defaults to standard output.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h1 id="optional-method-properties">Optional Method Properties</h1>
|
|
<p>You may set the following properties to further configure the call. Please note that <code>-p</code> is followed by one
|
|
or more key-value-pairs, and is called like this <code>-p k1=v1 k2=v2</code> even though the listing below repeats the
|
|
<code>-p</code> for completeness.</p>
|
|
<ul>
|
|
<li><strong>-p update-mask=string</strong><ul>
|
|
<li>The FieldMask to use when updating the finding resource. This field should not be specified when creating a finding. When updating a finding, an empty mask is treated as updating all mutable fields and replacing source_properties. Individual source_properties can be added/updated by using "source_properties." in the field mask.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h1 id="optional-general-properties">Optional General Properties</h1>
|
|
<p>The following properties can configure any call, and are not specific to this method.</p>
|
|
<ul>
|
|
<li>
|
|
<p><strong>-p $-xgafv=string</strong></p>
|
|
<ul>
|
|
<li>V1 error format.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p access-token=string</strong></p>
|
|
<ul>
|
|
<li>OAuth access token.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p alt=string</strong></p>
|
|
<ul>
|
|
<li>Data format for response.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p callback=string</strong></p>
|
|
<ul>
|
|
<li>JSONP</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p fields=string</strong></p>
|
|
<ul>
|
|
<li>Selector specifying which fields to include in a partial response.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p key=string</strong></p>
|
|
<ul>
|
|
<li>API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p oauth-token=string</strong></p>
|
|
<ul>
|
|
<li>OAuth 2.0 token for the current user.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p pretty-print=boolean</strong></p>
|
|
<ul>
|
|
<li>Returns response with indentations and line breaks.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p quota-user=string</strong></p>
|
|
<ul>
|
|
<li>Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p upload-type=string</strong></p>
|
|
<ul>
|
|
<li>Legacy upload protocol for media (e.g. "media", "multipart").</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>-p upload-protocol=string</strong></p>
|
|
<ul>
|
|
<li>Upload protocol for media (e.g. "raw", "multipart").</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
<footer>
|
|
|
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
|
|
<a href="../projects_sources-findings-set-mute" class="btn btn-neutral float-right" title="Sources Findings Set Mute"/>Next <span class="icon icon-circle-arrow-right"></span></a>
|
|
|
|
|
|
<a href="../projects_sources-findings-list" class="btn btn-neutral" title="Sources Findings List"><span class="icon icon-circle-arrow-left"></span> Previous</a>
|
|
|
|
</div>
|
|
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<p>
|
|
<!-- Copyright etc -->
|
|
</p>
|
|
</div>
|
|
|
|
Built with <a href="http://www.mkdocs.org">MkDocs</a>, using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
</footer>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</section>
|
|
|
|
</div>
|
|
|
|
<div class="rst-versions" role="note" style="cursor: pointer">
|
|
<span class="rst-current-version" data-toggle="rst-current-version">
|
|
|
|
<a class="icon icon-github" style="float: left; color: #fcfcfc"> GitHub</a>
|
|
|
|
<span><a href="../projects_sources-findings-list" style="color: #fcfcfc;">« Previous</a></span>
|
|
<span style="margin-left: 15px"><a href="../projects_sources-findings-set-mute" style="color: #fcfcfc">Next »</a></span>
|
|
</span>
|
|
</div>
|
|
</body>
|
|
</html> |