Add ACM policies fine grained resources #8038
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,143 @@ | ||
| # Copyright 2018 Google Inc. | ||
| # 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. | ||
| --- !ruby/object:Api::Resource | ||
| name: 'ServicePerimeterEgressPolicy' | ||
| create_url: '{{perimeter}}' | ||
| base_url: '' | ||
| self_link: '{{perimeter}}' | ||
| create_verb: :PATCH | ||
| delete_verb: :PATCH | ||
| update_mask: true | ||
| identity: | ||
| - egressPolicy | ||
| nested_query: !ruby/object:Api::Resource::NestedQuery | ||
| modify_by_patch: true | ||
| is_list_of_ids: true | ||
| keys: | ||
| - status | ||
| - egressPolicies | ||
| references: !ruby/object:Api::Resource::ReferenceLinks | ||
| api: 'https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters#egresspolicy' | ||
| description: | | ||
| EgressPolicies match requests based on egressFrom and egressTo stanzas. | ||
| For an EgressPolicy to match, both egressFrom and egressTo stanzas must be matched. | ||
| If an EgressPolicy matches a request, the request is allowed to span the ServicePerimeter | ||
| boundary. For example, an EgressPolicy can be used to allow VMs on networks | ||
| within the ServicePerimeter to access a defined set of projects outside the | ||
| perimeter in certain contexts (e.g. to read data from a Cloud Storage bucket | ||
| or query against a BigQuery dataset). | ||
| autogen_async: true | ||
| exclude_validator: true | ||
| # Skipping the sweeper due to the non-standard base_url and because this is fine-grained under ServicePerimeter/IngressPolicy | ||
| skip_sweeper: true | ||
| id_format: '{{perimeter}}' | ||
| import_format: ['{{perimeter}}'] | ||
| custom_code: !ruby/object:Provider::Terraform::CustomCode | ||
| custom_import: templates/terraform/custom_import/access_context_manager_service_perimeter_ingress_policy.go.erb | ||
| parameters: | ||
| - !ruby/object:Api::Type::ResourceRef | ||
| name: 'perimeter' | ||
| resource: 'ServicePerimeter' | ||
| imports: 'name' | ||
| description: | | ||
| The name of the Service Perimeter to add this resource to. | ||
| required: true | ||
| immutable: true | ||
| url_param_only: true | ||
| properties: | ||
| - !ruby/object:Api::Type::NestedObject | ||
| name: 'egressPolicy' | ||
| description: | | ||
| List of EgressPolicies to apply to the perimeter. A perimeter may | ||
| have multiple EgressPolicies, each of which is evaluated separately. | ||
| Access is granted if any EgressPolicy grants it. Must be empty for | ||
| a perimeter bridge. | ||
| properties: | ||
| - !ruby/object:Api::Type::NestedObject | ||
| name: 'egressFrom' | ||
| description: | | ||
| Defines conditions on the source of a request causing this `EgressPolicy` to apply. | ||
| properties: | ||
| - !ruby/object:Api::Type::Enum | ||
| name: 'identityType' | ||
| description: | | ||
| Specifies the type of identities that are allowed access to outside the | ||
| perimeter. If left unspecified, then members of `identities` field will | ||
| be allowed access. | ||
| values: | ||
| - :IDENTITY_TYPE_UNSPECIFIED | ||
| - :ANY_IDENTITY | ||
| - :ANY_USER_ACCOUNT | ||
| - :ANY_SERVICE_ACCOUNT | ||
| - !ruby/object:Api::Type::Array | ||
| name: 'identities' | ||
| description: | | ||
| A list of identities that are allowed access through this `EgressPolicy`. | ||
| Should be in the format of email address. The email address should | ||
| represent individual user or service account only. | ||
| item_type: Api::Type::String | ||
| - !ruby/object:Api::Type::NestedObject | ||
| name: 'egressTo' | ||
| description: | | ||
| Defines the conditions on the `ApiOperation` and destination resources that | ||
| cause this `EgressPolicy` to apply. | ||
| properties: | ||
| - !ruby/object:Api::Type::Array | ||
| name: 'resources' | ||
| item_type: Api::Type::String | ||
| description: | | ||
| A list of resources, currently only projects in the form | ||
| `projects/<projectnumber>`, that match this to stanza. A request matches | ||
| if it contains a resource in this list. If * is specified for resources, | ||
| then this `EgressTo` rule will authorize access to all resources outside | ||
| the perimeter. | ||
| - !ruby/object:Api::Type::Array | ||
| name: 'externalResources' | ||
| item_type: Api::Type::String | ||
| description: | | ||
| A list of external resources that are allowed to be accessed. A request | ||
| matches if it contains an external resource in this list (Example: | ||
| s3://bucket/path). Currently '*' is not allowed. | ||
| - !ruby/object:Api::Type::Array | ||
| name: 'operations' | ||
| description: | | ||
| A list of `ApiOperations` that this egress rule applies to. A request matches | ||
| if it contains an operation/service in this list. | ||
| item_type: !ruby/object:Api::Type::NestedObject | ||
| properties: | ||
| - !ruby/object:Api::Type::String | ||
| name: 'serviceName' | ||
| description: | | ||
| The name of the API whose methods or permissions the `IngressPolicy` or | ||
| `EgressPolicy` want to allow. A single `ApiOperation` with serviceName | ||
| field set to `*` will allow all methods AND permissions for all services. | ||
| - !ruby/object:Api::Type::Array | ||
| name: 'methodSelectors' | ||
| description: | | ||
| API methods or permissions to allow. Method or permission must belong | ||
| to the service specified by `serviceName` field. A single MethodSelector | ||
| entry with `*` specified for the `method` field will allow all methods | ||
| AND permissions for the service specified in `serviceName`. | ||
| item_type: !ruby/object:Api::Type::NestedObject | ||
| properties: | ||
| - !ruby/object:Api::Type::String | ||
| name: 'method' | ||
| description: | | ||
| Value for `method` should be a valid method name for the corresponding | ||
| `serviceName` in `ApiOperation`. If `*` used as value for method, | ||
| then ALL methods and permissions are allowed. | ||
| - !ruby/object:Api::Type::String | ||
| name: 'permission' | ||
| description: | | ||
| Value for permission should be a valid Cloud IAM permission for the | ||
| corresponding `serviceName` in `ApiOperation`. | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,167 @@ | ||||||
| # Copyright 2018 Google Inc. | ||||||
| # 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. | ||||||
| --- !ruby/object:Api::Resource | ||||||
| name: 'ServicePerimeterIngressPolicy' | ||||||
| create_url: '{{perimeter}}' | ||||||
| base_url: '' | ||||||
| self_link: '{{perimeter}}' | ||||||
| create_verb: :PATCH | ||||||
| delete_verb: :PATCH | ||||||
| update_mask: true | ||||||
| identity: | ||||||
| - ingressPolicy | ||||||
| nested_query: !ruby/object:Api::Resource::NestedQuery | ||||||
| modify_by_patch: true | ||||||
| is_list_of_ids: true | ||||||
| keys: | ||||||
| - status | ||||||
| - ingressPolicies | ||||||
| references: !ruby/object:Api::Resource::ReferenceLinks | ||||||
| api: 'https://cloud.google.com/access-context-manager/docs/reference/rest/v1/accessPolicies.servicePerimeters#ingresspolicy' | ||||||
| description: | | ||||||
| IngressPolicies match requests based on ingressFrom and ingressTo stanzas. For an ingress policy to match, | ||||||
| both the ingressFrom and ingressTo stanzas must be matched. If an IngressPolicy matches a request, | ||||||
| the request is allowed through the perimeter boundary from outside the perimeter. | ||||||
| For example, access from the internet can be allowed either based on an AccessLevel or, | ||||||
| for traffic hosted on Google Cloud, the project of the source network. | ||||||
| For access from private networks, using the project of the hosting network is required. | ||||||
| Individual ingress policies can be limited by restricting which services and/ | ||||||
| or actions they match using the ingressTo field. | ||||||
| autogen_async: true | ||||||
| exclude_validator: true | ||||||
| # Skipping the sweeper due to the non-standard base_url and because this is fine-grained under ServicePerimeter/IngressPolicy | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| skip_sweeper: true | ||||||
| id_format: '{{perimeter}}' | ||||||
| import_format: ['{{perimeter}}'] | ||||||
| custom_code: !ruby/object:Provider::Terraform::CustomCode | ||||||
| custom_import: templates/terraform/custom_import/access_context_manager_service_perimeter_ingress_policy.go.erb | ||||||
| parameters: | ||||||
| - !ruby/object:Api::Type::ResourceRef | ||||||
| name: 'perimeter' | ||||||
| resource: 'ServicePerimeter' | ||||||
| imports: 'name' | ||||||
| description: | | ||||||
| The name of the Service Perimeter to add this resource to. | ||||||
| required: true | ||||||
| immutable: true | ||||||
| url_param_only: true | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::NestedObject | ||||||
| name: 'ingressPolicy' | ||||||
| description: | | ||||||
| List of `IngressPolicies` to apply to the perimeter. A perimeter may | ||||||
| have multiple `IngressPolicies`, each of which is evaluated | ||||||
| separately. Access is granted if any `Ingress Policy` grants it. | ||||||
| Must be empty for a perimeter bridge. | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::NestedObject | ||||||
| name: 'ingressFrom' | ||||||
| description: | | ||||||
| Defines the conditions on the source of a request causing this `IngressPolicy` | ||||||
| to apply. | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::Enum | ||||||
| name: 'identityType' | ||||||
| description: | | ||||||
| Specifies the type of identities that are allowed access from outside the | ||||||
| perimeter. If left unspecified, then members of `identities` field will be | ||||||
| allowed access. | ||||||
| values: | ||||||
| - :IDENTITY_TYPE_UNSPECIFIED | ||||||
| - :ANY_IDENTITY | ||||||
| - :ANY_USER_ACCOUNT | ||||||
| - :ANY_SERVICE_ACCOUNT | ||||||
| - !ruby/object:Api::Type::Array | ||||||
| name: 'identities' | ||||||
| item_type: Api::Type::String | ||||||
| description: | | ||||||
| A list of identities that are allowed access through this ingress policy. | ||||||
| Should be in the format of email address. The email address should represent | ||||||
| individual user or service account only. | ||||||
| - !ruby/object:Api::Type::Array | ||||||
| name: 'sources' | ||||||
| description: | | ||||||
| Sources that this `IngressPolicy` authorizes access from. | ||||||
| item_type: !ruby/object:Api::Type::NestedObject | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::String | ||||||
| name: 'accessLevel' | ||||||
| description: | | ||||||
| An `AccessLevel` resource name that allow resources within the | ||||||
| `ServicePerimeters` to be accessed from the internet. `AccessLevels` listed | ||||||
| must be in the same policy as this `ServicePerimeter`. Referencing a nonexistent | ||||||
| `AccessLevel` will cause an 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.` | ||||||
| If * is specified, then all IngressSources will be allowed. | ||||||
| - !ruby/object:Api::Type::String | ||||||
| name: 'resource' | ||||||
| description: | | ||||||
| A Google Cloud resource that is allowed to ingress the perimeter. | ||||||
| Requests from these resources will be allowed to access perimeter data. | ||||||
| Currently only projects are allowed. Format `projects/{project_number}` | ||||||
| The project may be in any Google Cloud organization, not just the | ||||||
| organization that the perimeter is defined in. `*` is not allowed, the case | ||||||
| of allowing all Google Cloud resources only is not supported. | ||||||
| - !ruby/object:Api::Type::NestedObject | ||||||
| name: 'ingressTo' | ||||||
| description: | | ||||||
| Defines the conditions on the `ApiOperation` and request destination that cause | ||||||
| this `IngressPolicy` to apply. | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::Array | ||||||
| name: 'resources' | ||||||
| item_type: Api::Type::String | ||||||
| description: | | ||||||
| A list of resources, currently only projects in the form | ||||||
| `projects/<projectnumber>`, protected by this `ServicePerimeter` | ||||||
| that are allowed to be accessed by sources defined in the | ||||||
| corresponding `IngressFrom`. A request matches if it contains | ||||||
| a resource in this list. If `*` is specified for resources, | ||||||
| then this `IngressTo` rule will authorize access to all | ||||||
| resources inside the perimeter, provided that the request | ||||||
| also matches the `operations` field. | ||||||
| - !ruby/object:Api::Type::Array | ||||||
| name: 'operations' | ||||||
| description: | | ||||||
| A list of `ApiOperations` the sources specified in corresponding `IngressFrom` | ||||||
| are allowed to perform in this `ServicePerimeter`. | ||||||
| item_type: !ruby/object:Api::Type::NestedObject | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::String | ||||||
| name: 'serviceName' | ||||||
| description: | | ||||||
| The name of the API whose methods or permissions the `IngressPolicy` or | ||||||
| `EgressPolicy` want to allow. A single `ApiOperation` with `serviceName` | ||||||
| field set to `*` will allow all methods AND permissions for all services. | ||||||
| - !ruby/object:Api::Type::Array | ||||||
| name: 'methodSelectors' | ||||||
| description: | | ||||||
| API methods or permissions to allow. Method or permission must belong to | ||||||
| the service specified by serviceName field. A single `MethodSelector` entry | ||||||
| with `*` specified for the method field will allow all methods AND | ||||||
| permissions for the service specified in `serviceName`. | ||||||
| item_type: !ruby/object:Api::Type::NestedObject | ||||||
| properties: | ||||||
| - !ruby/object:Api::Type::String | ||||||
| name: 'method' | ||||||
| description: | | ||||||
| Value for method should be a valid method name for the corresponding | ||||||
| serviceName in `ApiOperation`. If `*` used as value for `method`, then | ||||||
| ALL methods and permissions are allowed. | ||||||
| - !ruby/object:Api::Type::String | ||||||
| name: 'permission' | ||||||
| description: | | ||||||
| Value for permission should be a valid Cloud IAM permission for the | ||||||
| corresponding `serviceName` in `ApiOperation`. | ||||||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.