Managing OS user accounts on managed nodes
You can use Fleet Manager, a capability of Amazon Systems Manager, to manage operating system (OS) user accounts on your managed nodes. For example, you can create and delete users and groups. Additionally, you can view details like group membership, user roles, and status.
Important
Fleet Manager uses Run Command and Session Manager, capabilities of Amazon Systems Manager, for various user management operations. As a result, a user could grant permissions to an operating system user account that they would otherwise be unable to. This is because Amazon Systems Manager Agent (SSM Agent) runs on Amazon Elastic Compute Cloud (Amazon EC2) instances using root permissions (Linux) or SYSTEM permissions (Windows Server). For more information about restricting access to root-level commands through SSM Agent, see Restricting access to root-level commands through SSM Agent. To restrict access to this feature, we recommend creating Amazon Identity and Access Management (IAM) policies for your users that only allow access to the actions you define. For more information about creating IAM policies for Fleet Manager, see Step 1: Create an IAM policy with Fleet Manager permissions.
Create a user or group
Note
Fleet Manager uses Session Manager to set passwords for new users. For Amazon EC2 instances, the instance profile attached to your managed instances must provide permissions for Session Manager to use this feature. For more information about adding Session Manager permissions to an instance profile, see Adding Session Manager permissions to an existing IAM role. Also, Amazon Key Management Service (Amazon KMS) encryption must be turned on in your session preferences to use Fleet Manager features. For more information about enabling Amazon KMS encryption for Session Manager, see Turn on KMS key encryption of session data (console).
To create an OS user account with Fleet Manager
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/
. In the navigation pane, choose Fleet Manager.
-or-
If the Amazon Systems Manager home page opens first, choose the menu icon (
) to open the
navigation pane, and then choose Fleet Manager in the navigation
pane.-
Choose the button next to the managed node you want to create a new user on.
-
Choose View details.
-
Choose Tools, Users and groups.
-
Choose the Users tab, and then choose Create user.
-
Enter a value for the Name of the new user.
-
(Recommended) Select the check box next to Set password. You will be prompted to provide a password for the new user at the end of the procedure.
-
Select Create user. If you selected the check box to create a password for the new user, you will be prompted to enter a value for the password and select Done. If the password you specify doesn't meet the requirements specified by your managed node's local or domain policies, an error is returned.
To create an OS group with Fleet Manager
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/
. In the navigation pane, choose Fleet Manager.
-or-
If the Amazon Systems Manager home page opens first, choose the menu icon (
) to open the
navigation pane, and then choose Fleet Manager in the navigation
pane.-
Choose the button next to the managed node you want to create a group in.
-
Choose View details.
-
Choose Tools, Users and groups.
-
Choose the Groups tab, and then choose Create group.
-
Enter a value for the Name of the new group.
-
(Optional) Enter a value for the Description of the new group.
-
(Optional) Select users to add to the Group members for the new group.
-
Select Create group.
Update user or group membership
To add an OS user account to a new group with Fleet Manager
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/
. In the navigation pane, choose Fleet Manager.
-or-
If the Amazon Systems Manager home page opens first, choose the menu icon (
) to open the
navigation pane, and then choose Fleet Manager in the navigation
pane.-
Choose the button next to the managed node where the user account exists that you want to update.
-
Choose View details.
-
Choose Tools, Users and groups.
-
Choose the Users tab.
-
Choose the button next to the user you want to update.
-
Choose Actions, Add user to group.
-
Choose the group you want to add the user to under Add to group.
-
Select Add user to group.
To edit an OS group's membership with Fleet Manager
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/
. In the navigation pane, choose Fleet Manager.
-or-
If the Amazon Systems Manager home page opens first, choose the menu icon (
) to open the
navigation pane, and then choose Fleet Manager in the navigation
pane.-
Choose the button next to the managed node where the group exists that you want to update.
-
Choose View details.
-
Choose Tools, Users and groups.
-
Choose the Groups tab.
-
Choose the button next to the group you want to update.
-
Choose Actions, Modify group.
-
Choose the users you want to add or remove under Group members.
-
Select Modify group.
Delete a user or group
To delete an OS user account with Fleet Manager
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/
. In the navigation pane, choose Fleet Manager.
-or-
If the Amazon Systems Manager home page opens first, choose the menu icon (
) to open the
navigation pane, and then choose Fleet Manager in the navigation
pane.-
Choose the button next to the managed node where the user account exists that you want to delete.
-
Choose View details.
-
Choose , Users and groups.
-
Choose the Users tab.
-
Choose the button next to the user you want to delete.
-
Choose Actions, Delete local user.
To delete an OS group with Fleet Manager
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/
. In the navigation pane, choose Fleet Manager.
-or-
If the Amazon Systems Manager home page opens first, choose the menu icon (
) to open the
navigation pane, and then choose Fleet Manager in the navigation
pane.-
Choose the button next to the managed node where the group exists that you want to delete.
-
Choose View details.
-
Choose Tools, Users and groups.
-
Choose the Group tab.
-
Choose the button next to the group you want to update.
-
Choose Actions, Delete local group.