feat(securitycenter): Add Resource SCC Management API Org ETD Custom Module code samples (Create, Delete, List, Get)

security-command-center/snippets/src/main/java/management/api/CreateEventThreatDetectionCustomModule.java

@@ -0,0 +1,98 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package management.api;
+
+// [START securitycenter_create_event_threat_detection_custom_module]
+import com.google.cloud.securitycentermanagement.v1.CreateEventThreatDetectionCustomModuleRequest;
+import com.google.cloud.securitycentermanagement.v1.EventThreatDetectionCustomModule;
+import com.google.cloud.securitycentermanagement.v1.EventThreatDetectionCustomModule.EnablementState;
+import com.google.cloud.securitycentermanagement.v1.SecurityCenterManagementClient;
+import com.google.protobuf.ListValue;
+import com.google.protobuf.Struct;
+import com.google.protobuf.Value;
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.Map;
+
+public class CreateEventThreatDetectionCustomModule {
+
+  public static void main(String[] args) throws IOException {
+    // https://cloud.google.com/security-command-center/docs/reference/security-center-management/rest/v1/organizations.locations.eventThreatDetectionCustomModules/create
+    // TODO: Developer should replace project_id with a real project ID before running this code
+    String projectId = "project_id";
+
+    String customModuleDisplayName = "custom_module_display_name";
+
+    createEventThreatDetectionCustomModule(projectId, customModuleDisplayName);
+  }
+
+  public static EventThreatDetectionCustomModule createEventThreatDetectionCustomModule(
+      String projectId, String customModuleDisplayName) throws IOException {
+
+    // Initialize client that will be used to send requests. This client only needs
+    // to be created
+    // once, and can be reused for multiple requests.
+    try (SecurityCenterManagementClient client = SecurityCenterManagementClient.create()) {
+
+      // define the metadata and other config parameters severity, description,
+      // recommendation and ips below
+      Map<String, Value> metadata = new HashMap<>();
+      metadata.put("severity", Value.newBuilder().setStringValue("MEDIUM").build());
+      metadata.put(
+          "description", Value.newBuilder().setStringValue("add your description here").build());
+      metadata.put(
+          "recommendation",
+          Value.newBuilder().setStringValue("add your recommendation here").build());
+      Struct metadataStruct = Struct.newBuilder().putAllFields(metadata).build();
+
+      Struct configStruct =
+          Struct.newBuilder()
+              .putFields("metadata", Value.newBuilder().setStructValue(metadataStruct).build())
+              .putFields(
+                  "ips",
+                  Value.newBuilder()
+                      .setListValue(
+                          ListValue.newBuilder()
+                              .addValues(Value.newBuilder().setStringValue("0.0.0.0").build())
+                              .build())
+                      .build())
+              .build();
+
+      // define the Event Threat Detection custom module configuration, update the EnablementState
+      // below
+      EventThreatDetectionCustomModule eventThreatDetectionCustomModule =
+          EventThreatDetectionCustomModule.newBuilder()
+              .setConfig(configStruct)
+              .setDisplayName(customModuleDisplayName)
+              .setEnablementState(EnablementState.ENABLED)
+              .setType("CONFIGURABLE_BAD_IP")
+              .build();
+
+      CreateEventThreatDetectionCustomModuleRequest request =
+          CreateEventThreatDetectionCustomModuleRequest.newBuilder()
+              .setParent(String.format("projects/%s/locations/global", projectId))
+              .setEventThreatDetectionCustomModule(eventThreatDetectionCustomModule)
+              .build();
+
+      EventThreatDetectionCustomModule response =
+          client.createEventThreatDetectionCustomModule(request);
+
+      return response;
+    }
+  }
+}
+// [END securitycenter_create_event_threat_detection_custom_module]

security-command-center/snippets/src/main/java/management/api/DeleteEventThreatDetectionCustomModule.java

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package management.api;
+
+// [START securitycenter_delete_event_threat_detection_custom_module]
+import com.google.cloud.securitycentermanagement.v1.DeleteEventThreatDetectionCustomModuleRequest;
+import com.google.cloud.securitycentermanagement.v1.SecurityCenterManagementClient;
+import java.io.IOException;
+
+public class DeleteEventThreatDetectionCustomModule {
+
+  public static void main(String[] args) throws IOException {
+    // https://cloud.google.com/security-command-center/docs/reference/security-center-management/rest/v1/organizations.locations.eventThreatDetectionCustomModules/delete
+    // TODO: Developer should replace project_id with a real project ID before running this code
+    String projectId = "project_id";
+
+    String customModuleId = "custom_module_id";
+
+    deleteEventThreatDetectionCustomModule(projectId, customModuleId);
+  }
+
+  public static boolean deleteEventThreatDetectionCustomModule(
+      String projectId, String customModuleId) throws IOException {
+
+    // Initialize client that will be used to send requests. This client only needs
+    // to be created
+    // once, and can be reused for multiple requests.
+    try (SecurityCenterManagementClient client = SecurityCenterManagementClient.create()) {
+
+      String name =
+          String.format(
+              "projects/%s/locations/global/eventThreatDetectionCustomModules/%s",
+              projectId, customModuleId);
+
+      DeleteEventThreatDetectionCustomModuleRequest request =
+          DeleteEventThreatDetectionCustomModuleRequest.newBuilder().setName(name).build();
+
+      client.deleteEventThreatDetectionCustomModule(request);
+
+      return true;
+    }
+  }
+}
+// [END securitycenter_delete_event_threat_detection_custom_module]

