AWS solutions documentation change
Summary
Added Launch Stack button image/link, renumbered steps, fixed parameter formatting, and corrected QuickSight ARN command syntax
Security assessment
Changes involve documentation formatting, step renumbering, and UI element additions without addressing security vulnerabilities or describing new security features
Diff
diff --git a/solutions/latest/security-insights-on-aws/step-1-launch-the-stack.md b/solutions/latest/security-insights-on-aws/step-1-launch-the-stack.md index 256c58b9b..40bd556fc 100644 --- a/solutions/latest/security-insights-on-aws/step-1-launch-the-stack.md +++ b/solutions/latest/security-insights-on-aws/step-1-launch-the-stack.md @@ -11 +11 @@ Follow the step-by-step instructions in this section to configure and deploy the - 1. Sign in to the [AWS Management Console](https://aws.amazon.com/console/) and select the button to launch the `security-insights-on-aws.template` AWS CloudFormation template. + 1. Sign in to the [AWS Management Console](https://aws.amazon.com/console/) and select the button to launch the `security-insights-on-aws.template` AWS CloudFormation template. [  ](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=security-insights-on-aws&templateURL=https://solutions-reference.s3.amazonaws.com/security-insights-on-aws/latest/security-insights-on-aws.template&redirectId=ImplementationGuide) @@ -13,6 +13 @@ Follow the step-by-step instructions in this section to configure and deploy the - - - -[  ](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=security-insights-on-aws&templateURL=https://solutions-reference.s3.amazonaws.com/security-insights-on-aws/latest/security-insights-on-aws.template&redirectId=ImplementationGuide) - - 1. The template launches in the US East (N. Virginia) Region by default. To launch the solution in a different AWS Region, use the Region selector in the console navigation bar. + 2. The template launches in the US East (N. Virginia) Region by default. To launch the solution in a different AWS Region, use the Region selector in the console navigation bar. @@ -24 +19 @@ This solution requires the Security Lake service and the Amazon Q in QuickSight - 2. On the **Create stack** page, verify that the correct template URL is in the **Amazon S3 URL** text box and choose **Next**. + 3. On the **Create stack** page, verify that the correct template URL is in the **Amazon S3 URL** text box and choose **Next**. @@ -26 +21 @@ This solution requires the Security Lake service and the Amazon Q in QuickSight - 3. On the **Specify stack details** page, assign a name to your solution stack. For information about naming character limitations, see [IAM and AWS STS quotas, name requirements, and character limits](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html) in the _AWS Identity and Access Management User Guide_. + 4. On the **Specify stack details** page, assign a name to your solution stack. For information about naming character limitations, see [IAM and AWS STS quotas, name requirements, and character limits](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html) in the _AWS Identity and Access Management User Guide_. @@ -28 +23 @@ This solution requires the Security Lake service and the Amazon Q in QuickSight - 4. Under **Parameters** , review the parameters for this solution template and modify them as necessary. This solution uses the following default values. + 5. Under **Parameters** , review the parameters for this solution template and modify them as necessary. This solution uses the following default values. @@ -32,2 +27,2 @@ Parameter | Default | Description -**Account ID where Security Lake is created** | ` `<Requires input>` ` | Account ID in which you created your Security Lake. NOTE: You can’t update this parameter after you deploy the solution. If you need to change it, see [Problem: Change your account ID](./troubleshooting.html#problem-changing-your-account-id). -**ARN for QuickSight admin user** | ` `<Requires input>` ` | QuickSight ARN for admin. To retrieve this ARN, you must have access to a shell or terminal with the AWS CLI installed. For installation instructions, refer to [What Is the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) in the _AWS CLI User Guide_. Optionally, you can use the [AWS CloudShell](https://aws.amazon.com/cloudshell/) service to run AWS CLI commands. Running the following command returns the list of users with their corresponding QuickSight User ARNs. `aws quicksight list-users --region `<aws-region>` --aws-account-id `<account-id>` --namespace `<namespace-name>` ` The ` `<namespace-name>` ` is `default`, unless explicitly created in Amazon QuickSight. Choose an **Admin** user, or a user who has permissions to create QuickSight resources in that account and AWS Region. +**Account ID where Security Lake is created** | ` <Requires input> ` | Account ID in which you created your Security Lake. NOTE: You can’t update this parameter after you deploy the solution. If you need to change it, see [Problem: Change your account ID](./troubleshooting.html#problem-changing-your-account-id). +**ARN for QuickSight admin user** | ` <Requires input> ` | QuickSight ARN for admin. To retrieve this ARN, you must have access to a shell or terminal with the AWS CLI installed. For installation instructions, refer to [What Is the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) in the _AWS CLI User Guide_. Optionally, you can use the [AWS CloudShell](https://aws.amazon.com/cloudshell/) service to run AWS CLI commands. Running the following command returns the list of users with their corresponding QuickSight User ARNs. `aws quicksight list-users --region` ` <aws-region> ` \--aws-account-id ` <account-id> ` `--namespace <namespace-name><namespace-name>#` is `default`, unless explicitly created in Amazon QuickSight. Choose an **Admin** user, or a user who has permissions to create QuickSight resources in that account and AWS Region. @@ -39 +34 @@ Parameter | Default | Description -**Email ID to receive QuickSight Dataset refresh alerts** | ` `<Requires input>` ` | Email address where you want to receive alerts for error notifications. +**Email ID to receive QuickSight Dataset refresh alerts** | `[.red]#<Requires input>` | Email address where you want to receive alerts for error notifications. @@ -45 +40 @@ Parameter | Default | Description - 5. Select **Next**. + 6. Select **Next**. @@ -47 +42 @@ Parameter | Default | Description - 6. On the **Configure stack options** page, choose **Next**. + 7. On the **Configure stack options** page, choose **Next**. @@ -49 +44 @@ Parameter | Default | Description - 7. On the **Review and create** page, review and confirm the settings. Select the box acknowledging that the template will create IAM resources. + 8. On the **Review and create** page, review and confirm the settings. Select the box acknowledging that the template will create IAM resources. @@ -51 +46 @@ Parameter | Default | Description - 8. Choose **Submit** to deploy the stack. + 9. Choose **Submit** to deploy the stack.