google-cloud-asset-v1 0.1.0 → 0.2.0

data/proto_docs/google/identity/accesscontextmanager/type/device_resources.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Identity
+    module AccessContextManager
+      module Type
+        # The encryption state of the device.
+        module DeviceEncryptionStatus
+          # The encryption status of the device is not specified or not known.
+          ENCRYPTION_UNSPECIFIED = 0
+
+          # The device does not support encryption.
+          ENCRYPTION_UNSUPPORTED = 1
+
+          # The device supports encryption, but is currently unencrypted.
+          UNENCRYPTED = 2
+
+          # The device is encrypted.
+          ENCRYPTED = 3
+        end
+
+        # The operating system type of the device.
+        # Next id: 7
+        module OsType
+          # The operating system of the device is not specified or not known.
+          OS_UNSPECIFIED = 0
+
+          # A desktop Mac operating system.
+          DESKTOP_MAC = 1
+
+          # A desktop Windows operating system.
+          DESKTOP_WINDOWS = 2
+
+          # A desktop Linux operating system.
+          DESKTOP_LINUX = 3
+
+          # A desktop ChromeOS operating system.
+          DESKTOP_CHROME_OS = 6
+
+          # An Android operating system.
+          ANDROID = 4
+
+          # An iOS operating system.
+          IOS = 5
+        end
+
+        # The degree to which the device is managed by the Cloud organization.
+        module DeviceManagementLevel
+          # The device's management level is not specified or not known.
+          MANAGEMENT_UNSPECIFIED = 0
+
+          # The device is not managed.
+          NONE = 1
+
+          # Basic management is enabled, which is generally limited to monitoring and
+          # wiping the corporate account.
+          BASIC = 2
+
+          # Complete device management. This includes more thorough monitoring and the
+          # ability to directly manage the device (such as remote wiping). This can be
+          # enabled through the Android Enterprise Platform.
+          COMPLETE = 3
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/identity/accesscontextmanager/v1/access_level.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Identity
+    module AccessContextManager
+      module V1
+        # An `AccessLevel` is a label that can be applied to requests to Google Cloud
+        # services, along with a list of requirements necessary for the label to be
+        # applied.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. Resource name for the Access Level. The `short_name` component
+        #     must begin with a letter and only include alphanumeric and '_'. Format:
+        #     `accessPolicies/{policy_id}/accessLevels/{short_name}`. The maximum length
+        #     of the `short_name` component is 50 characters.
+        # @!attribute [rw] title
+        #   @return [String]
+        #     Human readable title. Must be unique within the Policy.
+        # @!attribute [rw] description
+        #   @return [String]
+        #     Description of the `AccessLevel` and its use. Does not affect behavior.
+        # @!attribute [rw] basic
+        #   @return [Google::Identity::AccessContextManager::V1::BasicLevel]
+        #     A `BasicLevel` composed of `Conditions`.
+        # @!attribute [rw] custom
+        #   @return [Google::Identity::AccessContextManager::V1::CustomLevel]
+        #     A `CustomLevel` written in the Common Expression Language.
+        # @!attribute [rw] create_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     Output only. Time the `AccessLevel` was created in UTC.
+        # @!attribute [rw] update_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     Output only. Time the `AccessLevel` was updated in UTC.
+        class AccessLevel
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # `BasicLevel` is an `AccessLevel` using a set of recommended features.
+        # @!attribute [rw] conditions
+        #   @return [Array<Google::Identity::AccessContextManager::V1::Condition>]
+        #     Required. A list of requirements for the `AccessLevel` to be granted.
+        # @!attribute [rw] combining_function
+        #   @return [Google::Identity::AccessContextManager::V1::BasicLevel::ConditionCombiningFunction]
+        #     How the `conditions` list should be combined to determine if a request is
+        #     granted this `AccessLevel`. If AND is used, each `Condition` in
+        #     `conditions` must be satisfied for the `AccessLevel` to be applied. If OR
+        #     is used, at least one `Condition` in `conditions` must be satisfied for the
+        #     `AccessLevel` to be applied. Default behavior is AND.
+        class BasicLevel
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+
+          # Options for how the `conditions` list should be combined to determine if
+          # this `AccessLevel` is applied. Default is AND.
+          module ConditionCombiningFunction
+            # All `Conditions` must be true for the `BasicLevel` to be true.
+            AND = 0
+
+            # If at least one `Condition` is true, then the `BasicLevel` is true.
+            OR = 1
+          end
+        end
+
+        # A condition necessary for an `AccessLevel` to be granted. The Condition is an
+        # AND over its fields. So a Condition is true if: 1) the request IP is from one
+        # of the listed subnetworks AND 2) the originating device complies with the
+        # listed device policy AND 3) all listed access levels are granted AND 4) the
+        # request was sent at a time allowed by the DateTimeRestriction.
+        # @!attribute [rw] ip_subnetworks
+        #   @return [Array<String>]
+        #     CIDR block IP subnetwork specification. May be IPv4 or IPv6. Note that for
+        #     a CIDR IP address block, the specified IP address portion must be properly
+        #     truncated (i.e. all the host bits must be zero) or the input is considered
+        #     malformed. For example, "192.0.2.0/24" is accepted but "192.0.2.1/24" is
+        #     not. Similarly, for IPv6, "2001:db8::/32" is accepted whereas
+        #     "2001:db8::1/32" is not. The originating IP of a request must be in one of
+        #     the listed subnets in order for this Condition to be true. If empty, all IP
+        #     addresses are allowed.
+        # @!attribute [rw] device_policy
+        #   @return [Google::Identity::AccessContextManager::V1::DevicePolicy]
+        #     Device specific restrictions, all restrictions must hold for the
+        #     Condition to be true. If not specified, all devices are allowed.
+        # @!attribute [rw] required_access_levels
+        #   @return [Array<String>]
+        #     A list of other access levels defined in the same `Policy`, referenced by
+        #     resource name. Referencing an `AccessLevel` which does not exist is an
+        #     error. All access levels listed must be granted for the Condition
+        #     to be true. Example:
+        #     "`accessPolicies/MY_POLICY/accessLevels/LEVEL_NAME"`
+        # @!attribute [rw] negate
+        #   @return [Boolean]
+        #     Whether to negate the Condition. If true, the Condition becomes a NAND over
+        #     its non-empty fields, each field must be false for the Condition overall to
+        #     be satisfied. Defaults to false.
+        # @!attribute [rw] members
+        #   @return [Array<String>]
+        #     The request must be made by one of the provided user or service
+        #     accounts. Groups are not supported.
+        #     Syntax:
+        #     `user:{emailid}`
+        #     `serviceAccount:{emailid}`
+        #     If not specified, a request may come from any user.
+        # @!attribute [rw] regions
+        #   @return [Array<String>]
+        #     The request must originate from one of the provided countries/regions.
+        #     Must be valid ISO 3166-1 alpha-2 codes.
+        class Condition
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # `CustomLevel` is an `AccessLevel` using the Cloud Common Expression Language
+        # to represent the necessary conditions for the level to apply to a request.
+        # See CEL spec at: https://github.com/google/cel-spec
+        # @!attribute [rw] expr
+        #   @return [Google::Type::Expr]
+        #     Required. A Cloud CEL expression evaluating to a boolean.
+        class CustomLevel
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # `DevicePolicy` specifies device specific restrictions necessary to acquire a
+        # given access level. A `DevicePolicy` specifies requirements for requests from
+        # devices to be granted access levels, it does not do any enforcement on the
+        # device. `DevicePolicy` acts as an AND over all specified fields, and each
+        # repeated field is an OR over its elements. Any unset fields are ignored. For
+        # example, if the proto is { os_type : DESKTOP_WINDOWS, os_type :
+        # DESKTOP_LINUX, encryption_status: ENCRYPTED}, then the DevicePolicy will be
+        # true for requests originating from encrypted Linux desktops and encrypted
+        # Windows desktops.
+        # @!attribute [rw] require_screenlock
+        #   @return [Boolean]
+        #     Whether or not screenlock is required for the DevicePolicy to be true.
+        #     Defaults to `false`.
+        # @!attribute [rw] allowed_encryption_statuses
+        #   @return [Array<Google::Identity::AccessContextManager::Type::DeviceEncryptionStatus>]
+        #     Allowed encryptions statuses, an empty list allows all statuses.
+        # @!attribute [rw] os_constraints
+        #   @return [Array<Google::Identity::AccessContextManager::V1::OsConstraint>]
+        #     Allowed OS versions, an empty list allows all types and all versions.
+        # @!attribute [rw] allowed_device_management_levels
+        #   @return [Array<Google::Identity::AccessContextManager::Type::DeviceManagementLevel>]
+        #     Allowed device management levels, an empty list allows all management
+        #     levels.
+        # @!attribute [rw] require_admin_approval
+        #   @return [Boolean]
+        #     Whether the device needs to be approved by the customer admin.
+        # @!attribute [rw] require_corp_owned
+        #   @return [Boolean]
+        #     Whether the device needs to be corp owned.
+        class DevicePolicy
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A restriction on the OS type and version of devices making requests.
+        # @!attribute [rw] os_type
+        #   @return [Google::Identity::AccessContextManager::Type::OsType]
+        #     Required. The allowed OS type.
+        # @!attribute [rw] minimum_version
+        #   @return [String]
+        #     The minimum allowed OS version. If not set, any version of this OS
+        #     satisfies the constraint. Format: `"major.minor.patch"`.
+        #     Examples: `"10.5.301"`, `"9.2.1"`.
+        # @!attribute [rw] require_verified_chrome_os
+        #   @return [Boolean]
+        #     Only allows requests from devices with a verified Chrome OS.
+        #     Verifications includes requirements that the device is enterprise-managed,
+        #     conformant to domain policies, and the caller has permission to call
+        #     the API targeted by the request.
+        class OsConstraint
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/identity/accesscontextmanager/v1/access_policy.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Identity
+    module AccessContextManager
+      module V1
+        # `AccessPolicy` is a container for `AccessLevels` (which define the necessary
+        # attributes to use Google Cloud services) and `ServicePerimeters` (which
+        # define regions of services able to freely pass data within a perimeter). An
+        # access policy is globally visible within an organization, and the
+        # restrictions it specifies apply to all projects within an organization.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Output only. Resource name of the `AccessPolicy`. Format:
+        #     `accessPolicies/{policy_id}`
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The parent of this `AccessPolicy` in the Cloud Resource
+        #     Hierarchy. Currently immutable once created. Format:
+        #     `organizations/{organization_id}`
+        # @!attribute [rw] title
+        #   @return [String]
+        #     Required. Human readable title. Does not affect behavior.
+        # @!attribute [rw] create_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     Output only. Time the `AccessPolicy` was created in UTC.
+        # @!attribute [rw] update_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     Output only. Time the `AccessPolicy` was updated in UTC.
+        # @!attribute [rw] etag
+        #   @return [String]
+        #     Output only. An opaque identifier for the current version of the
+        #     `AccessPolicy`. This will always be a strongly validated etag, meaning that
+        #     two Access Polices will be identical if and only if their etags are
+        #     identical. Clients should not expect this to be in any specific format.
+        class AccessPolicy
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/identity/accesscontextmanager/v1/service_perimeter.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Identity
+    module AccessContextManager
+      module V1
+        # `ServicePerimeter` describes a set of Google Cloud resources which can freely
+        # import and export data amongst themselves, but not export outside of the
+        # `ServicePerimeter`. If a request with a source within this `ServicePerimeter`
+        # has a target outside of the `ServicePerimeter`, the request will be blocked.
+        # Otherwise the request is allowed. There are two types of Service Perimeter -
+        # Regular and Bridge. Regular Service Perimeters cannot overlap, a single
+        # Google Cloud project can only belong to a single regular Service Perimeter.
+        # Service Perimeter Bridges can contain only Google Cloud projects as members,
+        # a single Google Cloud project may belong to multiple Service Perimeter
+        # Bridges.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. Resource name for the ServicePerimeter.  The `short_name`
+        #     component must begin with a letter and only include alphanumeric and '_'.
+        #     Format: `accessPolicies/{policy_id}/servicePerimeters/{short_name}`
+        # @!attribute [rw] title
+        #   @return [String]
+        #     Human readable title. Must be unique within the Policy.
+        # @!attribute [rw] description
+        #   @return [String]
+        #     Description of the `ServicePerimeter` and its use. Does not affect
+        #     behavior.
+        # @!attribute [rw] create_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     Output only. Time the `ServicePerimeter` was created in UTC.
+        # @!attribute [rw] update_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     Output only. Time the `ServicePerimeter` was updated in UTC.
+        # @!attribute [rw] perimeter_type
+        #   @return [Google::Identity::AccessContextManager::V1::ServicePerimeter::PerimeterType]
+        #     Perimeter type indicator. A single project is
+        #     allowed to be a member of single regular perimeter, but multiple service
+        #     perimeter bridges. A project cannot be a included in a perimeter bridge
+        #     without being included in regular perimeter. For perimeter bridges,
+        #     the restricted service list as well as access level lists must be
+        #     empty.
+        # @!attribute [rw] status
+        #   @return [Google::Identity::AccessContextManager::V1::ServicePerimeterConfig]
+        #     Current ServicePerimeter configuration. Specifies sets of resources,
+        #     restricted services and access levels that determine perimeter
+        #     content and boundaries.
+        # @!attribute [rw] spec
+        #   @return [Google::Identity::AccessContextManager::V1::ServicePerimeterConfig]
+        #     Proposed (or dry run) ServicePerimeter configuration. This configuration
+        #     allows to specify and test ServicePerimeter configuration without enforcing
+        #     actual access restrictions. Only allowed to be set when the
+        #     "use_explicit_dry_run_spec" flag is set.
+        # @!attribute [rw] use_explicit_dry_run_spec
+        #   @return [Boolean]
+        #     Use explicit dry run spec flag. Ordinarily, a dry-run spec implicitly
+        #     exists  for all Service Perimeters, and that spec is identical to the
+        #     status for those Service Perimeters. When this flag is set, it inhibits the
+        #     generation of the implicit spec, thereby allowing the user to explicitly
+        #     provide a configuration ("spec") to use in a dry-run version of the Service
+        #     Perimeter. This allows the user to test changes to the enforced config
+        #     ("status") without actually enforcing them. This testing is done through
+        #     analyzing the differences between currently enforced and suggested
+        #     restrictions. use_explicit_dry_run_spec must bet set to True if any of the
+        #     fields in the spec are set to non-default values.
+        class ServicePerimeter
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+
+          # Specifies the type of the Perimeter. There are two types: regular and
+          # bridge. Regular Service Perimeter contains resources, access levels, and
+          # restricted services. Every resource can be in at most ONE
+          # regular Service Perimeter.
+          #
+          # In addition to being in a regular service perimeter, a resource can also
+          # be in zero or more perimeter bridges.  A perimeter bridge only contains
+          # resources.  Cross project operations are permitted if all effected
+          # resources share some perimeter (whether bridge or regular). Perimeter
+          # Bridge does not contain access levels or services: those are governed
+          # entirely by the regular perimeter that resource is in.
+          #
+          # Perimeter Bridges are typically useful when building more complex toplogies
+          # with many independent perimeters that need to share some data with a common
+          # perimeter, but should not be able to share data among themselves.
+          module PerimeterType
+            # Regular Perimeter.
+            PERIMETER_TYPE_REGULAR = 0
+
+            # Perimeter Bridge.
+            PERIMETER_TYPE_BRIDGE = 1
+          end
+        end
+
+        # `ServicePerimeterConfig` specifies a set of Google Cloud resources that
+        # describe specific Service Perimeter configuration.
+        # @!attribute [rw] resources
+        #   @return [Array<String>]
+        #     A list of Google Cloud resources that are inside of the service perimeter.
+        #     Currently only projects are allowed. Format: `projects/{project_number}`
+        # @!attribute [rw] access_levels
+        #   @return [Array<String>]
+        #     A list of `AccessLevel` resource names that allow resources within the
+        #     `ServicePerimeter` to be accessed from the internet. `AccessLevels` listed
+        #     must be in the same policy as this `ServicePerimeter`. Referencing a
+        #     nonexistent `AccessLevel` is a syntax error. If no `AccessLevel` names are
+        #     listed, resources within the perimeter can only be accessed via Google
+        #     Cloud calls with request origins within the perimeter. Example:
+        #     `"accessPolicies/MY_POLICY/accessLevels/MY_LEVEL"`.
+        #     For Service Perimeter Bridge, must be empty.
+        # @!attribute [rw] restricted_services
+        #   @return [Array<String>]
+        #     Google Cloud services that are subject to the Service Perimeter
+        #     restrictions. For example, if `storage.googleapis.com` is specified, access
+        #     to the storage buckets inside the perimeter must meet the perimeter's
+        #     access restrictions.
+        # @!attribute [rw] vpc_accessible_services
+        #   @return [Google::Identity::AccessContextManager::V1::ServicePerimeterConfig::VpcAccessibleServices]
+        #     Configuration for APIs allowed within Perimeter.
+        class ServicePerimeterConfig
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+
+          # Specifies how APIs are allowed to communicate within the Service
+          # Perimeter.
+          # @!attribute [rw] enable_restriction
+          #   @return [Boolean]
+          #     Whether to restrict API calls within the Service Perimeter to the list of
+          #     APIs specified in 'allowed_services'.
+          # @!attribute [rw] allowed_services
+          #   @return [Array<String>]
+          #     The list of APIs usable within the Service Perimeter. Must be empty
+          #     unless 'enable_restriction' is True.
+          class VpcAccessibleServices
+            include Google::Protobuf::MessageExts
+            extend Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end