security-command-center/snippets/src/main/java/management/api/GetEventThreatDetectionCustomModule.java

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package management.api;
+
+// [START securitycenter_get_event_threat_detection_custom_module]
+import com.google.cloud.securitycentermanagement.v1.EventThreatDetectionCustomModule;
+import com.google.cloud.securitycentermanagement.v1.GetEventThreatDetectionCustomModuleRequest;
+import com.google.cloud.securitycentermanagement.v1.SecurityCenterManagementClient;
+import java.io.IOException;
+
+public class GetEventThreatDetectionCustomModule {
+
+  public static void main(String[] args) throws IOException {
+    // https://cloud.google.com/security-command-center/docs/reference/security-center-management/rest/v1/organizations.locations.eventThreatDetectionCustomModules/get
+    // TODO: Developer should replace project_id with a real project ID before running this code
+    String projectId = "project_id";
+
+    String customModuleId = "custom_module_id";
+
+    getEventThreatDetectionCustomModule(projectId, customModuleId);
+  }
+
+  public static EventThreatDetectionCustomModule getEventThreatDetectionCustomModule(
+      String projectId, String customModuleId) throws IOException {
+
+    // Initialize client that will be used to send requests. This client only needs
+    // to be created
+    // once, and can be reused for multiple requests.
+    try (SecurityCenterManagementClient client = SecurityCenterManagementClient.create()) {
+
+      String name =
+          String.format(
+              "projects/%s/locations/global/eventThreatDetectionCustomModules/%s",
+              projectId, customModuleId);
+
+      GetEventThreatDetectionCustomModuleRequest request =
+          GetEventThreatDetectionCustomModuleRequest.newBuilder().setName(name).build();
+
+      EventThreatDetectionCustomModule response =
+          client.getEventThreatDetectionCustomModule(request);
+
+      return response;
+    }
+  }
+}
+// [END securitycenter_get_event_threat_detection_custom_module]

security-command-center/snippets/src/main/java/management/api/ListEventThreatDetectionCustomModules.java

@@ -0,0 +1,55 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package management.api;
+
+// [START securitycenter_list_event_threat_detection_custom_module]
+import com.google.cloud.securitycentermanagement.v1.ListEventThreatDetectionCustomModulesRequest;
+import com.google.cloud.securitycentermanagement.v1.SecurityCenterManagementClient;
+import com.google.cloud.securitycentermanagement.v1.SecurityCenterManagementClient.ListEventThreatDetectionCustomModulesPagedResponse;
+import java.io.IOException;
+
+public class ListEventThreatDetectionCustomModules {
+
+  public static void main(String[] args) throws IOException {
+    // https://cloud.google.com/security-command-center/docs/reference/security-center-management/rest/v1/organizations.locations.eventThreatDetectionCustomModules/list
+    // TODO: Developer should replace project_id with a real project ID before running this code
+    String projectId = "project_id";
+
+    listEventThreatDetectionCustomModules(projectId);
+  }
+
+  public static ListEventThreatDetectionCustomModulesPagedResponse
+      listEventThreatDetectionCustomModules(String projectId) throws IOException {
+
+    // Initialize client that will be used to send requests. This client only needs
+    // to be created
+    // once, and can be reused for multiple requests.
+    try (SecurityCenterManagementClient client = SecurityCenterManagementClient.create()) {
+
+      ListEventThreatDetectionCustomModulesRequest request =
+          ListEventThreatDetectionCustomModulesRequest.newBuilder()
+              .setParent(String.format("projects/%s/locations/global", projectId))
+              .build();
+
+      ListEventThreatDetectionCustomModulesPagedResponse response =
+          client.listEventThreatDetectionCustomModules(request);
+
+      return response;
+    }
+  }
+}
+// [END securitycenter_list_event_threat_detection_custom_module]