feat(iam): support permissions boundary policy for User and Role (aws…

…#3584)

* Add permissions boundary to IAM user and role L2 constructs

* fix copy/paste typo

* remove unnecessary quotes

packages/@aws-cdk/aws-iam/lib/role.ts

@@ -57,6 +57,21 @@ export interface RoleProps {
    */
   readonly path?: string;
 
+  /**
+   * AWS supports permissions boundaries for IAM entities (users or roles).
+   * A permissions boundary is an advanced feature for using a managed policy
+   * to set the maximum permissions that an identity-based policy can grant to
+   * an IAM entity. An entity's permissions boundary allows it to perform only
+   * the actions that are allowed by both its identity-based policies and its
+   * permissions boundaries.
+   *
+   * @link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-permissionsboundary
+   * @link https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html
+   *
+   * @default - No permissions boundary.
+   */
+  readonly permissionsBoundary?: IManagedPolicy;
+
   /**
    * A name for the IAM role. For valid values, see the RoleName parameter for
    * the CreateRole action in the IAM API Reference.
@@ -196,6 +211,11 @@ export class Role extends Resource implements IRole {
    */
   public readonly policyFragment: PrincipalPolicyFragment;
 
+  /**
+   * Returns the permissions boundary attached to this role
+   */
+  public readonly permissionsBoundary?: IManagedPolicy;
+
   private defaultPolicy?: Policy;
   private readonly managedPolicies: IManagedPolicy[] = [];
   private readonly attachedPolicies = new AttachedPolicies();
@@ -207,7 +227,7 @@ export class Role extends Resource implements IRole {
 
     this.assumeRolePolicy = createAssumeRolePolicy(props.assumedBy, props.externalId);
     this.managedPolicies.push(...props.managedPolicies || []);
-
+    this.permissionsBoundary = props.permissionsBoundary;
     const maxSessionDuration = props.maxSessionDuration && props.maxSessionDuration.toSeconds();
     validateMaxSessionDuration(maxSessionDuration);
 
@@ -216,6 +236,7 @@ export class Role extends Resource implements IRole {
       managedPolicyArns: Lazy.listValue({ produce: () => this.managedPolicies.map(p => p.managedPolicyArn) }, { omitEmpty: true }),
       policies: _flatten(props.inlinePolicies),
       path: props.path,
+      permissionsBoundary: this.permissionsBoundary ? this.permissionsBoundary.managedPolicyArn : undefined,
       roleName: this.physicalName,
       maxSessionDuration,
     });

packages/@aws-cdk/aws-iam/lib/user.ts

@@ -41,6 +41,21 @@ export interface UserProps {
    */
   readonly path?: string;
 
+  /**
+   * AWS supports permissions boundaries for IAM entities (users or roles).
+   * A permissions boundary is an advanced feature for using a managed policy
+   * to set the maximum permissions that an identity-based policy can grant to
+   * an IAM entity. An entity's permissions boundary allows it to perform only
+   * the actions that are allowed by both its identity-based policies and its
+   * permissions boundaries.
+   *
+   * @link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html#cfn-iam-role-permissionsboundary
+   * @link https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html
+   *
+   * @default - No permissions boundary.
+   */
+  readonly permissionsBoundary?: IManagedPolicy;
+
   /**
    * A name for the IAM user. For valid values, see the UserName parameter for
    * the CreateUser action in the IAM API Reference. If you don't specify a
@@ -98,6 +113,11 @@ export class User extends Resource implements IIdentity {
    */
   public readonly userArn: string;
 
+  /**
+   * Returns the permissions boundary attached to this user
+   */
+  public readonly permissionsBoundary?: IManagedPolicy;
+
   public readonly policyFragment: PrincipalPolicyFragment;
 
   private readonly groups = new Array<any>();
@@ -111,12 +131,14 @@ export class User extends Resource implements IIdentity {
     });
 
     this.managedPolicies.push(...props.managedPolicies || []);
+    this.permissionsBoundary = props.permissionsBoundary;
 
     const user = new CfnUser(this, 'Resource', {
       userName: this.physicalName,
       groups: undefinedIfEmpty(() => this.groups),
       managedPolicyArns: Lazy.listValue({ produce: () => this.managedPolicies.map(p => p.managedPolicyArn) }, { omitEmpty: true }),
       path: props.path,
+      permissionsBoundary: this.permissionsBoundary ? this.permissionsBoundary.managedPolicyArn : undefined,
       loginProfile: this.parseLoginProfile(props)
     });
 

packages/@aws-cdk/aws-iam/test/test.role.ts

@@ -1,7 +1,7 @@
 import { expect, haveResource, haveResourceLike } from '@aws-cdk/assert';
 import { Duration, Stack } from '@aws-cdk/core';
 import { Test } from 'nodeunit';
-import { ArnPrincipal, CompositePrincipal, FederatedPrincipal, PolicyStatement, Role, ServicePrincipal, User } from '../lib';
+import { ArnPrincipal, CompositePrincipal, FederatedPrincipal, ManagedPolicy, PolicyStatement, Role, ServicePrincipal, User } from '../lib';
 
 export = {
   'default role'(test: Test) {
@@ -290,4 +290,32 @@ export = {
     test.done();
   },
 
+  'can supply permissions boundary managed policy'(test: Test) {
+    // GIVEN
+    const stack = new Stack();
+
+    const permissionsBoundary = ManagedPolicy.fromAwsManagedPolicyName('managed-policy');
+
+    new Role(stack, 'MyRole', {
+      assumedBy: new ServicePrincipal('sns.amazonaws.com'),
+      permissionsBoundary,
+    });
+
+    expect(stack).to(haveResource('AWS::IAM::Role', {
+      PermissionsBoundary: {
+        "Fn::Join": [
+          "",
+          [
+            "arn:",
+            {
+              Ref: "AWS::Partition"
+            },
+            ":iam::aws:policy/managed-policy"
+          ]
+        ]
+      }
+    }));
+
+    test.done();
+  }
 };

packages/@aws-cdk/aws-iam/test/test.user.ts

@@ -52,6 +52,34 @@ export = {
       ]
     }));
 
+    test.done();
+  },
+
+  'can supply permissions boundary managed policy'(test: Test) {
+    // GIVEN
+    const stack = new Stack();
+
+    const permissionsBoundary = ManagedPolicy.fromAwsManagedPolicyName('managed-policy');
+
+    new User(stack, 'MyUser', {
+      permissionsBoundary,
+    });
+
+    expect(stack).to(haveResource('AWS::IAM::User', {
+      PermissionsBoundary: {
+        "Fn::Join": [
+          "",
+          [
+            "arn:",
+            {
+              Ref: "AWS::Partition"
+            },
+            ":iam::aws:policy/managed-policy"
+          ]
+        ]
+      }
+    }));
+
     test.done();
   }
 };