As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Changelog

PyPI History

1.35.1 (2024-11-11)

Bug Fixes

1.35.0 (2024-10-24)

Features

1.34.0 (2024-08-08)

Features

  • enable Dynamic Mute (6f4d816)

  • enable Dynamic Mute (6f4d816)

  • New values EXPLOITATION_FOR_PRIVILEGE_ESCALATION corresponding to T1068 and INDICATOR_REMOVAL_FILE_DELETION corresponding to T1070.004 are added to enum Technique (6f4d816)

  • New values EXPLOITATION_FOR_PRIVILEGE_ESCALATION corresponding to T1068 and INDICATOR_REMOVAL_FILE_DELETION corresponding to T1070.004 are added to enum Technique (6f4d816)

Documentation

  • T1068 is added for value EXPLOITATION_FOR_PRIVILEGE_ESCALATION and T1070.004 is added for value INDICATOR_REMOVAL_FILE_DELETION for enum `Technique (6f4d816)

  • T1068 is added for value EXPLOITATION_FOR_PRIVILEGE_ESCALATION and T1070.004 is added for value INDICATOR_REMOVAL_FILE_DELETION for enum `Technique (6f4d816)

1.33.1 (2024-07-30)

Bug Fixes

  • Retry and timeout values do not propagate in requests during pagination (52db52e)

1.33.0 (2024-07-09)

Features

  • added attack path API methods (242b713)

  • added cloud provider field to list findings response (242b713)

  • added etd custom module protos and API methods (242b713)

  • added ResourceValueConfig protos and API methods (242b713)

  • added toxic combination field to finding (242b713)

Documentation

  • update examples in comments to use backticks (242b713)

  • update toxic combinations comments (242b713)

1.32.1 (2024-07-08)

Bug Fixes

1.32.0 (2024-06-27)

Features

  • Add toxic_combination and group_memberships fields to finding (83c851e)

  • added cloud provider field to list findings response (83c851e)

  • added http configuration rule to ResourceValueConfig and ValuedResource API methods (83c851e)

  • added toxic combination field to finding (83c851e)

Documentation

  • Updated comments for ResourceValueConfig (83c851e)

1.31.0 (2024-04-17)

