google-identity-access_context_manager-v1 0.1.0

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

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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/{access_policy}/accessLevels/{access_level}`. The maximum
+        #     length of the `access_level` 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 2021 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/{access_policy}`
+        # @!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/gcp_user_access_binding.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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
+        # Restricts access to Cloud Console and Google Cloud APIs for a set of users
+        # using Context-Aware Access.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Immutable. Assigned by the server during creation. The last segment has an arbitrary
+        #     length and has only URI unreserved characters (as defined by
+        #     [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)).
+        #     Should not be specified by the client during creation.
+        #     Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
+        # @!attribute [rw] group_key
+        #   @return [::String]
+        #     Required. Immutable. Google Group id whose members are subject to this binding's restrictions.
+        #     See "id" in the [G Suite Directory API's Groups resource]
+        #     (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource).
+        #     If a group's email address/alias is changed, this resource will continue
+        #     to point at the changed group. This field does not accept group email
+        #     addresses or aliases.
+        #     Example: "01d520gv4vjcrht"
+        # @!attribute [rw] access_levels
+        #   @return [::Array<::String>]
+        #     Required. Access level that a user must have to be granted access. Only one access
+        #     level is supported, not multiple. This repeated field must have exactly
+        #     one element.
+        #     Example: "accessPolicies/9522/accessLevels/device_trusted"
+        class GcpUserAccessBinding
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end