AWS Security ChangesHomeSearch

AWS connect: Add dead-letter queue prerequisite for Kinesis integration

Service: connect · 2026-11-06 · Documentation low

File: connect/latest/adminguide/customer-profiles-kinesis-integration.md · Type: logging

Summary

Adds a prerequisite step and section requiring configuration of an Amazon SQS dead-letter queue for the Customer Profiles domain so failed streamed events are captured for troubleshooting.

Security assessment

The DLQ guidance improves error visibility and diagnosability of failed event ingestion, which is operational/audit-adjacent rather than a fix for a specific vulnerability.

Evidence

Before you stream data into Customer Profiles, configure a dead-letter queue (DLQ) for your domain. Without a DLQ, failed events go unnoticed and you can't diagnose configuration problems.

Diff

diff --git a/connect/latest/adminguide/customer-profiles-kinesis-integration.md b/connect/latest/adminguide/customer-profiles-kinesis-integration.md
index df1638e..caed7a6 100644
--- a//connect/latest/adminguide/customer-profiles-kinesis-integration.md
+++ b//connect/latest/adminguide/customer-profiles-kinesis-integration.md
@@ -7 +7 @@
-Step 1: Stream Data from Kinesis to EventBridgeStep 2: Ingest EventBridge Data into Customer Profiles
+Prerequisite: Configure a dead-letter queueStep 1: Stream Data from Kinesis to EventBridgeStep 2: Ingest EventBridge Data into Customer Profiles
@@ -11 +11 @@ Step 1: Stream Data from Kinesis to EventBridgeStep 2: Ingest EventBridge Data i
-The following steps outline the process of streaming objects from an Amazon Kinesis Data Stream into Connect Customer Customer Profiles. The integration consists of two main steps: 
+The following steps outline the process of streaming objects from an Amazon Kinesis Data Stream into Connect Customer Customer Profiles. First complete the prerequisite, then complete the two integration steps: 
@@ -13 +13 @@ The following steps outline the process of streaming objects from an Amazon Kine
-  1. Configure an EventBridge Pipe to stream data from your Kinesis Data Stream to an EventBridge bus. 
+  1. Configure a dead-letter queue (DLQ) for your domain so that failed events are captured for troubleshooting.
@@ -15 +15 @@ The following steps outline the process of streaming objects from an Amazon Kine
-  2. Set up a Customer Profiles data integration with your Kinesis Data Stream using your created EventBridge Pipe 
+  2. Configure an EventBridge Pipe to stream data from your Kinesis Data Stream to an EventBridge bus. 
@@ -16,0 +17 @@ The following steps outline the process of streaming objects from an Amazon Kine
+  3. Set up a Customer Profiles data integration with your Kinesis Data Stream using your created EventBridge Pipe 
@@ -19,0 +21,7 @@ The following steps outline the process of streaming objects from an Amazon Kine
+
+## Prerequisite: Configure a dead-letter queue
+
+Before you stream data into Customer Profiles, configure a dead-letter queue (DLQ) for your domain. Without a DLQ, failed events go unnoticed and you can't diagnose configuration problems.
+
+A DLQ is an Amazon SQS queue where Customer Profiles reports errors from streamed events. When you create a domain, you can specify a DLQ. For instructions on specifying a DLQ, see [Enable Customer Profiles, and specify a dead-letter queue and KMS key](./enable-customer-profiles.html#enable-customer-profiles-step1). For an existing domain, use the UpdateDomain operation to add or change the DLQ.
+