Ensure Administration of WorkSpaces is defined using IAM (Manual)
Profile Applicability
Description
To allow users to administer Amazon WorkSpaces, IAM policies must be created and attached with the required permissions to an IAM Principal used for administration of Amazon WorkSpaces. An IAM Principal may be a IAM Role or an IAM User, or an IAM User Group with Users within the User Group.
AWS has an AWS Managed Policy, AmazonWorkSpacesAdmin that grants permissions to administer Amazon WorkSpaces. A custom managed policy or inline policy may be used to grant WorkSpaces permissions to the IAM Principal.
Rationale
Creating and managing Workspaces specific users is not done in AWS IAM. Creating and managing Workspaces specific users is done within the Workspace service console. In order to properly administer Workspaces specific users, an IAM Principal with proper permissions must be created.
Impact
None specified in the benchmark.
Audit Procedure
Using AWS Console
- Login in and open the IAM console at https://console.aws.amazon.com/iam/
- In the left pane click on User Groups, Users, or Roles
- Click on the IAM Principal (User, Group, or Role) that is to be used to administer Workspaces
- Click on Permissions and confirm that the AmazonWorkSpacesAdmin policy or the proper permissions are attached
Using AWS CLI
Run the appropriate command to determine permissions for the IAM Principal:
# For attached managed policies
aws iam list-attached-role-policies --role-name <workspace_group_name>
# For inline policies
aws iam get-role-policy --role-name <role_name> --policy-name <policy_name>
Expected Result
The AWS managed policy AmazonWorkSpacesAdmin or a custom WorkSpaces Admin policy should be attached to the IAM Principal for administration of WorkSpaces.
Remediation
Using AWS Console
If the IAM Principal for WorkSpaces Administration exists but does not have the policy attached:
- Login to the IAM console at https://console.aws.amazon.com/iam/
- In the left pane click on either User Groups, Users, or Roles
- Click the proper IAM Principal
- Click on the Permissions tab
- Click on Attach Policy
- Select the AmazonWorkSpacesAdmin Policy or attach the desired Managed Policy
- Click Attach Policy
For Groups:
- Login to the IAM console at https://console.aws.amazon.com/iam/
- In the left pane click on Groups
- Select the Group
- Click on the Permissions tab
- Click on Attach Policy
- Select the AmazonWorkSpacesAdmin Policy
- Click Attach Policy
Using AWS CLI
Attach the AmazonWorkSpacesAdmin policy by running the aws iam attach-role-policy command:
aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/AmazonWorkSpacesAdmin --role-name <WorkSpaces_Admin_Role>
Default Value
By default, Policy: AmazonWorkSpacesAdmin Function: Provides access to Amazon WorkSpaces administrative actions via AWS SDK and CLI. The default policy includes extensive permissions for managing WorkSpaces resources including:
- kms:DescribeKey, kms:ListAliases, kms:ListKeys
- workspaces:CreateTags, workspaces:CreateWorkspaceImage, workspaces:CreateWorkspaces, workspaces:CreateWorkspacesPool
- workspaces:DeleteTags, workspaces:DeregisterWorkspaceDirectory, workspaces:DescribeTags
- workspaces:DescribeWorkspaceBundles, workspaces:DescribeWorkspaceDirectories, workspaces:DescribeWorkspaces
- workspaces:DescribeWorkspacesPools, workspaces:DescribeWorkspacesPoolSessions
- workspaces:DescribeWorkspacesConnectionStatus, workspaces:ModifyCertificateBasedAuthProperties
- workspaces:ModifySamlProperties, workspaces:ModifyStreamingProperties, workspaces:ModifyWorkspaceCreationProperties
- workspaces:ModifyWorkspaceProperties, workspaces:RebootWorkspaces, workspaces:RebuildWorkspaces
- workspaces:RegisterWorkspaceDirectory, workspaces:RestoreWorkspace, workspaces:StartWorkspaces
- workspaces:StartWorkspacesPool, workspaces:StopWorkspaces, workspaces:StopWorkspacesPool
- workspaces:TerminateWorkspaces, workspaces:TerminateWorkspacesPool, workspaces:TerminateWorkspacesPoolSession
- workspaces:UpdateWorkspacesPool
- And several other managed policies for application management, PCA access, pool service access, secure browser access, thin client access, and web service access
References
- https://docs.aws.amazon.com/workspaces/latest/adminguide/workspaces-access-control.html
- https://docs.aws.amazon.com/workspaces/latest/adminguide/manage-workspaces-users.html
- https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html
Additional Information
AWS provides guidance on the usage of IAM Roles, IAM Users, IAM Groups, and the root user. AWS recommends not using the root user for everyday tasks.
https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html
CIS Controls
v8:
- 3.3 Configure Data Access Control Lists
- Configure data access control lists based on a user's need to know. Apply data access control lists, also known as access permissions, to local and remote file systems, databases, and applications.
v7:
- 14.6 Protect Information through Access Control Lists
- Protect all information stored on systems with file system, network share, claims, application, or database specific access control lists. These controls will enforce the principle that only authorized individuals should have access to the information based on their need to access the information as a part of their responsibilities.
1---2name: cis-aws-euc-2-13description: Ensure Administration of WorkSpaces is defined using IAM4---56# Ensure Administration of WorkSpaces is defined using IAM (Manual)78## Profile Applicability910- Level 11112## Description1314To allow users to administer Amazon WorkSpaces, IAM policies must be created and attached with the required permissions to an IAM Principal used for administration of Amazon WorkSpaces. An IAM Principal may be a IAM Role or an IAM User, or an IAM User Group with Users within the User Group.1516AWS has an AWS Managed Policy, `AmazonWorkSpacesAdmin` that grants permissions to administer Amazon WorkSpaces. A custom managed policy or inline policy may be used to grant WorkSpaces permissions to the IAM Principal.1718## Rationale1920Creating and managing Workspaces specific users is not done in AWS IAM. Creating and managing Workspaces specific users is done within the Workspace service console. In order to properly administer Workspaces specific users, an IAM Principal with proper permissions must be created.2122## Impact2324None specified in the benchmark.2526## Audit Procedure2728### Using AWS Console29301. Login in and open the IAM console at https://console.aws.amazon.com/iam/312. In the left pane click on **User Groups**, **Users**, or **Roles**323. Click on the IAM Principal (User, Group, or Role) that is to be used to administer Workspaces334. Click on **Permissions** and confirm that the AmazonWorkSpacesAdmin policy or the proper permissions are attached3435### Using AWS CLI3637Run the appropriate command to determine permissions for the IAM Principal:3839```bash40# For attached managed policies41aws iam list-attached-role-policies --role-name <workspace_group_name>4243# For inline policies44aws iam get-role-policy --role-name <role_name> --policy-name <policy_name>45```4647## Expected Result4849The AWS managed policy AmazonWorkSpacesAdmin or a custom WorkSpaces Admin policy should be attached to the IAM Principal for administration of WorkSpaces.5051## Remediation5253### Using AWS Console5455**If the IAM Principal for WorkSpaces Administration exists but does not have the policy attached:**56571. Login to the IAM console at https://console.aws.amazon.com/iam/582. In the left pane click on either **User Groups**, **Users**, or **Roles**593. Click the proper IAM Principal604. Click on the **Permissions** tab615. Click on **Attach Policy**626. Select the **AmazonWorkSpacesAdmin** Policy or attach the desired Managed Policy637. Click **Attach Policy**6465**For Groups:**66671. Login to the IAM console at https://console.aws.amazon.com/iam/682. In the left pane click on **Groups**693. Select the **Group**704. Click on the **Permissions** tab715. Click on **Attach Policy**726. Select the **AmazonWorkSpacesAdmin** Policy737. Click **Attach Policy**7475### Using AWS CLI7677Attach the AmazonWorkSpacesAdmin policy by running the `aws iam attach-role-policy` command:7879```bash80aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/AmazonWorkSpacesAdmin --role-name <WorkSpaces_Admin_Role>81```8283## Default Value8485By default, Policy: AmazonWorkSpacesAdmin Function: Provides access to Amazon WorkSpaces administrative actions via AWS SDK and CLI. The default policy includes extensive permissions for managing WorkSpaces resources including:8687- kms:DescribeKey, kms:ListAliases, kms:ListKeys88- workspaces:CreateTags, workspaces:CreateWorkspaceImage, workspaces:CreateWorkspaces, workspaces:CreateWorkspacesPool89- workspaces:DeleteTags, workspaces:DeregisterWorkspaceDirectory, workspaces:DescribeTags90- workspaces:DescribeWorkspaceBundles, workspaces:DescribeWorkspaceDirectories, workspaces:DescribeWorkspaces91- workspaces:DescribeWorkspacesPools, workspaces:DescribeWorkspacesPoolSessions92- workspaces:DescribeWorkspacesConnectionStatus, workspaces:ModifyCertificateBasedAuthProperties93- workspaces:ModifySamlProperties, workspaces:ModifyStreamingProperties, workspaces:ModifyWorkspaceCreationProperties94- workspaces:ModifyWorkspaceProperties, workspaces:RebootWorkspaces, workspaces:RebuildWorkspaces95- workspaces:RegisterWorkspaceDirectory, workspaces:RestoreWorkspace, workspaces:StartWorkspaces96- workspaces:StartWorkspacesPool, workspaces:StopWorkspaces, workspaces:StopWorkspacesPool97- workspaces:TerminateWorkspaces, workspaces:TerminateWorkspacesPool, workspaces:TerminateWorkspacesPoolSession98- workspaces:UpdateWorkspacesPool99- And several other managed policies for application management, PCA access, pool service access, secure browser access, thin client access, and web service access100101## References1021031. https://docs.aws.amazon.com/workspaces/latest/adminguide/workspaces-access-control.html1042. https://docs.aws.amazon.com/workspaces/latest/adminguide/manage-workspaces-users.html1053. https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html106107## Additional Information108109AWS provides guidance on the usage of IAM Roles, IAM Users, IAM Groups, and the root user. AWS recommends not using the root user for everyday tasks.110https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html111112## CIS Controls113114**v8:**115116- 3.3 Configure Data Access Control Lists117 - Configure data access control lists based on a user's need to know. Apply data access control lists, also known as access permissions, to local and remote file systems, databases, and applications.118119**v7:**120121- 14.6 Protect Information through Access Control Lists122 - Protect all information stored on systems with file system, network share, claims, application, or database specific access control lists. These controls will enforce the principle that only authorized individuals should have access to the information based on their need to access the information as a part of their responsibilities.