AWS wickr: Document Nitro Enclave data retention architecture and KMS/CloudTrail controls
Summary
Adds a new section explaining that data retention processing runs in a Wickr-managed service account inside an AWS Nitro Enclave, that plaintext exists only in enclave memory, that content is re-encrypted with the customer managed KMS key, and that each key use is attested and logged in CloudTrail. Also adds a link to expected costs.
Security assessment
The added text documents encryption architecture and customer-controlled key usage: plaintext confined to a Nitro Enclave with no network interface or shell, re-encryption with a customer managed KMS key, Nitro attestation recorded in CloudTrail, and the ability to disable the key to stop decryption. This is security best-practice/architecture documentation rather than a fix for a specific vulnerability.
Evidence
+The data retention _processing_ infrastructure runs in a Wickr-managed service account, not in your AWS account. Within the AWS Nitro Enclave, Wickr decrypts messages and re-encrypts them with your customer managed KMS key before sending them to your encrypted retention Amazon S3 bucket. You do not deploy, patch, or scale these components.
Diff
diff --git a/wickr/latest/adminguide/serverless-method.md b/wickr/latest/adminguide/serverless-method.md index 5825fb5..4463d93 100644 --- a//wickr/latest/adminguide/serverless-method.md +++ b//wickr/latest/adminguide/serverless-method.md @@ -7 +7 @@ -Prerequisites +Where data retention components runPrerequisites @@ -47,0 +48,38 @@ Wickr never accesses your messages and files. All decryption occurs within secur +## Where data retention components run + +The data retention _processing_ infrastructure runs in a Wickr-managed service account, not in your AWS account. Within the AWS Nitro Enclave, Wickr decrypts messages and re-encrypts them with your customer managed KMS key before sending them to your encrypted retention Amazon S3 bucket. You do not deploy, patch, or scale these components. + +The CloudFormation template that you launch from Service Catalog creates only resources that you own. You control these resources in your account: + + * The encrypted retention Amazon S3 bucket and the decrypted output Amazon S3 bucket + + * The KMS keys that protect your retained data (or references to the keys you supply) + + * The cross-account IAM role that the service assumes to use your key and write to your bucket + + * The on-demand decryption workflow (Step Functions state machine and Lambda functions) + + * The CloudWatch dashboard and alarm for your network + + + + +### Why Wickr cannot see your message content + +Wickr cannot see your message content for the following reasons: + + * The sender's device encrypts every message end-to-end. Every component outside the enclave handles only Wickr-encrypted ciphertext. This includes Wickr message routing. + + * Plaintext exists only in the memory of the Nitro Enclave. The enclave has no persistent storage, no network interface, and no interactive access (no SSH or shell). It communicates only with its parent host over a local socket. The host relays only ciphertext. + + * Content leaves the enclave only after it is encrypted with your customer managed KMS key. The enclave's private keys and account state are likewise stored only in encrypted form, protected by your key. + + * Each request that the enclave makes with your key includes a Nitro Enclave attestation document. AWS KMS records values from the attestation document in CloudTrail, so you can inspect which enclave image used your key. You can disable your key at any time to stop all decryption. + + * The service makes state changes on your behalf only inside the enclave. There, Wickr decrypts messages, re-encrypts them with your customer managed KMS key, and replenishes the data retention bot's keys. Every use of your key is logged in CloudTrail in your account. + + + + +For more information, see [What is AWS Nitro Enclaves?](https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html) in the _AWS Nitro Enclaves User Guide_ and [What is AWS CloudTrail?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html) in the _AWS CloudTrail User Guide_. + @@ -70,0 +109,2 @@ Before enabling serverless data retention, ensure you have the following: + * [Expected costs](./expected-costs.html) +