Features

  • [google-cloud-securitycenter] Add cloud_armor field to finding’s list of attributes (#12586) (c704e63)

1.30.1 (2024-04-04)

Documentation

  • Fixed backtick and double quotes mismatch in security_marks.proto (22201e2)

1.30.0 (2024-03-28)

Features

  • [google-cloud-securitycenter] Add Notebook field to finding’s list of attributes (#12523) (ec1301e)

1.29.0 (2024-03-11)

Features

  • Add external_system.case_create_time, external_system.case_close_time, and external_system.ticket_info to finding’s list of attributes (736a1ef)

  • Add security_posture, external_system.case_uri, external_system.case_priority, external_system.case_sla to finding’s list of attributes (736a1ef)

1.28.0 (2024-03-04)

Features

  • Add container.create_time, vulnerability.offending_package, vulnerability.fixed_package, vulnerability.security_bulletin, vulnerability.cve.impact, vulnerability.cve.exploitation_activity, vulnerability.cve.observed_in_the_wild, vulnerability.cve.zero_day to finding’s list of attributes (4450f4c)

  • Add load balancer, log entry, org policy, database.version, exfiltration.total_exfiltrated_bytes, file.disk_path, indicator.signature_type, and kubernetes.objects to finding’s list of attributes (4450f4c)

  • Added security center api V2 client library (4450f4c)

Bug Fixes

  • deps: Exclude google-auth 2.24.0 and 2.25.0 (4450f4c)

1.27.0 (2024-02-22)

Features

  • [google-cloud-securitycenter] Add application field to finding’s list of attributes (#12301) (c26abaf)

  • Add Backup DR field to finding’s list of attributes (0f7d3f3)

Bug Fixes

  • deps: [Many APIs] Require google-api-core>=1.34.1 (#12309) (c23398a)

  • fix ValueError in test__validate_universe_domain (89c1b05)

1.26.1 (2024-02-06)

Bug Fixes

  • Add google-auth as a direct dependency (9e8d039)

  • Add staticmethod decorator to _get_client_cert_source and _get_api_endpoint (9e8d039)

  • Resolve AttributeError ‘Credentials’ object has no attribute ‘universe_domain’ (9e8d039)

1.26.0 (2024-02-01)

Features

  • Allow users to explicitly configure universe domain (#12243) (e14d4b1)

1.25.0 (2023-12-07)

Features

  • Add support for python 3.12 (e9655df)

  • Introduce compatibility with native namespace packages (e9655df)

Bug Fixes

  • Require proto-plus >= 1.22.3 (e9655df)

  • Use retry_async instead of retry in async client (e9655df)

1.24.1 (2023-11-29)

Documentation

  • [google-cloud-securitycenter] Modify documentation of SimulateSecurityHealthAnalyticsCustomModuleRequest (#12042) (27239dd)

1.24.0 (2023-11-02)

Features

  • Add SimulateSecurityHealthAnalyticsCustomModule API for testing SHA custom module (#11854) (6055a99)

1.23.3 (2023-09-19)

Documentation

1.23.2 (2023-08-03)

Documentation

1.23.1 (2023-07-05)

Bug Fixes

1.23.0 (2023-06-29)

Features

1.22.0 (2023-06-13)

Features

  • Add user agent and DLP parent type fields to finding’s list of attributes (#11390) (8a5784b)

1.21.0 (2023-04-21)

Features

  • Add cloud_dlp_inspection and cloud_dlp_data_profile fields to finding’s list of attributes (#449) (f167dad)

1.20.0 (2023-04-12)

Features

  • Add Security Health Analytics (SHA) custom modules with Create, Get, List, Update, Delete (#447) (ff0ec29)

1.19.1 (2023-03-23)

Documentation

  • Fix formatting of request arg in docstring (#445) (b8e46b7)

1.19.0 (2023-02-28)

Features

  • Enable “rest” transport in Python for services supporting numeric enums (#439) (1e85d04)

1.18.2 (2023-01-20)

Bug Fixes

  • Add context manager return types (367a3bd)

Documentation

  • Add documentation for enums (367a3bd)

1.18.1 (2023-01-14)

Documentation

  • Update documentation for Security Command Center *.assets.list “parent” parameter (#425) (9f791eb)

1.18.0 (2023-01-10)

Features

1.17.0 (2022-12-15)

Features

  • Add files field to finding’s list of attributes (63c76ad)

  • Add kernel_rootkit field to finding’s list of attributes (#413) (62c9cb8)

  • Add support for google.cloud.securitycenter.__version__ (63c76ad)

  • Add typing to proto.Message based class attributes (63c76ad)

  • Add user_name field to the finding access (#418) (ced00fd)

  • Adding project/folder level parents to notification configs in SCC (#403) (667729a)

Bug Fixes

  • Add dict typing for client_options (63c76ad)

  • deps: Require google-api-core >=1.34.0, >=2.11.0 (fae54be)

  • Drop usage of pkg_resources (fae54be)

  • Fix timeout default values (fae54be)

Documentation

  • samples: Snippetgen handling of repeated enum field (63c76ad)

  • samples: Snippetgen should call await on the operation coroutine before calling result (fae54be)

  • samples: Update samples to include new parent levels (folder and project) (#405) (5960173)

1.16.2 (2022-10-07)

Bug Fixes

1.16.1 (2022-10-04)

Bug Fixes

1.16.0 (2022-09-15)

Features

  • Added parent display name i.e. source display name for a finding as one of the finding attributes (#390) (b6661c7)

1.15.0 (2022-08-29)

Features

  • Adding database access information, such as queries field to a finding (#370) (1ff2b13)

  • serviceAccountKeyName, serviceAccountDelegationInfo, and principalSubject attributes added to the existing access attribute (#375) (ab477e0)

1.14.0 (2022-08-22)

Features

  • Adding uris to indicator of compromise (IOC) field (#367) (1f7f8c0)

1.13.0 (2022-08-12)

Features

  • Added container field to findings attributes (#353) (027a423)

  • Added kubernetes field to findings attribute. This field is populated only when the container is a kubernetes cluster explicitly (027a423)

Bug Fixes

  • deps: allow protobuf < 5.0.0 (#362) (eb521a8)

  • deps: require proto-plus >= 1.22.0 (eb521a8)

1.12.0 (2022-07-17)

Features

  • add audience parameter (da12a93)

  • Add compliances, processes and exfiltration fields to findings attributes (da12a93)

  • Added contacts field to findings attributes, specifying Essential Contacts defined at org, folder or project level within a GCP org (da12a93)

  • Added process signature fields to the indicator attribute that helps surface multiple types of signature defined IOCs (da12a93)

Bug Fixes

  • deps: require google-api-core>=1.32.0,>=2.8.0 (da12a93)

  • require python 3.7+ (#349) (1368f74)

1.11.1 (2022-06-06)

Bug Fixes

Documentation

  • fix changelog header to consistent size (#338) (60c8d5f)

1.11.0 (2022-04-28)

Features

  • Add connection and description field to finding’s list of attributes (#323) (3a9e9bd)

  • Add next_steps field to finding’s list of attributes (#319) (35ab26e)

  • AuditConfig for IAM v1 (35ab26e)

Bug Fixes

  • deps: require grpc-google-iam-v1 >=0.12.4 (35ab26e)

Documentation

  • fix type in docstring for map fields (35ab26e)

  • samples: add bigquery export samples (#315) (beec49d)

  • samples: added mute config samples (#276) (3ac8eac)

  • samples: included snippet for unmute finding (#308) (fe05cc3)

1.10.0 (2022-03-05)

Features

Bug Fixes

  • deps: require google-api-core>=1.31.5, >=2.3.2 (#293) (ae90fee)

  • deps: require proto-plus>=1.15.0 (ae90fee)

1.9.0 (2022-02-26)

Features

Bug Fixes

  • resolve DuplicateCredentialArgs error when using credentials_file (7fdd2a8)

Documentation

  • added more clarification around what event_time means on a v1 finding (7fdd2a8)

  • Update documentation for the Finding resource field “project_display_name” (#282) (5e02432)

  • Update documentation for the Mute fields on Findings (5e02432)

1.8.0 (2022-01-14)

Features

  • add display_name to the resource which is surfaced in NotificationMessage (f28a8fe)

  • add support for python 3.10 (#238) (7186526)

  • Added a new API method UpdateExternalSystem (#256) (8c988a6)

  • Added mute related APIs, proto messages and fields (#255) (6f3e1b2)

  • Added resource type and display_name field to the FindingResult (#248) (f28a8fe)

Bug Fixes

  • deps: drop packaging dependency (f28a8fe)

  • deps: require google-api-core >= 1.28.0 (f28a8fe)

  • fix extras_require typo in setup.py (#242) (d477b96)

1.7.0 (2021-10-08)

Features

  • Added type field to the resource which is surfaced in NotificationMessage (a233f7a)

  • Added vulnerability field to Finding (#235) (a233f7a)

1.6.0 (2021-10-07)

Features

  • add context manager support in client (#230) (740af33)

1.5.2 (2021-09-30)

Bug Fixes

  • improper types in pagers generation (cd17b59)

1.5.1 (2021-09-24)

Bug Fixes

  • add ‘dict’ annotation type to ‘request’ (00fb3d3)

1.5.0 (2021-07-28)

Features

  • add finding_class and indicator fields in Finding (#201) (4af011d)

Bug Fixes

  • deps: pin ‘google-{api,cloud}-core’, ‘google-auth’ to allow 2.x versions (#194) (37af051)

  • enable self signed jwt for grpc (#199) (a00be7c)

Documentation

  • add Samples section to CONTRIBUTING.rst (#195) (8f402c2)

1.4.0 (2021-07-12)

Features

Bug Fixes

Documentation

1.3.1 (2021-06-10)

Documentation

  • update currently supported Finding filter fields (#159) (89ca24b)

1.3.0 (2021-05-28)

Features

  • bump release level to production/stable (#147) (b9c892a)

Documentation

1.2.0 (2021-05-19)

Features

  • add canonical_name and folder fields (16a33f4)

  • support self-signed JWT flow for service accounts (16a33f4)

Bug Fixes

  • add async client to %name_%version/init.py (16a33f4)

  • fix retry deadlines (#116) (15c28e8)

Documentation

  • Fix conflict tag introduced in PR 104 (#106) (f4f14ee)

  • standardize new tag with existing tags from other languages (#104) (55582ac)

1.1.0 (2020-12-15)

Features

Documentation

  • add securitycenter prefix to samples, wrap published samples and repl… (#85) (553dfbb)

  • update documentation on severity (#72) (4ba96b2)

  • update snippets_findings tags (#78) (c7e301f)

  • update snippets_list_assets tags (#77) (11aef56)

1.0.0 (2020-10-08)

⚠ BREAKING CHANGES

Features

0.7.1 (2020-09-18)

Bug Fixes

0.7.0 (2020-09-10)

Features

  • add field severity to findings; update retry configs (#53) (80494a9)

Documentation

  • Update Security Command Center UpdateNotificationConfig sample, adding filter to mutable field (#39) (c70d790)

0.6.0 (2020-07-01)

Features

  • add security_marks_path method; fix docstring links (via synth) (#24) (80ce6e6)

  • add Resource to the v1 NotificationMessage (#33) (c930e6a)

Documentation

  • Update notification samples to v1 (#19) (5eba984)

0.5.0 (2020-03-10)

Features

  • add support for notification configs to v1 (#15) (9720fa4)

0.4.0 (2020-02-13)

Features

  • add v1p1beta1; add resource_display_name, resource_parent_display_name, resource_project_display_nametov1.Asset.SecurityCenterProperties; add output only field resourcetov1.ListFindingsResponse.ListFindingsResult; increase initial_rpc_timeout_millis` in default config for v1; standardize use of ‘required’ and ‘optional’ in docstrings; add 2.7 deprecation warning; bump copyright year to 2020 (#7) (03e172b)

0.3.0

07-24-2019 17:29 PDT

Implementation Changes

  • Allow kwargs to be passed to create_channel, update templates (via synth). (#8402)

  • Update return type of run_asset_discovery (via synth). (#8032)

  • Security Center: Add routing header to method metadata (via synth). (#7589)

  • Remove classifier for Python 3.4 for end-of-life. (#7535)

New Features

  • Add ‘options_’ argument to clients’ ‘get_iam_policy’; pin black version (via synth). (#8658)

  • Add ‘client_options’ support, update list method docstrings (via synth). (#8521)

Dependencies

  • Bump minimum version for google-api-core to 1.14.0. (#8709)

  • Update pin for ‘grpc-google-iam-v1’ to 0.12.3+. (#8647)

Documentation

  • Link to googleapis.dev documentation in READMEs. (#8705)

  • Update docstrings (via synth). (#8711)

  • Add compatibility check badges to READMEs. (#8288)

  • Docstring changes (via synth). (#7704)

  • Add Snippets for security center list_assets call (#7538)

Internal / Testing Changes

  • Add docs job to publish to googleapis.dev. (#8464)

  • Declare encoding as utf-8 in pb2 files (via synth). (#8362)

  • Add disclaimer to auto-generated template files (via synth).(#8326)

  • Fix coverage in ‘types.py’ (via synth). (#8163)

  • Add empty lines (via synth). (#8070)

  • Add nox session docs, reorder methods (via synth). (#7780)

  • Use alabaster theme everwhere. (#8021)

  • Add Ruby package configuration in protos (via synth). (#7741)

  • proto file housekeeping FBO PHP (via synth).

0.2.0

03-12-2019 17:09 PDT

Implementation Changes

  • Remove ‘having’ filter arguments from query methods (via synth). #7511)

  • Remove unused message exports. (#7274)

  • Trivial gapic-generator change. (#7233)

  • Protoc-generated serialization update, docstring tweak. (#7094)

New Features

  • Add support for v1 API. (#7495)

Documentation

  • googlecloudplatform –> googleapis in READMEs (#7411)

  • Updated client library documentation URLs. (#7307)

  • Update copyright headers

  • Docstring update from .proto file. (#7056)

  • Fix 404 for ‘Client Library Documentation’ link. (#7041)

  • Pick up stub docstring fix in GAPIC generator. (#6981)

Internal / Testing Changes

  • Proto file housekeeping FBO C# (via synth). (#7502)

  • Copy lintified proto files (via synth). (#7470)

  • Add clarifying comment to blacken nox target. (#7402)

  • Add protos as an artifact to library (#7205)

0.1.1

12-18-2018 09:45 PST

Implementation Changes

  • Import iam.policy from google.api_core. (#6741)

  • Pick up changes to GAPIC generator. (#6506)

  • Assorted synth fixups / cleanups (#6400)

  • Fix client_info bug, update docstrings via synth. (#6438)

Dependencies

  • Bump minimum api_core version for all GAPIC libs to 1.4.1. (#6391)

Documentation

  • Document Python 2 deprecation (#6910)

  • Docstring changes via synth. (#6473)

Internal / Testing Changes

  • Add baseline for synth.metadata

  • Update noxfile.

  • Blacken all gen’d libs (#6792)

  • Omit local deps (#6701)

  • Run black at end of synth.py (#6698)

  • Run Black on Generated libraries (#6666)

  • Add templates for flake8, coveragerc, noxfile, and black. (#6642)

  • Overlooked synth changes. (#6439)

0.1.0

11-01-2018 15:12 PDT

New Features

  • Generate Security Center Client Library (#6356)