

**Introducing a new console experience for Amazon WAF**

You can now use the updated experience to access Amazon WAF functionality anywhere in the console. For more details, see [Working with the console](https://docs.amazonaws.cn/waf/latest/developerguide/working-with-console.html). 

# Setting up your account to use Amazon Shield network security director
<a name="nsd-setting-up"></a>

**Note**  
Amazon Shield network security director is in public preview release and is subject to change. 

Amazon Shield network security director requires Amazon Organizations to manage security across multiple accounts in your organization. This topic describes the preliminary steps to prepare your Amazon environment, including setting up Organizations, designating a delegated administrator, and configuring the necessary IAM permissions. You aren't charged for these preliminary setup steps. You are charged only for Amazon services that you use.

## Prerequisites
<a name="nsd-prerequisites"></a>

Before you can use Amazon Shield network security director, you must have the following in place:
+ **Amazon Organizations** - Amazon Shield network security director works exclusively with Amazon Organizations to provide security analysis across multiple accounts. You cannot use Amazon Shield network security director with a single standalone account.
+ **Management account access** - You need access to the Amazon Organizations management account to designate a delegated administrator for Amazon Shield network security director.
+ **Delegated administrator account** - You need to identify or create an account that will serve as the delegated administrator for Amazon Shield network security director. This cannot be the Organizations management account.

**Important**  
Amazon Shield network security director cannot be used with standalone Amazon accounts. You must have Amazon Organizations configured with at least one member account in addition to the management account.

## Understanding Amazon Organizations integration
<a name="nsd-organizations-integration"></a>

Amazon Organizations is a global account management service that lets Amazon administrators consolidate and manage multiple Amazon accounts. Amazon Shield network security director integrates with Organizations to provide centralized security analysis and management across your entire organization.

When you integrate Amazon Shield network security director with Amazon Organizations:
+ The Organizations management account designates a delegated administrator for Amazon Shield network security director
+ The delegated administrator can enable Amazon Shield network security director across multiple accounts and regions
+ Security analysis and findings are centrally managed through the delegated administrator account
+ Service-linked roles are automatically created in member accounts to enable analysis

This approach is similar to other Amazon security services like Amazon Security Hub and provides consistent governance across your security tools.

## Choosing a delegated administrator
<a name="nsd-delegated-administrator"></a>

A delegated administrator is an Amazon account in your organization that has been granted permissions to manage Amazon Shield network security director on behalf of the organization. The delegated administrator can enable the service, create policies, and manage security findings across all member accounts.

**Delegated administrator requirements:**
+ Must be a member account in your Amazon Organizations structure
+ Cannot be the Organizations management account
+ Should have appropriate IAM permissions configured (see next section)

**Note**  
As a best practice, we recommend using the same delegated administrator account across Amazon security services (such as Security Hub, GuardDuty, and Amazon Shield network security director) for consistent governance and simplified management.

## IAM requirements for the delegated administrator
<a name="nsd-iam-requirements"></a>

The delegated administrator account requires specific IAM permissions to manage Amazon Shield network security director effectively. You must attach the following policy to the IAM user or role that will be managing Amazon Shield network security director in the delegated administrator account.

**Required IAM policy for Amazon Shield network security director delegated administrator:**

```
{
    "Version": "2012-10-17", 		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "network-security-director:*"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:GetRole",
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam:::role/aws-service-role/AWSServiceRoleForNetworkSecurityDirector"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "organizations:ListRoots",
                "organizations:ListOrganizationalUnitsForParent",
                "organizations:ListAccountsForParent",
                "organizations:ListAccounts",
                "organizations:ListAWSServiceAccessForOrganization",
                "organizations:ListDelegatedAdministrators",
                "organizations:DescribeOrganization",
                "organizations:CreatePolicy",
                "organizations:UpdatePolicy",
                "organizations:DeletePolicy",
                "organizations:AttachPolicy",
                "organizations:DetachPolicy",
                "organizations:EnablePolicyType",
                "organizations:DisablePolicyType",
                "organizations:DescribeOrganization",
                "organizations:DescribeOrganizationalUnit",
                "organizations:DescribeAccount",
                "organizations:ListRoots",
                "organizations:ListOrganizationalUnitsForParent",
                "organizations:ListParents",
                "organizations:ListChildren",
                "organizations:ListAccounts",
                "organizations:ListAccountsForParent",
                "organizations:ListTagsForResource",
                "organizations:ListDelegatedAdministrators",
                "organizations:ListHandshakesForAccount",
                "organizations:DescribePolicy",
                "organizations:DescribeEffectivePolicy",
                "organizations:ListPolicies",
                "organizations:ListPoliciesForTarget",
                "organizations:ListTargetsForPolicy"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
```

**Policy explanation:**
+ **network-security-director:\*** - Grants full access to all Amazon Shield network security director operations, including enabling the service, creating policies, and managing findings.
+ **IAM permissions** - Allows the delegated administrator to manage the service-linked role that Amazon Shield network security director uses to perform analysis across member accounts.

**To create and attach the IAM policy**

1. Sign in to the Amazon Management Console using the delegated administrator account.

1. Open the IAM console at [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. In the navigation pane, choose **Policies**, then choose **Create policy**.

1. Choose the **JSON** tab and paste the policy document shown above.

1. Choose **Next: Tags**, then **Next: Review**.

1. For **Name**, enter **NetworkSecurityDirectorDelegatedAdminPolicy**.

1. Choose **Create policy**.

1. Attach this policy to the IAM user or role that will be managing Amazon Shield network security director in the delegated administrator account.

## Setup checklist
<a name="nsd-setup-checklist"></a>

Before proceeding to enable Amazon Shield network security director, ensure you have completed the following setup tasks:
+ ✓ Amazon Organizations is configured with a management account and at least one member account
+ ✓ You have identified a delegated administrator account (cannot be the management account)
+ ✓ The required IAM policy has been created and attached in the delegated administrator account
+ ✓ You have access to both the Organizations management account and the delegated administrator account

Once you have completed these setup tasks, you can proceed to [Enabling Amazon Shield network security director](nsd-enablement.md) to enable Amazon Shield network security director for your organization.