Field tiers
Every field in an event payload belongs to exactly one of six tiers.
The four customer-configurable tiers (Allow, Deny, Encrypt, Transform)
are mutually exclusive: any one field appears in at most one tier.
Processing order
The Lambda processes every event in four passes, in order.- Mandatory override. Check each field path against the mandatory list. If a mandatory field sits under a denied parent, retain the parent and prune all non-mandatory siblings. Mandatory always wins.
- Deny. Evaluate every remaining field path against the deny list. Mark matched fields for removal.
- Allow, Encrypt, Transform. Apply the customer-declared tiers to remaining fields.
- Default nullify. Every field not covered by the previous three
passes keeps its key, value becomes
null.
Path notation
Both lists use dot notation.Parametersmatches the entire object at theParameterskey.Parameters.LexVersionmatches only that subfield.
Parent-key behavior
When a deny entry targets a parent (for example,Parameters) and no
mandatory entry references any child of that parent, the Lambda
removes the entire Parameters key. The key is absent from the
output — not an empty object.
When a deny entry targets a parent and the mandatory, allow, encrypt,
or transform list references one or more children of that parent, the
Lambda retains the parent containing only those referenced children.
Every other child is removed regardless of whether it also appears
explicitly in the deny list.
Data flow
Mandatory keep-list
The redaction Lambda always preserves these fields, regardless of deny, encrypt, or transform configuration.Example
Raw log emitted by Amazon Connect:Common configurations
Related
- Configure Contact Flow Log redaction — step-by-step rollout.
- Concept: Privacy and redaction — the cross-integration model.
- Lex redaction schema — the sibling schema for Amazon Lex conversation logs.
- Install Contact Flow Logs collection — the integration this schema applies to.