|
| 1 | +/* |
| 2 | + * Copyright 2022 Google LLC |
| 3 | + * |
| 4 | + * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | + * you may not use this file except in compliance with the License. |
| 6 | + * You may obtain a copy of the License at |
| 7 | + * |
| 8 | + * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | + * |
| 10 | + * Unless required by applicable law or agreed to in writing, software |
| 11 | + * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | + * See the License for the specific language governing permissions and |
| 14 | + * limitations under the License. |
| 15 | + */ |
| 16 | + |
| 17 | +// [START iam_create_deny_policy] |
| 18 | + |
| 19 | +import com.google.iam.v2.CreatePolicyRequest; |
| 20 | +import com.google.iam.v2.DenyRule; |
| 21 | +import com.google.iam.v2.PoliciesClient; |
| 22 | +import com.google.iam.v2.Policy; |
| 23 | +import com.google.iam.v2.PolicyRule; |
| 24 | +import com.google.longrunning.Operation; |
| 25 | +import com.google.type.Expr; |
| 26 | +import java.io.IOException; |
| 27 | +import java.net.URLEncoder; |
| 28 | +import java.nio.charset.StandardCharsets; |
| 29 | +import java.util.concurrent.ExecutionException; |
| 30 | +import java.util.concurrent.TimeUnit; |
| 31 | +import java.util.concurrent.TimeoutException; |
| 32 | + |
| 33 | +public class CreateDenyPolicy { |
| 34 | + |
| 35 | + public static void main(String[] args) |
| 36 | + throws IOException, ExecutionException, InterruptedException, TimeoutException { |
| 37 | + // TODO(developer): Replace these variables before running the sample. |
| 38 | + // ID or number of the Google Cloud project you want to use. |
| 39 | + String projectId = "your-google-cloud-project-id"; |
| 40 | + |
| 41 | + // Specify the id of the Deny policy you want to create. |
| 42 | + String policyId = "deny-policy-id"; |
| 43 | + |
| 44 | + createDenyPolicy(projectId, policyId); |
| 45 | + } |
| 46 | + |
| 47 | + // Create a deny policy. |
| 48 | + // You can add deny policies to organizations, folders, and projects. |
| 49 | + // Each of these resources can have up to 5 deny policies. |
| 50 | + // |
| 51 | + // Deny policies contain deny rules, which specify the following: |
| 52 | + // 1. The permissions to deny and/or exempt. |
| 53 | + // 2. The principals that are denied, or exempted from denial. |
| 54 | + // 3. An optional condition on when to enforce the deny rules. |
| 55 | + public static void createDenyPolicy(String projectId, String policyId) |
| 56 | + throws IOException, ExecutionException, InterruptedException, TimeoutException { |
| 57 | + |
| 58 | + try (PoliciesClient policiesClient = PoliciesClient.create()) { |
| 59 | + // Each deny policy is attached to an organization, folder, or project. |
| 60 | + // To work with deny policies, specify the attachment point. |
| 61 | + // |
| 62 | + // Its format can be one of the following: |
| 63 | + // 1. cloudresourcemanager.googleapis.com/organizations/ORG_ID |
| 64 | + // 2. cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
| 65 | + // 3. cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
| 66 | + // |
| 67 | + // The attachment point is identified by its URL-encoded resource name. |
| 68 | + String urlEncodedResource = |
| 69 | + URLEncoder.encode( |
| 70 | + "cloudresourcemanager.googleapis.com/projects/", StandardCharsets.UTF_8); |
| 71 | + String attachmentPoint = String.format("%s%s", urlEncodedResource, projectId); |
| 72 | + |
| 73 | + // Construct the full path of the resource to which the policy is attached. |
| 74 | + // Its format is: "policies/{attachmentPoint}/denypolicies/{policyId}" |
| 75 | + String policyParent = String.format("policies/%s/denypolicies", attachmentPoint); |
| 76 | + |
| 77 | + DenyRule denyRule = |
| 78 | + DenyRule.newBuilder() |
| 79 | + // Add one or more principals who should be denied the permissions specified in this |
| 80 | + // rule. |
| 81 | + // For more information on allowed values, see: |
| 82 | + // https://cloud.google.com/iam/docs/principal-identifiers |
| 83 | + .addDeniedPrincipals("principalSet://goog/public:all") |
| 84 | + |
| 85 | + // Optionally, set the principals who should be exempted from the |
| 86 | + // list of denied principals. For example, if you want to deny certain permissions |
| 87 | + // to a group but exempt a few principals, then add those here. |
| 88 | + // .addExceptionPrincipals( |
| 89 | + // "principalSet://goog/group/[email protected]") |
| 90 | + |
| 91 | + // Set the permissions to deny. |
| 92 | + // The permission value is of the format: service_fqdn/resource.action |
| 93 | + // For the list of supported permissions, see: |
| 94 | + // https://cloud.google.com/iam/help/deny/supported-permissions |
| 95 | + .addDeniedPermissions("cloudresourcemanager.googleapis.com/projects.delete") |
| 96 | + |
| 97 | + // Optionally, add the permissions to be exempted from this rule. |
| 98 | + // Meaning, the deny rule will not be applicable to these permissions. |
| 99 | + // .addExceptionPermissions("cloudresourcemanager.googleapis.com/projects.create") |
| 100 | + |
| 101 | + // Set the condition which will enforce the deny rule. If this condition is true, |
| 102 | + // the deny rule will be applicable. Else, the rule will not be enforced. |
| 103 | + .setDenialCondition( |
| 104 | + Expr.newBuilder() |
| 105 | + // The expression uses Common Expression Language syntax (CEL). |
| 106 | + // Here we block access based on tags. |
| 107 | + // |
| 108 | + // A tag is a key-value pair that can be attached to an organization, folder, |
| 109 | + // or project. You can use deny policies to deny permissions based on tags |
| 110 | + // without adding an IAM Condition to every role grant. |
| 111 | + // For example, imagine that you tag all of your projects as dev, test, or |
| 112 | + // prod. You want only members of [email protected] to be able to |
| 113 | + // perform operations on projects that are tagged prod. |
| 114 | + // To solve this problem, you create a deny rule that denies the |
| 115 | + // cloudresourcemanager.googleapis.com/projects.delete permission to everyone |
| 116 | + // except [email protected] for resources that are tagged test. |
| 117 | + .setExpression("!resource.matchTag('12345678/env', 'test')") |
| 118 | + .setTitle("Only for test projects") |
| 119 | + .build()) |
| 120 | + .build(); |
| 121 | + |
| 122 | + // Add the deny rule and a description for it. |
| 123 | + Policy policy = |
| 124 | + Policy.newBuilder() |
| 125 | + // Set the deny rule. |
| 126 | + .addRules( |
| 127 | + PolicyRule.newBuilder() |
| 128 | + // Set a description for the rule. |
| 129 | + .setDescription( |
| 130 | + "block all principals from deleting projects, unless the principal" |
| 131 | + + " is a member of [email protected] and the project" |
| 132 | + + " being deleted has a tag with the value test") |
| 133 | + .setDenyRule(denyRule) |
| 134 | + .build()) |
| 135 | + .build(); |
| 136 | + |
| 137 | + // Set the policy resource path, policy rules and a unique ID for the policy. |
| 138 | + CreatePolicyRequest createPolicyRequest = |
| 139 | + CreatePolicyRequest.newBuilder() |
| 140 | + .setParent(policyParent) |
| 141 | + .setPolicy(policy) |
| 142 | + .setPolicyId(policyId) |
| 143 | + .build(); |
| 144 | + |
| 145 | + // Build the create policy request. |
| 146 | + Operation operation = |
| 147 | + policiesClient |
| 148 | + .createPolicyCallable() |
| 149 | + .futureCall(createPolicyRequest) |
| 150 | + .get(3, TimeUnit.MINUTES); |
| 151 | + |
| 152 | + // Wait for the operation to complete. |
| 153 | + if (operation.hasError()) { |
| 154 | + System.out.println("Error in creating the policy " + operation.getError()); |
| 155 | + return; |
| 156 | + } |
| 157 | + |
| 158 | + // Retrieve the policy name. |
| 159 | + Policy response = policiesClient.getPolicy(String.format("%s/%s", policyParent, policyId)); |
| 160 | + String policyName = response.getName(); |
| 161 | + System.out.println( |
| 162 | + "Created the deny policy: " + policyName.substring(policyName.lastIndexOf("/") + 1)); |
| 163 | + } |
| 164 | + } |
| 165 | +} |
| 166 | +// [END iam_create_deny_policy] |
![gcf-owl-bot[bot]](https://avatars.githubusercontent.com/in/99011?v=4&size=40){kind=avatar}
0 commit comments