Skip to content

A platform for community discussion. Free, open, simple.

UX: Clarify when the AWS SNS topic ARN allowlist is needed (#45489)

Natalie Tay70ccbb9a7284
diff --git a/config/locales/server.en.yml b/config/locales/server.en.yml
index fe0c987b785..edd3f2969fa 100644
--- a/config/locales/server.en.yml
+++ b/config/locales/server.en.yml
@@ -2129,7 +2129,7 @@ en:
one: "Email polling has generated an error in the past 24 hours. Look at <a href='%{base_path}/logs' target='_blank'>the logs</a> for more details."
other: "Email polling has generated %{count} errors in the past 24 hours. Look at <a href='%{base_path}/logs' target='_blank'>the logs</a> for more details."
missing_mailgun_api_key: "The server is configured to send emails via Mailgun but you haven't provided an API key used to verify the webhook messages."
- missing_aws_sns_topic_arn: "The server is configured to send emails via Amazon SES but you haven't allowlisted any SNS topic ARNs. Bounce notifications will be rejected until you add the legitimate ARN to <a href='%{base_path}/admin/site_settings/category/email?filter=aws_sns_topic_arn_allowlist'>aws_sns_topic_arn_allowlist</a>."
+ missing_aws_sns_topic_arn: "This server is configured to send email via Amazon SES. If you use Amazon SNS to deliver bounce notifications to Discourse, you must add your SNS topic ARN to <a href='%{base_path}/admin/site_settings/category/email?filter=aws_sns_topic_arn_allowlist'>aws_sns_topic_arn_allowlist</a>. SNS webhook notifications from unlisted topics are rejected."
qq_mail_smtp: "Your SMTP server (%{smtp_address}) is known to cause duplicate emails with Discourse. QQ Mail does not return proper acknowledgments, causing Discourse to retry sends that already succeeded. <a href='https://github.com/discourse/discourse/blob/main/docs/INSTALL-email.md' target='_blank'>See recommended alternatives</a>."
bad_favicon_url: "The favicon is failing to load. Check your favicon setting in <a href='%{base_path}/admin/site_settings'>Site Settings</a>."
poll_pop3_timeout: "Connection to the POP3 server is timing out. Incoming email could not be retrieved. Please check your <a href='%{base_path}/admin/site_settings/category/email'>POP3 settings</a> and service provider."
@@ -2797,7 +2797,7 @@ en:
ignore_by_title_regex: "Ignore incoming emails based on their title using a regular expression."
mailgun_api_key: "Mailgun Secret API key used to verify webhook messages."
sendgrid_verification_key: "Sendgrid verification key used to verify webhook messages."
- aws_sns_topic_arn_allowlist: "SNS topic ARNs allowed to send Amazon SES bounce webhook notifications."
+ aws_sns_topic_arn_allowlist: "SNS topics allowed to send Amazon SES bounce notifications to this site's AWS webhook endpoint. In Amazon SNS → Topics, copy the full Topic ARN configured for bounce notifications in Amazon SES, for example: arn:aws:sns:eu-west-1:123456789012:DiscourseBounces. Add each ARN as a separate entry. Leave empty if you do not use SNS for bounce notifications. <a href='https://docs.aws.amazon.com/ses/latest/dg/configure-sns-notifications.html'>Setup instructions</a>."
mailjet_webhook_token: "Token used to verify webhook payload. It must be passed as the 't' query parameter of the webhook, for example: https://example.com/webhook/mailjet?t=supersecret"
mailpace_webhook_token: "Token used to verify webhook payload. It must be passed as the 't' query parameter of the webhook, for example: https://example.com/webhook/mailpace?t=supersecret"
mandrill_authentication_key: "Mandrill authentication key used to verify webhook messages."