Skip to content

Commit 130c317

Browse files
yoshi-automationyoshi-automation
committed
feat(securitycenter): update the api
#### securitycenter:v1 The following keys were added: - schemas.Compliance (Total Keys: 6) - schemas.Contact (Total Keys: 7) - schemas.EnvironmentVariable (Total Keys: 4) - schemas.ExfilResource (Total Keys: 5) - schemas.Exfiltration (Total Keys: 6) - schemas.File (Total Keys: 10) - schemas.Finding.properties.compliances (Total Keys: 2) - schemas.Finding.properties.contacts (Total Keys: 3) - schemas.Finding.properties.exfiltration.$ref (Total Keys: 1) - schemas.Finding.properties.processes (Total Keys: 2) - schemas.Process (Total Keys: 16) #### securitycenter:v1beta1 The following keys were added: - schemas.Compliance (Total Keys: 6) - schemas.Contact (Total Keys: 7) - schemas.EnvironmentVariable (Total Keys: 4) - schemas.ExfilResource (Total Keys: 5) - schemas.Exfiltration (Total Keys: 6) - schemas.File (Total Keys: 10) - schemas.Finding.properties.compliances (Total Keys: 2) - schemas.Finding.properties.contacts (Total Keys: 3) - schemas.Finding.properties.exfiltration.$ref (Total Keys: 1) - schemas.Finding.properties.processes (Total Keys: 2) - schemas.Process (Total Keys: 16) #### securitycenter:v1beta2 The following keys were added: - schemas.Compliance (Total Keys: 6) - schemas.Contact (Total Keys: 7) - schemas.EnvironmentVariable (Total Keys: 4) - schemas.ExfilResource (Total Keys: 5) - schemas.Exfiltration (Total Keys: 6) - schemas.File (Total Keys: 10) - schemas.Finding.properties.compliances (Total Keys: 2) - schemas.Finding.properties.contacts (Total Keys: 3) - schemas.Finding.properties.exfiltration.$ref (Total Keys: 1) - schemas.Finding.properties.processes (Total Keys: 2) - schemas.Process (Total Keys: 16)
1 parent 122a226 commit 130c317

7 files changed

+1992
-7
lines changed

‎docs/dyn/securitycenter_v1.folders.sources.findings.html

Lines changed: 395 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/dyn/securitycenter_v1.organizations.notificationConfigs.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ <h3>Method Details</h3>
106106
<pre>Creates a notification config.
107107

108108
Args:
109-
parent: string, Required. Resource name of the new notification config&#x27;s parent. Its format is &quot;organizations/[organization_id]&quot;. (required)
109+
parent: string, Required. Resource name of the new notification config&#x27;s parent. Its format is &quot;organizations/[organization_id]&quot; or &quot;projects/[project_id]&quot;. (required)
110110
body: object, The request body.
111111
The object takes the form of:
112112

@@ -188,7 +188,7 @@ <h3>Method Details</h3>
188188
<pre>Lists notification configs.
189189

190190
Args:
191-
parent: string, Required. Name of the organization to list notification configs. Its format is &quot;organizations/[organization_id]&quot;. (required)
191+
parent: string, Required. Name of the organization to list notification configs. Its format is &quot;organizations/[organization_id]&quot; or &quot;projects/[project_id]&quot;. (required)
192192
pageSize: integer, The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
193193
pageToken: string, The value returned by the last `ListNotificationConfigsResponse`; indicates that this is a continuation of a prior `ListNotificationConfigs` call, and that the system should return the next page of data.
194194
x__xgafv: string, V1 error format.

‎docs/dyn/securitycenter_v1.organizations.sources.findings.html

Lines changed: 553 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/dyn/securitycenter_v1.projects.sources.findings.html

Lines changed: 395 additions & 0 deletions
Large diffs are not rendered by default.

‎googleapiclient/discovery_cache/documents/securitycenter.v1.json

