add samples for using a regional endpoint with SCC v2 API

The SCC API can be accessed via Regional Endpoints to meet customer data residency requirements. This sample shows how to override the endpoint for an API client. See https://cloud.google.com/security-command-center/docs/data-residency-support.md#regional-urls for more information on data residency

Combine rep sample with findings samples

Fixed lint issues

Update regional_endpoint_snippet_test.py

Update regional_endpoint_snippet_test.py

Author: onagbonoga

securitycenter/snippets/noxfile_config.py

@@ -32,6 +32,7 @@
     # A dictionary you want to inject into your test. Don't put any
     # secrets here. These values will override predefined values.
     "envs": {
+        "DRZ_SA_ORGANIZATION": "172173830708",
         "GCLOUD_ORGANIZATION": "1081635000895",
         "GCLOUD_PROJECT": "project-a-id",
         "GCLOUD_PUBSUB_TOPIC": "projects/project-a-id/topics/notifications-sample-topic",

securitycenter/snippets_v2/snippets_findings_v2.py

@@ -55,6 +55,37 @@ def list_all_findings(organization_id, source_name, location_id) -> int:
 # [END securitycenter_list_all_findings_v2]
 
 
+# [START securitycenter_regional_endpoint_list_findings]
+def rep_list_finding(parent, endpoint) -> int:
+    """
+    lists all findings for a parent
+    Args:
+        parent: Parent resource for which findings to be listed. Must be in one of the following formats:
+                "organizations/{organization_id}/sources/{sources}/locations/{location}"
+                "projects/{project_id}/sources/{sources}/locations/{location}"
+                "folders/{folder_id}/sources/{sources}/locations/{location}"
+        endpoint: Endpoint for this request. For example "securitycenter.googleapis.com", "securitycenter.me-central2.rep.googleapis.com"
+    Returns:
+        int: return the count of all findings for a source
+    """
+    from google.cloud import securitycenter_v2 as securitycenter
+    from google.api_core.client_options import ClientOptions
+    # Override endpoint and create a client.
+    options = ClientOptions(api_endpoint=endpoint)
+    client = securitycenter.SecurityCenterClient(client_options=options)
+
+    finding_result_iterator = client.list_findings(request={"parent": parent})
+    for count, finding_result in enumerate(finding_result_iterator):
+        print(
+            "{}: name: {} resource: {}".format(
+                count, finding_result.finding.name, finding_result.finding.resource_name
+            )
+        )
+    return count
+
+# [END securitycenter_regional_endpoint_list_findings]
+
+
 # [START securitycenter_list_filtered_findings_v2]
 def list_filtered_findings(organization_id, source_name, location_id) -> int:
     """

securitycenter/snippets_v2/snippets_findings_v2_test.py

@@ -85,6 +85,15 @@ def finding_name(source_name):
     return finding.name
 
 
+@pytest.fixture(scope="module")
+def rep_parent():
+    return f"{(os.environ['DRZ_SA_ORGANIZATION'])}/sources/-/locations/sa"
+
+
+def endpoint():
+    return "securitycenter.me-central2.rep.googleapis.com"
+
+
 def test_list_all_findings(organization_id, finding_name, source_name):
     finding_result_iterator = snippets_findings_v2.list_all_findings(
         organization_id, source_name.split("/")[-1], "global"
@@ -96,6 +105,11 @@ def test_list_all_findings(organization_id, finding_name, source_name):
     assert finding_name in names
 
 
+def test_rep_list_finding():
+    count = snippets_findings_v2.rep_list_finding(rep_parent, endpoint)
+    assert count > 0
+
+
 def test_list_filtered_findings(organization_id):
     count = snippets_findings_v2.list_filtered_findings(organization_id, "-", "global")
     assert count > 0