AWS quicksight documentation change
Summary
Expanded email customization to include alert emails, restructured content with bullet points for clarity, updated permissions requirements for SES identity attributes
Security assessment
Added emphasis on SES identity attribute permissions which relate to email sender verification - a security best practice to prevent spoofing, though no specific vulnerability is addressed
Diff
diff --git a/quicksight/latest/user/customizing-quicksight-email-templates.md b/quicksight/latest/user/customizing-quicksight-email-templates.md index 4173c48cd..0f3b5c3f7 100644 --- a/quicksight/latest/user/customizing-quicksight-email-templates.md +++ b/quicksight/latest/user/customizing-quicksight-email-templates.md @@ -5 +5 @@ -# Customizing email report templates +# Customizing report and alert emails @@ -10 +10 @@ Intended audience: System administrators and Amazon QuickSight administrators -In Amazon QuickSight, you can customize how dashboard email reports appear and behave for account users. You can customize the sender display name (who the email says it's from), the logo, and the footer that displays in the email. You can also customize where the dashboard opens when recipients click on it in the email report. You can even include a user-friendly name in place of your custom email address, such as Sales, for the email to be from. +In Amazon QuickSight, you can customize how dashboard report emails and alert emails appear and behave for account users. You can customize the following components of emails: @@ -12 +12,12 @@ In Amazon QuickSight, you can customize how dashboard email reports appear and b -Before you can create a custom email report template, make sure you have the appropriate IAM permissions to create and update account customizations, including creating and updating custom email templates. If you plan to use a custom email address to send reports from, such as a company email address, make sure you also have permissions to obtain SES identity attributes. For more information about the permissions you need, and to see an example IAM policy, see [IAM identity-based policies for Amazon QuickSight: customizing email report templates](./iam-policy-examples.html#security_iam_id-based-policy-examples-email-customizations). + * The sender email address, including configuring a user-friendly name in place of the email address. For example: _Sales_ , or _Metrics emails_. + + * The logo in the email. + + * The footer in the email. + + * Where the dashboard opens when recipients choose it from the email. + + + + +To edit the custom email template, you must have the appropriate IAM permissions to create and update account customizations. If you plan to use a custom email address to send emails from, such as a company email address, you must have permissions to obtain Amazon SES identity attributes. For more information about the required permissions, and to see an example IAM policy, see [IAM identity-based policies for Amazon QuickSight: customizing email report templates](./iam-policy-examples.html#security_iam_id-based-policy-examples-email-customizations). @@ -18 +29 @@ All customizations apply only to the AWS Region and account that's selected in t -Use the topics below to create and customize a custom email template. +Use the following topics to edit the custom email template. @@ -22 +33 @@ Use the topics below to create and customize a custom email template. - * [Create a custom email template](./create-custom-email-template.html) + * [Edit the email template](./create-custom-email-template.html) @@ -26,2 +36,0 @@ Use the topics below to create and customize a custom email template. - * [Setting a default theme for Amazon QuickSight analyses with the QuickSight APIs](./customizing-quicksight-default-theme.html) - @@ -39 +48 @@ Welcome content -Create a custom email template +Edit the email template