source.proto 2.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. // Copyright 2021 Google LLC
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. syntax = "proto3";
  15. package google.cloud.securitycenter.v1;
  16. import "google/api/resource.proto";
  17. import "google/api/annotations.proto";
  18. option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
  19. option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
  20. option java_multiple_files = true;
  21. option java_package = "com.google.cloud.securitycenter.v1";
  22. option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
  23. option ruby_package = "Google::Cloud::SecurityCenter::V1";
  24. // Security Command Center finding source. A finding source
  25. // is an entity or a mechanism that can produce a finding. A source is like a
  26. // container of findings that come from the same scanner, logger, monitor, and
  27. // other tools.
  28. message Source {
  29. option (google.api.resource) = {
  30. type: "securitycenter.googleapis.com/Source"
  31. pattern: "organizations/{organization}/sources/{source}"
  32. pattern: "folders/{folder}/sources/{source}"
  33. pattern: "projects/{project}/sources/{source}"
  34. };
  35. // The relative resource name of this source. See:
  36. // https://cloud.google.com/apis/design/resource_names#relative_resource_name
  37. // Example:
  38. // "organizations/{organization_id}/sources/{source_id}"
  39. string name = 1;
  40. // The source's display name.
  41. // A source's display name must be unique amongst its siblings, for example,
  42. // two sources with the same parent can't share the same display name.
  43. // The display name must have a length between 1 and 64 characters
  44. // (inclusive).
  45. string display_name = 2;
  46. // The description of the source (max of 1024 characters).
  47. // Example:
  48. // "Web Security Scanner is a web security scanner for common
  49. // vulnerabilities in App Engine applications. It can automatically
  50. // scan and detect four common vulnerabilities, including cross-site-scripting
  51. // (XSS), Flash injection, mixed content (HTTP in HTTPS), and
  52. // outdated or insecure libraries."
  53. string description = 3;
  54. // The canonical name of the finding. It's either
  55. // "organizations/{organization_id}/sources/{source_id}",
  56. // "folders/{folder_id}/sources/{source_id}" or
  57. // "projects/{project_number}/sources/{source_id}",
  58. // depending on the closest CRM ancestor of the resource associated with the
  59. // finding.
  60. string canonical_name = 14;
  61. }