AWS systems-manager medium security documentation change
Summary
Expanded delegated administrator documentation with security benefits and operational constraints
Security assessment
Explicitly states security improvements through reduced admin privileges ('limit number of Explorer administrators') and centralized control. Documents security-focused access management patterns.
Diff
diff --git a/systems-manager/latest/userguide/Explorer-setup-delegated-administrator.md b/systems-manager/latest/userguide/Explorer-setup-delegated-administrator.md index d2cdfab27..f70231754 100644 --- a//systems-manager/latest/userguide/Explorer-setup-delegated-administrator.md +++ b//systems-manager/latest/userguide/Explorer-setup-delegated-administrator.md @@ -4,0 +5,2 @@ +Before you begin + @@ -7 +9,8 @@ -If you aggregate AWS Systems Manager Explorer data from multiple AWS Regions and accounts by using resource data sync with AWS Organizations, then we recommend that you configure a delegated administrator for Explorer. +If you aggregate AWS Systems Manager Explorer data from multiple AWS Regions and accounts by using resource data sync with AWS Organizations, then we recommend 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. + + + @@ -21,0 +31,2 @@ A delegated administrator can use the following Explorer resource data sync APIs +A delegated administrator can search, filter, and aggregate Explorer data from 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](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsSummary.html) API operation. + @@ -23,0 +35,4 @@ A delegated administrator can create a maximum of five resource data syncs for e +###### Note + +You can't use a delegated administrator account to create a resource data sync in [opt-in AWS Regions](https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html#regions-opt-in-status). You must use an AWS Organizations management account. + @@ -27,0 +43,2 @@ For more information about resource data sync, see [Setting up Systems Manager E + * Before you begin + @@ -34,0 +52,21 @@ For more information about resource data sync, see [Setting up Systems Manager E +## 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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_create.html) 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](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CreateResourceDataSync.html), [DeleteResourceDataSync](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DeleteResourceDataSync.html), [ListResourceDataSync](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_ListResourceDataSync.html), and [UpdateResourceDataSync](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_UpdateResourceDataSync.html). + + * 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](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsSummary.html) 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. + + + +