@googleapis/securitycenter 9.0.0 → 9.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## [9.1.0](https://github.com/googleapis/google-api-nodejs-client/compare/securitycenter-v9.0.0...securitycenter-v9.1.0) (2024-08-30)
4
+
5
+
6
+ ### Features
7
+
8
+ * **securitycenter:** update the API ([b82bcee](https://github.com/googleapis/google-api-nodejs-client/commit/b82bceec5286bf7e018e33c6674ed17b7f644698))
9
+
3
10
  ## [9.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/securitycenter-v8.3.0...securitycenter-v9.0.0) (2024-08-16)
4
11
 
5
12
 
package/build/v1.d.ts CHANGED
@@ -476,6 +476,10 @@ export declare namespace securitycenter_v1 {
476
476
  * The Azure subscription associated with the resource.
477
477
  */
478
478
  subscription?: Schema$AzureSubscription;
479
+ /**
480
+ * The Azure Entra tenant associated with the resource.
481
+ */
482
+ tenant?: Schema$AzureTenant;
479
483
  }
480
484
  /**
481
485
  * Represents an Azure resource group.
@@ -499,6 +503,15 @@ export declare namespace securitycenter_v1 {
499
503
  */
500
504
  id?: string | null;
501
505
  }
506
+ /**
507
+ * Represents a Microsoft Entra tenant.
508
+ */
509
+ export interface Schema$AzureTenant {
510
+ /**
511
+ * The ID of the Microsoft Entra tenant, for example, "a11aaa11-aa11-1aa1-11aa-1aaa11a".
512
+ */
513
+ id?: string | null;
514
+ }
502
515
  /**
503
516
  * Information related to Google Cloud Backup and DR Service findings.
504
517
  */
@@ -858,6 +871,10 @@ export declare namespace securitycenter_v1 {
858
871
  * Date the first publicly available exploit or PoC was released.
859
872
  */
860
873
  exploitReleaseDate?: string | null;
874
+ /**
875
+ * Date of the earliest known exploitation.
876
+ */
877
+ firstExploitationDate?: string | null;
861
878
  /**
862
879
  * The unique identifier for the vulnerability. e.g. CVE-2021-34527
863
880
  */
@@ -924,6 +941,27 @@ export declare namespace securitycenter_v1 {
924
941
  */
925
942
  userInteraction?: string | null;
926
943
  }
944
+ /**
945
+ * Details about a data access attempt made by a principal not authorized under applicable data security policy.
946
+ */
947
+ export interface Schema$DataAccessEvent {
948
+ /**
949
+ * Unique identifier for data access event.
950
+ */
951
+ eventId?: string | null;
952
+ /**
953
+ * Timestamp of data access event.
954
+ */
955
+ eventTime?: string | null;
956
+ /**
957
+ * The operation performed by the principal to access the data.
958
+ */
959
+ operation?: string | null;
960
+ /**
961
+ * The email address of the principal that accessed the data. The principal could be a user account, service account, Google group, or other.
962
+ */
963
+ principalEmail?: string | null;
964
+ }
927
965
  /**
928
966
  * Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided.
929
967
  */
@@ -953,6 +991,31 @@ export declare namespace securitycenter_v1 {
953
991
  */
954
992
  version?: string | null;
955
993
  }
994
+ /**
995
+ * Details about a data flow event, in which either the data is moved to or is accessed from a non-compliant geo-location, as defined in the applicable data security policy.
996
+ */
997
+ export interface Schema$DataFlowEvent {
998
+ /**
999
+ * Unique identifier for data flow event.
1000
+ */
1001
+ eventId?: string | null;
1002
+ /**
1003
+ * Timestamp of data flow event.
1004
+ */
1005
+ eventTime?: string | null;
1006
+ /**
1007
+ * The operation performed by the principal for the data flow event.
1008
+ */
1009
+ operation?: string | null;
1010
+ /**
1011
+ * The email address of the principal that initiated the data flow event. The principal could be a user account, service account, Google group, or other.
1012
+ */
1013
+ principalEmail?: string | null;
1014
+ /**
1015
+ * Non-compliant location of the principal or the data destination.
1016
+ */
1017
+ violatedLocation?: string | null;
1018
+ }
956
1019
  /**
957
1020
  * Memory hash detection contributing to the binary family match.
958
1021
  */
@@ -1230,10 +1293,18 @@ export declare namespace securitycenter_v1 {
1230
1293
  * The time at which the finding was created in Security Command Center.
1231
1294
  */
1232
1295
  createTime?: string | null;
1296
+ /**
1297
+ * Data access events associated with the finding.
1298
+ */
1299
+ dataAccessEvents?: Schema$DataAccessEvent[];
1233
1300
  /**
1234
1301
  * Database associated with the finding.
1235
1302
  */
1236
1303
  database?: Schema$Database;
1304
+ /**
1305
+ * Data flow events associated with the finding.
1306
+ */
1307
+ dataFlowEvents?: Schema$DataFlowEvent[];
1237
1308
  /**
1238
1309
  * Contains more details about the finding.
1239
1310
  */
@@ -2272,6 +2343,10 @@ export declare namespace securitycenter_v1 {
2272
2343
  * The Azure subscription associated with the resource.
2273
2344
  */
2274
2345
  subscription?: Schema$GoogleCloudSecuritycenterV2AzureSubscription;
2346
+ /**
2347
+ * The Azure Entra tenant associated with the resource.
2348
+ */
2349
+ tenant?: Schema$GoogleCloudSecuritycenterV2AzureTenant;
2275
2350
  }
2276
2351
  /**
2277
2352
  * Represents an Azure resource group.
@@ -2295,6 +2370,15 @@ export declare namespace securitycenter_v1 {
2295
2370
  */
2296
2371
  id?: string | null;
2297
2372
  }
2373
+ /**
2374
+ * Represents a Microsoft Entra tenant.
2375
+ */
2376
+ export interface Schema$GoogleCloudSecuritycenterV2AzureTenant {
2377
+ /**
2378
+ * The ID of the Microsoft Entra tenant, for example, "a11aaa11-aa11-1aa1-11aa-1aaa11a".
2379
+ */
2380
+ id?: string | null;
2381
+ }
2298
2382
  /**
2299
2383
  * Information related to Google Cloud Backup and DR Service findings.
2300
2384
  */
@@ -2588,6 +2672,10 @@ export declare namespace securitycenter_v1 {
2588
2672
  * Date the first publicly available exploit or PoC was released.
2589
2673
  */
2590
2674
  exploitReleaseDate?: string | null;
2675
+ /**
2676
+ * Date of the earliest known exploitation.
2677
+ */
2678
+ firstExploitationDate?: string | null;
2591
2679
  /**
2592
2680
  * The unique identifier for the vulnerability. e.g. CVE-2021-34527
2593
2681
  */
@@ -2654,6 +2742,27 @@ export declare namespace securitycenter_v1 {
2654
2742
  */
2655
2743
  userInteraction?: string | null;
2656
2744
  }
2745
+ /**
2746
+ * Details about a data access attempt made by a principal not authorized under applicable data security policy.
2747
+ */
2748
+ export interface Schema$GoogleCloudSecuritycenterV2DataAccessEvent {
2749
+ /**
2750
+ * Unique identifier for data access event.
2751
+ */
2752
+ eventId?: string | null;
2753
+ /**
2754
+ * Timestamp of data access event.
2755
+ */
2756
+ eventTime?: string | null;
2757
+ /**
2758
+ * The operation performed by the principal to access the data.
2759
+ */
2760
+ operation?: string | null;
2761
+ /**
2762
+ * The email address of the principal that accessed the data. The principal could be a user account, service account, Google group, or other.
2763
+ */
2764
+ principalEmail?: string | null;
2765
+ }
2657
2766
  /**
2658
2767
  * Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided.
2659
2768
  */
@@ -2683,6 +2792,31 @@ export declare namespace securitycenter_v1 {
2683
2792
  */
2684
2793
  version?: string | null;
2685
2794
  }
2795
+ /**
2796
+ * Details about a data flow event, in which either the data is moved to or is accessed from a non-compliant geo-location, as defined in the applicable data security policy.
2797
+ */
2798
+ export interface Schema$GoogleCloudSecuritycenterV2DataFlowEvent {
2799
+ /**
2800
+ * Unique identifier for data flow event.
2801
+ */
2802
+ eventId?: string | null;
2803
+ /**
2804
+ * Timestamp of data flow event.
2805
+ */
2806
+ eventTime?: string | null;
2807
+ /**
2808
+ * The operation performed by the principal for the data flow event.
2809
+ */
2810
+ operation?: string | null;
2811
+ /**
2812
+ * The email address of the principal that initiated the data flow event. The principal could be a user account, service account, Google group, or other.
2813
+ */
2814
+ principalEmail?: string | null;
2815
+ /**
2816
+ * Non-compliant location of the principal or the data destination.
2817
+ */
2818
+ violatedLocation?: string | null;
2819
+ }
2686
2820
  /**
2687
2821
  * Memory hash detection contributing to the binary family match.
2688
2822
  */
@@ -2909,10 +3043,18 @@ export declare namespace securitycenter_v1 {
2909
3043
  * Output only. The time at which the finding was created in Security Command Center.
2910
3044
  */
2911
3045
  createTime?: string | null;
3046
+ /**
3047
+ * Data access events associated with the finding.
3048
+ */
3049
+ dataAccessEvents?: Schema$GoogleCloudSecuritycenterV2DataAccessEvent[];
2912
3050
  /**
2913
3051
  * Database associated with the finding.
2914
3052
  */
2915
3053
  database?: Schema$GoogleCloudSecuritycenterV2Database;
3054
+ /**
3055
+ * Data flow events associated with the finding.
3056
+ */
3057
+ dataFlowEvents?: Schema$GoogleCloudSecuritycenterV2DataFlowEvent[];
2916
3058
  /**
2917
3059
  * Contains more details about the finding.
2918
3060
  */
@@ -6909,6 +7051,7 @@ export declare namespace securitycenter_v1 {
6909
7051
  securityHealthAnalyticsSettings: Resource$Organizations$Securityhealthanalyticssettings;
6910
7052
  simulations: Resource$Organizations$Simulations;
6911
7053
  sources: Resource$Organizations$Sources;
7054
+ valuedResources: Resource$Organizations$Valuedresources;
6912
7055
  constructor(context: APIRequestContext);
6913
7056
  /**
6914
7057
  * Gets the settings for an organization.
@@ -8988,6 +9131,46 @@ export declare namespace securitycenter_v1 {
8988
9131
  */
8989
9132
  requestBody?: Schema$GoogleCloudSecuritycenterV1ExternalSystem;
8990
9133
  }
9134
+ export class Resource$Organizations$Valuedresources {
9135
+ context: APIRequestContext;
9136
+ constructor(context: APIRequestContext);
9137
+ /**
9138
+ * Lists the valued resources for a set of simulation results and filter.
9139
+ *
9140
+ * @param params - Parameters for request
9141
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
9142
+ * @param callback - Optional callback that handles the response.
9143
+ * @returns A promise if used with async/await, or void if used with a callback.
9144
+ */
9145
+ list(params: Params$Resource$Organizations$Valuedresources$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
9146
+ list(params?: Params$Resource$Organizations$Valuedresources$List, options?: MethodOptions): GaxiosPromise<Schema$ListValuedResourcesResponse>;
9147
+ list(params: Params$Resource$Organizations$Valuedresources$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
9148
+ list(params: Params$Resource$Organizations$Valuedresources$List, options: MethodOptions | BodyResponseCallback<Schema$ListValuedResourcesResponse>, callback: BodyResponseCallback<Schema$ListValuedResourcesResponse>): void;
9149
+ list(params: Params$Resource$Organizations$Valuedresources$List, callback: BodyResponseCallback<Schema$ListValuedResourcesResponse>): void;
9150
+ list(callback: BodyResponseCallback<Schema$ListValuedResourcesResponse>): void;
9151
+ }
9152
+ export interface Params$Resource$Organizations$Valuedresources$List extends StandardParameters {
9153
+ /**
9154
+ * The filter expression that filters the valued resources in the response. Supported fields: * `resource_value` supports = * `resource_type` supports =
9155
+ */
9156
+ filter?: string;
9157
+ /**
9158
+ * Optional. The fields by which to order the valued resources response. Supported fields: * `exposed_score` * `resource_value` * `resource_type` * `resource` * `display_name` Values should be a comma separated list of fields. For example: `exposed_score,resource_value`. The default sorting order is descending. To specify ascending or descending order for a field, append a ` ASC` or a ` DESC` suffix, respectively; for example: `exposed_score DESC`.
9159
+ */
9160
+ orderBy?: string;
9161
+ /**
9162
+ * The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
9163
+ */
9164
+ pageSize?: number;
9165
+ /**
9166
+ * The value returned by the last `ListValuedResourcesResponse`; indicates that this is a continuation of a prior `ListValuedResources` call, and that the system should return the next page of data.
9167
+ */
9168
+ pageToken?: string;
9169
+ /**
9170
+ * Required. Name of parent to list valued resources. Valid formats: `organizations/{organization\}`, `organizations/{organization\}/simulations/{simulation\}` `organizations/{organization\}/simulations/{simulation\}/attackExposureResults/{attack_exposure_result_v2\}`
9171
+ */
9172
+ parent?: string;
9173
+ }
8991
9174
  export class Resource$Projects {
8992
9175
  context: APIRequestContext;
8993
9176
  assets: Resource$Projects$Assets;
package/build/v1.js CHANGED
@@ -1807,6 +1807,7 @@ var securitycenter_v1;
1807
1807
  new Resource$Organizations$Securityhealthanalyticssettings(this.context);
1808
1808
  this.simulations = new Resource$Organizations$Simulations(this.context);
1809
1809
  this.sources = new Resource$Organizations$Sources(this.context);
1810
+ this.valuedResources = new Resource$Organizations$Valuedresources(this.context);
1810
1811
  }
1811
1812
  getOrganizationSettings(paramsOrCallback, optionsOrCallback, callback) {
1812
1813
  let params = (paramsOrCallback ||
@@ -4446,6 +4447,44 @@ var securitycenter_v1;
4446
4447
  }
4447
4448
  }
4448
4449
  securitycenter_v1.Resource$Organizations$Sources$Findings$Externalsystems = Resource$Organizations$Sources$Findings$Externalsystems;
4450
+ class Resource$Organizations$Valuedresources {
4451
+ constructor(context) {
4452
+ this.context = context;
4453
+ }
4454
+ list(paramsOrCallback, optionsOrCallback, callback) {
4455
+ let params = (paramsOrCallback ||
4456
+ {});
4457
+ let options = (optionsOrCallback || {});
4458
+ if (typeof paramsOrCallback === 'function') {
4459
+ callback = paramsOrCallback;
4460
+ params = {};
4461
+ options = {};
4462
+ }
4463
+ if (typeof optionsOrCallback === 'function') {
4464
+ callback = optionsOrCallback;
4465
+ options = {};
4466
+ }
4467
+ const rootUrl = options.rootUrl || 'https://securitycenter.googleapis.com/';
4468
+ const parameters = {
4469
+ options: Object.assign({
4470
+ url: (rootUrl + '/v1/{+parent}/valuedResources').replace(/([^:]\/)\/+/g, '$1'),
4471
+ method: 'GET',
4472
+ apiVersion: '',
4473
+ }, options),
4474
+ params,
4475
+ requiredParams: ['parent'],
4476
+ pathParams: ['parent'],
4477
+ context: this.context,
4478
+ };
4479
+ if (callback) {
4480
+ (0, googleapis_common_1.createAPIRequest)(parameters, callback);
4481
+ }
4482
+ else {
4483
+ return (0, googleapis_common_1.createAPIRequest)(parameters);
4484
+ }
4485
+ }
4486
+ }
4487
+ securitycenter_v1.Resource$Organizations$Valuedresources = Resource$Organizations$Valuedresources;
4449
4488
  class Resource$Projects {
4450
4489
  constructor(context) {
4451
4490
  this.context = context;