Configuring a delegated administrator - AWS Systems Manager

Configuring a delegated administrator

If you aggregate AWS Systems Manager Explorer data from multiple AWS Regions and accounts by using resource data sync with AWS Organizations, then we suggest that you configure a delegated administrator for Explorer. A delegated administrator improves Explorer security in the following ways.

  • You limit the number of Explorer administrators who can create or delete multi-account and Region resource data syncs to an individual AWS account.

  • You no longer need to be logged into the AWS Organizations management account to administer resource data syncs in Explorer.

For more information about resource data sync, see Setting up Systems Manager Explorer to display data from multiple accounts and Regions. For more information about AWS Organizations, see What is AWS Organizations? in the AWS Organizations User Guide.

Before you begin

The following list includes important information about Explorer delegated administration.

  • You can delegate only one account for Explorer administration.

  • The account ID that you specify as an Explorer delegated administrator must be listed as a member account in AWS Organizations. For more information, see Creating an AWS account in your organization in the AWS Organizations User Guide.

  • A delegated administrator can use all Explorer resource data sync API operations in the console or by using programmatic tools such as the SDK, the AWS Command Line Interface (AWS CLI), or AWS Tools for Windows PowerShell. Resource data sync API operations include the following: CreateResourceDataSync, DeleteResourceDataSync, ListResourceDataSync, and UpdateResourceDataSync.

  • A delegated administrator can search, filter, and aggregate Explorer data in the console or by using programmatic tools such as the SDK, the AWS CLI, or AWS Tools for Windows PowerShell. Search, filter, and data aggregation use the GetOpsSummary API operation.

  • Resource data syncs created by a delegated administrator are only available in the delegated administrator account. You can't view the syncs or the aggregated data in the AWS Organizations management account.

  • A delegated administrator can create a maximum of five resource data syncs.

  • A delegated administrator can create a resource data sync for either an entire organization in AWS Organizations or a subset of organizational units.

Configure an Explorer delegated administrator

Use the following procedure to register an Explorer delegated administrator.

To register an Explorer delegated administrator
  1. Log into your AWS Organizations management account.

  2. Open the AWS Systems Manager console at https://console.aws.amazon.com/systems-manager/.

  3. In the navigation pane, choose Explorer.

  4. Choose Settings.

  5. In the Delegated administrator for Explorer section, verify that you have configured the required service-linked role and service access options. If necessary, choose the Create role and Enable access buttons to configure these options.

  6. For Account ID, enter the AWS account ID. This account must be a member account in AWS Organizations.

  7. Choose Register delegated administrator.

The delegated administrator now has access to the Include all accounts from my AWS Organizations configuration and Select organization units in AWS Organizations options on the Create resource data sync page.

Deregister an Explorer delegated administrator

Use the following procedure to deregister an Explorer delegated administrator. A delegated administrator account can only be deregistered by the AWS Organizations management account. When a delegated administrator account is deregistered, the system deletes all AWS Organizations resource data syncs created by the delegated administrator.

To deregister an Explorer delegated administrator
  1. Log into your AWS Organizations management account.

  2. Open the AWS Systems Manager console at https://console.aws.amazon.com/systems-manager/.

  3. In the navigation pane, choose Explorer.

  4. Choose Settings.

  5. In the Delegated administrator for Explorer section, choose Deregister. The system displays a warning.

  6. Enter the account ID and choose Remove.

The account no longer has access to the AWS Organizations resource data sync API operations. The system deletes all AWS Organizations resource data syncs created by the account.