Lines changed: 217 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1489,7 +1489,7 @@
14891489
"type": "string"
14901490
},
14911491
"parent": {
1492-
"description": "Required. Resource name of the new notification config's parent. Its format is \"organizations/[organization_id]\".",
1492+
"description": "Required. Resource name of the new notification config's parent. Its format is \"organizations/[organization_id]\" or \"projects/[project_id]\".",
14931493
"location": "path",
14941494
"pattern": "^organizations/[^/]+$",
14951495
"required": true,
@@ -1578,7 +1578,7 @@
15781578
"type": "string"
15791579
},
15801580
"parent": {
1581-
"description": "Required. Name of the organization to list notification configs. Its format is \"organizations/[organization_id]\".",
1581+
"description": "Required. Name of the organization to list notification configs. Its format is \"organizations/[organization_id]\" or \"projects/[project_id]\".",
15821582
"location": "path",
15831583
"pattern": "^organizations/[^/]+$",
15841584
"required": true,
@@ -3058,7 +3058,7 @@
30583058
}
30593059
}
30603060
},
3061-
"revision": "20220516",
3061+
"revision": "20220520",
30623062
"rootUrl": "https://securitycenter.googleapis.com/",
30633063
"schemas": {
30643064
"Access": {
@@ -3256,6 +3256,28 @@
32563256
},
32573257
"type": "object"
32583258
},
3259+
"Compliance": {
3260+
"description": "Contains compliance information about a security standard indicating unmet recommendations.",
3261+
"id": "Compliance",
3262+
"properties": {
3263+
"ids": {
3264+
"description": "e.g. A.12.4.1",
3265+
"items": {
3266+
"type": "string"
3267+
},
3268+
"type": "array"
3269+
},
3270+
"standard": {
3271+
"description": "e.g. \"cis\", \"pci\", \"owasp\", etc.",
3272+
"type": "string"
3273+
},
3274+
"version": {
3275+
"description": "e.g. 1.1",
3276+
"type": "string"
3277+
}
3278+
},
3279+
"type": "object"
3280+
},
32593281
"Connection": {
32603282
"description": "Contains information about the IP connection associated with the finding.",
32613283
"id": "Connection",
@@ -3301,6 +3323,31 @@
33013323
},
33023324
"type": "object"
33033325
},
3326+
"Contact": {
3327+
"description": "Representa a single contact's email address",
3328+
"id": "Contact",
3329+
"properties": {
3330+
"email": {
3331+
"description": "An email address e.g. \"[email protected]\"",
3332+
"type": "string"
3333+
}
3334+
},
3335+
"type": "object"
3336+
},
3337+
"ContactDetails": {
3338+
"description": "The details pertaining to specific contacts",
3339+
"id": "ContactDetails",
3340+
"properties": {
3341+
"contacts": {
3342+
"description": "A list of contacts",
3343+
"items": {
3344+
"$ref": "Contact"
3345+
},
3346+
"type": "array"
3347+
}
3348+
},
3349+
"type": "object"
3350+
},
33043351
"Cve": {
33053352
"description": "CVE stands for Common Vulnerabilities and Exposures. More information: https://cve.mitre.org",
33063353
"id": "Cve",
@@ -3469,6 +3516,60 @@
34693516
"properties": {},
34703517
"type": "object"
34713518
},
3519+
"EnvironmentVariable": {
3520+
"description": "EnvironmentVariable is a name-value pair to store env variables for Process.",
3521+
"id": "EnvironmentVariable",
3522+
"properties": {
3523+
"name": {
3524+
"description": "Environment variable name as a JSON encoded string.",
3525+
"type": "string"
3526+
},
3527+
"val": {
3528+
"description": "Environment variable value as a JSON encoded string.",
3529+
"type": "string"
3530+
}
3531+
},
3532+
"type": "object"
3533+
},
3534+
"ExfilResource": {
3535+
"description": "Resource that has been exfiltrated or exfiltrated_to.",
3536+
"id": "ExfilResource",
3537+
"properties": {
3538+
"components": {
3539+
"description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.",
3540+
"items": {
3541+
"type": "string"
3542+
},
3543+
"type": "array"
3544+
},
3545+
"name": {
3546+
"description": "Resource\u2019s URI (https://google.aip.dev/122#full-resource-names)",
3547+
"type": "string"
3548+
}
3549+
},
3550+
"type": "object"
3551+
},
3552+
"Exfiltration": {
3553+
"description": "Exfiltration represents a data exfiltration attempt of one or more source(s) to one or more target(s). Source(s) represent the source of data that is exfiltrated, and Target(s) represents the destination the data was copied to.",
3554+
"id": "Exfiltration",
3555+
"properties": {
3556+
"sources": {
3557+
"description": "If there are multiple sources, then the data is considered \u201cjoined\u201d between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.",
3558+
"items": {
3559+
"$ref": "ExfilResource"
3560+
},
3561+
"type": "array"
3562+
},
3563+
"targets": {
3564+
"description": "If there are multiple targets, each target would get a complete copy of the \u201cjoined\u201d source data.",
3565+
"items": {
3566+
"$ref": "ExfilResource"
3567+
},
3568+
"type": "array"
3569+
}
3570+
},
3571+
"type": "object"
3572+
},
34723573
"Expr": {
34733574
"description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() < 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.",
34743575
"id": "Expr",
@@ -3492,6 +3593,39 @@
34923593
},
34933594
"type": "object"
34943595
},
3596+
"File": {
3597+
"description": "File information about the related binary/library used by an executable, or the script used by a script interpreter",
3598+
"id": "File",
3599+
"properties": {
3600+
"contents": {
3601+
"description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)",
3602+
"type": "string"
3603+
},
3604+
"hashedSize": {
3605+
"description": "The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.",
3606+
"format": "int64",
3607+
"type": "string"
3608+
},
3609+
"partiallyHashed": {
3610+
"description": "True when the hash covers only a prefix of the file.",
3611+
"type": "boolean"
3612+
},
3613+
"path": {
3614+
"description": "Absolute path of the file as a JSON encoded string.",
3615+
"type": "string"
3616+
},
3617+
"sha256": {
3618+
"description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, hash_sha256 represents the SHA256 hash of the entire file.",
3619+
"type": "string"
3620+
},
3621+
"size": {
3622+
"description": "Size of the file in bytes.",
3623+
"format": "int64",
3624+
"type": "string"
3625+
}
3626+
},
3627+
"type": "object"
3628+
},
34953629
"Finding": {
34963630
"description": "Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.",
34973631
"id": "Finding",
@@ -3508,13 +3642,28 @@
35083642
"description": "The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: \"XSS_FLASH_INJECTION\"",
35093643
"type": "string"
35103644
},
3645+
"compliances": {
3646+
"description": "Contains compliance information for security standards associated to the finding.",
3647+
"items": {
3648+
"$ref": "Compliance"
3649+
},
3650+
"type": "array"
3651+
},
35113652
"connections": {
35123653
"description": "Contains information about the IP connection associated with the finding.",
35133654
"items": {
35143655
"$ref": "Connection"
35153656
},
35163657
"type": "array"
35173658
},
3659+
"contacts": {
3660+
"additionalProperties": {
3661+
"$ref": "ContactDetails"
3662+
},
3663+
"description": "Output only. Map containing the point of contacts for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { \u201csecurity\u201d: {contact: {email: \u201c[email protected]\u201d} contact: {email: \u201c[email protected]\u201d} }",
3664+
"readOnly": true,
3665+
"type": "object"
3666+
},
35183667
"createTime": {
35193668
"description": "The time at which the finding was created in Security Command Center.",
35203669
"format": "google-datetime",
@@ -3529,6 +3678,10 @@
35293678
"format": "google-datetime",
35303679
"type": "string"
35313680
},
3681+
"exfiltration": {
3682+
"$ref": "Exfiltration",
3683+
"description": "Represents exfiltrations associated with the Finding."
3684+
},
35323685
"externalSystems": {
35333686
"additionalProperties": {
35343687
"$ref": "GoogleCloudSecuritycenterV1ExternalSystem"
@@ -3614,6 +3767,13 @@
36143767
"description": "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}\"",
36153768
"type": "string"
36163769
},
3770+
"processes": {
3771+
"description": "Represents operating system processes associated with the Finding.",
3772+
"items": {
3773+
"$ref": "Process"
3774+
},
3775+
"type": "array"
3776+
},
36173777
"resourceName": {
36183778
"description": "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.",
36193779
"type": "string"
@@ -4926,6 +5086,60 @@
49265086
},
49275087
"type": "object"
49285088
},
5089+
"Process": {
5090+
"description": "Represents an operating system process.",
5091+
"id": "Process",
5092+
"properties": {
5093+
"args": {
5094+
"description": "Process arguments as JSON encoded strings.",
5095+
"items": {
5096+
"type": "string"
5097+
},
5098+
"type": "array"
5099+
},
5100+
"argumentsTruncated": {
5101+
"description": "True if arguments is incomplete.",
5102+
"type": "boolean"
5103+
},
5104+
"binary": {
5105+
"$ref": "File",
5106+
"description": "File information for the process executable."
5107+
},
5108+
"envVariables": {
5109+
"description": "Process environment variables.",
5110+
"items": {
5111+
"$ref": "EnvironmentVariable"
5112+
},
5113+
"type": "array"
5114+
},
5115+
"envVariablesTruncated": {
5116+
"description": "True if env_variables is incomplete.",
5117+
"type": "boolean"
5118+
},
5119+
"libraries": {
5120+
"description": "File information for libraries loaded by the process.",
5121+
"items": {
5122+
"$ref": "File"
5123+
},
5124+
"type": "array"
5125+
},
5126+
"parentPid": {
5127+
"description": "The parent process id.",
5128+
"format": "int64",
5129+
"type": "string"
5130+
},
5131+
"pid": {
5132+
"description": "The process id.",
5133+
"format": "int64",
5134+
"type": "string"
5135+
},
5136+
"script": {
5137+
"$ref": "File",
5138+
"description": "When the process represents the invocation of a script, binary provides information about the interpreter while script provides information about the script file provided to the interpreter."
5139+
}
5140+
},
5141+
"type": "object"
5142+
},
49295143
"Reference": {
49305144
"description": "Additional Links",
49315145
"id": "Reference",

0 commit comments

Comments
 (0)